claude-md-manager

# CLAUDE.md Manager Create and maintain effective CLAUDE.md files that configure Claude Code's project behavior. ## Core Workflow ### 1. Determine the Mode **Creating new CLAUDE.md:** - Analyze project structure, tech stack, and conventions - Generate focused documentation using WHAT/WHY/HOW framework - Target under 100 lines (max 300) **Refreshing existing CLAUDE.md:** - Audit current content for bloat, staleness, and anti-patterns - Identify instructions that should be externalized - Optimize for conciseness and relevance ### 2. Project Analysis (for new files) Examine: - `package.json`, `Cargo.toml`, `pyproject.toml`, etc. for stack - Directory structure for architecture patterns - Existing README.md for project context - `.github/`, `Makefile`, scripts for workflows - Test directories for testing conventions ### 3. Apply the WHAT/WHY/HOW Framework **WHAT** - Technical reality: - Tech stack and key dependencies - Directory structure and architecture - Key files and entry points **WHY** - Context and purpose: - What the project does - Why certain patterns exist - Functional purpose of directories **HOW** - Practical workflows: - Build commands (package manager specifics) - Test execution - Development workflow - Deployment process ### 4. Validation Review Pass After creating or refreshing CLAUDE.md, validate claims against the actual codebase using OSGrep. This catches stale commands, incorrect paths, and drifted conventions. #### Validation Steps **1. Valida...