What problem does it solve?
Prevents slow, inconsistent development by detecting the actual conventions already used in a codebase and turning them into actionable guidance, rather than guessing rules from a template.
Core Features & Use Cases
- Project pattern detection: Learns conventions for project structure, naming, layering, and test organization by analyzing the existing codebase patterns.
- Public API-based convention discovery: Infers type naming and usage norms by examining representative public types across multiple layers.
- Config-aware enforcement: Detects and respects explicit convention sources like .editorconfig, Directory.Build.props, and global.json so project rules override generic defaults.
- Convention documentation output: Produces a structured “Detected Conventions” summary to help teams persist knowledge (e.g., via CLAUDE.md).
- Deviation detection guidance: Identifies likely convention violations during generation/review and suggests aligning generated code to the discovered patterns.
- Anti-pattern tracking: Flags recurring quality issues over time using anti-pattern detection to prioritize lasting convention improvements.
Quick Start
Use the convention-learner skill to analyze an existing repository and generate a concrete, evidence-based conventions summary that you can apply when generating or reviewing new code.