Optimize CLAUDE.md to reduce size below 40k characters
- Dominant language
- TypeScript
- Stars
- 72.7k
- Forks
- 8.6k
- Avg merge
- 2d 23h
- Merged PRs (30d)
- 83
Description
## Issue: Large CLAUDE.md impacts performance
### Current State
- Current size: 45,948 characters (exceeds 40k limit)
- Contains multiple redundant sections
- Duplicate instructions for concurrent execution
- Verbose examples that could be simplified
### Optimization Goals
1. Reduce size to <40,000 characters (save >5,948 chars)
2. Maintain ALL critical instructions
3. Improve readability through consolidation
4. Create reference tables for quick lookup
### Proposed Changes
- Consolidate 5 concurrent execution sections into 1
- Merge duplicate agent listings and examples
- Replace verbose code examples with concise versions
- Convert lengthy explanations to bullet points
- Create single agent reference table
- Remove redundant reminders
### Expected Benefits
- Improved performance in Claude Code
- Better readability and navigation
- Faster context loading
- Maintained functionality with cleaner structure
Contributor guide
Research direction
Start with CLAUDE.md and measure its current character count. Review the five concurrent-execution sections, agent listings, examples, explanations, and reminders for duplication, then consolidate them while preserving critical instructions. Done means the file is under 40,000 characters, remains readable, and retains the required behavior.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 68/100