Skip to content

Commit 6c7cde1

Browse files
bitwize-musicclaude
andcommitted
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

CHANGELOG.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,27 @@ This project uses [Conventional Commits](https://conventionalcommits.org/) and [
1313
- Auto-detects platform and clipboard utility
1414
- Config-aware path resolution
1515
- Usage: `/clipboard <content-type> <album-name> <track-number>`
16+
- Workflow reference documentation in `/reference/workflows/`
17+
- `checkpoint-scripts.md` - Detailed checkpoint message templates
18+
- `album-planning-phases.md` - The 7 Planning Phases detailed guide
19+
- `source-verification-handoff.md` - Human verification procedures
20+
- `error-recovery.md` - Edge case recovery procedures
21+
- `release-procedures.md` - Album art generation and release steps
22+
- `/reference/distribution.md` - Streaming lyrics format and explicit content guidelines
1623

1724
### Changed
25+
- **CLAUDE.md refactored for performance** - Reduced from 50,495 to 34,202 characters (32% reduction)
26+
- Compressed checkpoint sections - Kept triggers/actions, moved verbose messages to `/reference/workflows/checkpoint-scripts.md`
27+
- Condensed Audio Mastering section - Brief overview with reference to existing `/reference/mastering/mastering-workflow.md`
28+
- Condensed Sheet Music section - Summary with reference to `/reference/sheet-music/workflow.md`
29+
- Condensed Album Art Generation - Core workflow with reference to `/reference/workflows/release-procedures.md`
30+
- Condensed 7 Planning Phases - Summary with reference to `/reference/workflows/album-planning-phases.md`
31+
- Condensed Human Verification Handoff - Triggers with reference to `/reference/workflows/source-verification-handoff.md`
32+
- Condensed Error Recovery - Quick reference with link to `/reference/workflows/error-recovery.md`
33+
- Condensed Distribution Guidelines - Combined streaming lyrics and explicit content with reference to `/reference/distribution.md`
34+
- Simplified Creating Content sections - Condensed album creation and file import workflows
35+
- Simplified Suno Generation Workflow - Streamlined process description
36+
- Architecture: CLAUDE.md now focuses on workflow orchestration (WHEN/WHY), detailed procedures in reference docs (HOW)
1837

1938
### Fixed
2039

0 commit comments

Comments
 (0)