ruvnet / ruvnet/ruflo

Optimize CLAUDE.md to reduce size below 40k characters

Open
#585 3 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.