| name | claude-md-learning |
| description | Analyzes detected stack profiles and suggests targeted CLAUDE.md improvements. Covers CLAUDE.md improvement, project configuration, AI instructions. Never auto-writes to CLAUDE.md — stages suggestions for user review. |
| user-invocable | false |
CLAUDE.md Learning
This skill enables intelligent suggestions for improving a project's CLAUDE.md file based on detected technology stack and observed patterns.
When to Use
- After
/blueprint-dev:bp:discover produces a stack profile
- When the
claude-md-advisor agent needs to generate context-aware suggestions
- When compound knowledge docs reveal patterns that should be codified in CLAUDE.md
Philosophy
CLAUDE.md is the single most impactful file for AI-assisted development quality. A well-crafted CLAUDE.md:
- Eliminates 80% of "AI got confused" issues
- Ensures consistent code style across AI interactions
- Documents tribal knowledge that doesn't belong in code comments
- Evolves as the project grows
Suggestion Categories
Use the section catalog in references/section-catalog.md to categorize and prioritize suggestions.
Key Principles
- Never auto-write — always stage in
.blueprint/claude-md-suggestions.md
- Specific over generic — "Use pnpm, not npm" beats "Use the right package manager"
- Commands over descriptions — include actual CLI commands
- Stack-adaptive — only suggest what's relevant to the detected stack
- Incremental — don't overwhelm with 50 suggestions; prioritize the top 5-10
- Respect existing — don't suggest what's already covered
