## Lesson — Maintain lean CLAUDE.md files

**Tags:** documentation, llm-optimization, dx
**Scope:** CLAUDE.md

Keep CLAUDE.md files under approximately 50 lines to ensure high reliability. Excessive verbosity in this file has been observed to suppress the agent's use of MCP tools.
