| description |
|---|
Compact AGENTS.md or CLAUDE.md to reduce token usage while preserving essential context |
Read AGENTS.md or CLAUDE.md, then create a highly condensed version of the file that:
- ✅ Current phase status table (compact format)
- ✅ Tech stack with versions (table format)
- ✅ Critical configuration requirements (.npmrc, tsconfig, etc.)
- ✅ Complete project structure tree
- ✅ Key features by phase WITH file locations (e.g.,
components/Omnibox.tsx) - ✅ All Make commands (critical for workflow)
- ✅ TypeScript data models (condensed format)
- ✅ Common Pitfalls section (prevents broken code generation)
- ✅ Troubleshooting commands (iOS, Android, general)
- ✅ Known architectural patterns with file references
- ✅ File operation rules (Read vs cat, Edit vs sed)
- ✅ Development best practices
- ✅ Git workflow
- ❌ Step-by-step implementation histories
- ❌ Verbose component descriptions (keep file paths only)
- ❌ "Latest Updates" narrative sections
- ❌ Redundant feature explanations
- ❌ Long-form test descriptions
- ❌ Duplicate information across phases
- ❌ Excessive implementation details that can be inferred from code
- ❌ Historical context not relevant to current development
- Use dense, reference-style prose
- Use tables where appropriate for readability
- Keep code examples minimal but functional
- Use bullet points with file paths:
Feature: file/path.tsx - Brief description - Preserve exact locations (line numbers when critical)
- Aim for 50-60% size reduction from original
The compacted file must enable LLMs to:
- Generate accurate code following project architecture
- Prevent common failures (Node.js APIs, cache issues, iOS ATS)
- Use correct tools and commands
- Understand file locations and implemented features
- Follow TypeScript strict mode patterns
After creating the compact version, show a summary of:
- Original line count vs new line count
- Percentage reduction
- Key sections preserved
- Key sections removed