- Add /sc:git command with smart commit functionality - Add /sc:ultra-think command for deep thinking - Update .claude/rules/ with improved documentation: - commands.md: command usage guidelines - doc-management.md: documentation policy - no-extra-docs.md: documentation creation policy - gpu-testing.md: GPU type detection and testing rules - Update .claude/settings.json with claude-flow MCP configuration 这些改进提供了更好的开发体验和工具支持。
1.3 KiB
1.3 KiB
Documentation Policy
Do Not Create Unnecessary Documentation
IMPORTANT: Do NOT create extra markdown documentation files proactively unless:
- User explicitly requests documentation
- Refactoring CLAUDE.md to move technical details to docs/ (see
doc-management.md)
What NOT to do:
- Do NOT create README files proactively
- Do NOT create standalone analysis documents after completing tasks
- Do NOT create summary documents without request
What TO do:
- Provide information directly in conversation by default
- When user requests documentation, follow
doc-management.mdworkflow - Update existing docs in
docs/when code changes affect them - Keep CLAUDE.md concise (< 150 lines), move technical details to docs/
Documentation Locations:
| Type | Location |
|---|---|
| Operational requirements | CLAUDE.md |
| Technical details | docs/*.md |
| Code comments | Inline in source |
Examples:
Proactive docs (Don't do):
User: "Profile the code"
Assistant: [Creates profiling_results.md without being asked]
On-request docs (Do this):
User: "Profile the code and document the findings"
Assistant: [Runs profiling, creates/updates docs/memory_analysis.md]
Refactoring (Do this):
User: "CLAUDE.md is too long, refactor it"
Assistant: [Moves technical sections to docs/, updates CLAUDE.md index]