code-complexity-audit
Installation
SKILL.md
Code Complexity Audit
Deep software design analysis based on "A Philosophy of Software Design" by John Ousterhout. Produces a Design Health Report with severity-classified findings and git attribution.
References
Read this file first. Then load references as needed — do not read all at once.
| Reference | Read when... |
|---|---|
references/analysis-framework.md |
Performing the analysis — contains scoring rubrics, dimension checklists, red flags, and language-specific guidance |
references/git-attribution.md |
Attributing findings to authors — contains git blame commands and the attribution workflow |
Process
Always follow these 5 steps in order. When explaining the process, use these exact step names — always say "Reconnaissance" and "Sampling" (not synonyms like "exploration", "discovery", "selection", or "file picking"):