claude-md-optimizerlisted

# Optimize CLAUDE.md Analyze, audit, and optimize CLAUDE.md files based on Anthropic's official best practices for effective Claude Code configuration. ## Degrees of Freedom This is a **medium-freedom** task. Follow the structured workflow but adapt recommendations based on the specific project's needs, tech stack, and team conventions. ## Workflow Copy this checklist and track your progress: ``` Optimization Progress: - [ ] Step 1: Analyze current CLAUDE.md state - [ ] Step 2: Audit against best practices checklist - [ ] Step 3: Identify and prioritize issues - [ ] Step 4: Generate recommendations - [ ] Step 5: Apply or present changes ``` ### 1. Analyze Current State Read the existing CLAUDE.md (if present) and assess: - Current structure and organization - Content categories present - Length and verbosity - Presence of anti-patterns ### 2. Audit Against Best Practices Compare against the checklist in [references/best-practices.md](references/best-practices.md). Score each category: - **Present & Good** - Follows best practices - **Present but Needs Work** - Exists but could be improved - **Missing** - Should be added - **Anti-pattern** - Should be removed/fixed ### 3. Generate Recommendations Prioritize changes by impact: **High Priority:** - Remove sensitive information (API keys, credentials) - Fix anti-patterns (generic advice, excessive length) - Add missing critical sections (project structure, commands) **Medium Priority:** - Improve organization and s