claude-md-managerlisted
Install: claude install-skill tdimino/claude-code-minoan
# 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