CLAUDE.md Maintainer (Smart Router)

Purpose

Context-aware guidance for maintaining and improving CLAUDE.md files. Helps ensure the file stays effective, concise, and follows best practices for LLM instruction files.

When Auto-Activated

• Editing or discussing CLAUDE.md
• Keywords: claude.md, project instructions, onboarding claude, context file
• Discussing documentation structure for AI assistants

🚨 CRITICAL RULES

1. Keep under 300 lines - Research shows LLMs handle ~150-200 instructions reliably; performance degrades with more
2. Never auto-generate - Manually craft each line; auto-generated content often contains noise
3. Universal applicability only - Remove task-specific or narrow-scope guidance
4. File references over code snippets - Code embeds become outdated; paths stay accurate

📊 Effective CLAUDE.md Principles