Commit 6c7cde1
refactor: reduce CLAUDE.md size by 32% with hierarchical documentation
Refactored CLAUDE.md from 50,495 to 34,202 characters (32% reduction) by
extracting detailed procedures into reference documentation while keeping
workflow orchestration in the main file.
Created /reference/workflows/ directory:
- checkpoint-scripts.md - Checkpoint message templates
- album-planning-phases.md - 7 Planning Phases detailed guide
- source-verification-handoff.md - Human verification procedures
- error-recovery.md - Edge case recovery procedures
- release-procedures.md - Album art generation and release steps
Created /reference/distribution.md:
- Streaming lyrics format guidelines
- Explicit content word lists and checking procedures
CLAUDE.md changes:
- Compressed checkpoint sections (kept triggers/actions, moved verbose messages)
- Condensed Audio Mastering section (brief overview → reference)
- Condensed Sheet Music section (summary → reference)
- Simplified 7 Planning Phases (summary → full details in reference)
- Simplified Human Verification Handoff (triggers → procedures in reference)
- Simplified Error Recovery (quick ref → full procedures in reference)
- Simplified Album Art Generation (workflow → detailed steps in reference)
- Simplified Releasing an Album (steps → procedures in reference)
- Simplified Distribution Guidelines (summary → full guidelines in reference)
- Streamlined Creating Content and Suno Generation sections
Architecture improvement:
- CLAUDE.md: Workflow orchestration (WHEN/WHY)
- /reference/workflows/: Detailed procedures (HOW)
- Skills & reference: Deep expertise and technical specs
Benefits:
- 32% smaller CLAUDE.md loads faster in every session
- Easier to maintain specific workflows without bloating main file
- Clear separation between orchestration and detailed procedures
- Room for future additions without exceeding size limits
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>1 parent 530a94b commit 6c7cde1
8 files changed
Lines changed: 589 additions & 678 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
16 | 23 | | |
17 | 24 | | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
18 | 37 | | |
19 | 38 | | |
20 | 39 | | |
| |||
0 commit comments