Brooks Debt
Tech debt assessment that identifies, classifies, and prioritizes maintainability...
Install
npx skills add hyhmrright/brooks-lint --skill brooks-debt -g -a claude-code -y- Repository
- hyhmrright/brooks-lint1.6k
- Category
- Data and ML
- Updated
- 9d ago
- License
- MIT
- Context cost
- Lightabout 223 tokens
- Runs scripts
- No, instructions only
What it does
Tech debt assessment that identifies, classifies, and prioritizes maintainability problems, helping teams build a refactoring roadmap, drawing on twelve classic engineering books. Triggers when: user asks about tech debt, refactoring priorities, what to clean up first, or asks "why is this so hard to change?", "what should we fix first?", or "how do I justify refactoring to management?". Do NOT trigger for: server health checks, HTTP /health endpoints, Kubernetes probes, database health, or application uptime, "health" in those contexts is infrastructure, not code quality. Also not for single-function refactoring questions.
Brooks-Lint, Tech Debt Assessment
Setup
Read in order:
../_shared/common.md, Iron Law, Project Config, Report Template, Health Score../_shared/source-coverage.md, book coverage, exceptions, tradeoffs../_shared/decay-risks.md, symptom definitions and source attributionsdebt-guide.md(this directory), the debt classification framework
Process
Scope: if the user did not describe the codebase or point to specific areas, apply
Auto Scope Detection (../_shared/common.md) first.
- Scan for all six decay risks (Step 1 of the guide); list every finding before scoring
- Apply the Pain × Spread priority formula and classify debt intent (Steps 2, 3 of the guide)
- Group findings by decay risk (Step 4 of the guide)
- Output using the Report Template from common.md, plus the Debt Summary Table
Mode line in report: Tech Debt Assessment
