docs: Improve documentation clarity and add comprehensive rule editing guide #75
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Remove /onboard command entirely based on analysis showing: - Conflicts with current architecture philosophy (minimal context preparation) - Low actual usage despite documentation presence - Better alternatives exist (rule-advisor for targeted rule selection) - Simplifies command set and reduces maintenance overhead Changes: - Delete command files: .claude/commands*/onboard.md - Update README workflow: remove /onboard step - Update use-cases guides: remove /onboard documentation - Clean troubleshooting references to /onboard The sub-agent approach with targeted rule selection via rule-advisor provides better alignment with the "single responsibility" and "just-in-time context generation" design principles. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Enhanced use-cases.md with clearer command explanations and practical examples - Added comprehensive rule-editing-guide.md with 9 LLM optimization principles - Updated sync-rules command to prevent unnecessary modifications - Added links to rule editing guide in README.ja.md - Clarified Agentic Coding concepts and sub-agent importance throughout docs - Added troubleshooting sections and phase-based implementation examples - Improved terminology consistency (AI → LLM) for technical accuracy These changes address user confusion about project philosophy and provide better guidance for customizing rules to maximize LLM execution accuracy. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Translated rule-editing-guide.md to English with LLM optimization principles - Updated use-cases.md with enhanced command explanations and practical examples - Added decision criteria to sync-rules command to prevent unnecessary changes - Updated README.md with links to rule editing guide in both languages - Adjusted token size recommendations for English (250 lines ≈ 1,500 tokens) - Improved terminology consistency across all English documentation - Added troubleshooting sections and phase-based implementation examples These translations ensure English-speaking users have access to the same comprehensive documentation improvements as Japanese users. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Renamed section from "Important Decision Criteria" to "Change Necessity Evaluation" - Removed excessive emphasis that misrepresented priority hierarchy - Optimized English version for LLM execution accuracy with IF-THEN-TERMINATE structure - Maintained measurable criteria (100% synchronization, zero mismatches) - Balanced emphasis levels to properly reflect metadata sync as primary responsibility The change evaluation is now appropriately positioned as a conditional branch rather than a critical component, ensuring correct prioritization of the command's main purpose. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Reorganize both English and Japanese READMEs with clearer structure - Add table of contents for easier navigation - Move sub agents list to the end, show only key agents - Emphasize real-world results with time comparisons - Simplify workflow explanations for better understanding - Add demo GIF as H3 section under "Why Sub Agents" - Use more approachable tone in Japanese version - Focus on practical benefits over technical details 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Changes
New Documentation
Enhanced Documentation
use-cases.md:
sync-rules.md:
README.ja.md: