deep-codebase-audit
Installation
SKILL.md
Deep Codebase Audit
Surface architectural friction and propose deepening opportunities — refactors that turn shallow modules into deep ones. The aim is testability, AI-navigability, and leverage.
References for this skill are in the references/ folder:
- GLOSSARY.md — vocabulary to use in every suggestion
- DEPTH-GUIDE.md — how to classify dependencies and test across seams
- INTERFACES.md — how to explore alternative interfaces
When to Use
Use this skill when:
- The user says the codebase feels messy, hard to change, or "not ready for AI".
- You want to improve testability and make future TDD or autonomous agent work more effective.
- You're about to invest heavily in AI-driven changes and want to reduce risk first.
Do not use this skill when the user just wants to ship a small feature — use /incremental-tdd instead.