Brooks-lint brooks-debt
install
source · Clone the upstream repo
git clone https://github.com/hyhmrright/brooks-lint
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/hyhmrright/brooks-lint "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/brooks-debt" ~/.claude/skills/hyhmrright-brooks-lint-brooks-debt && rm -rf "$T"
manifest:
skills/brooks-debt/SKILL.mdsource content
Brooks-Lint — Tech Debt Assessment
Setup
- Read
for the Iron Law, Project Config, Report Template, and Health Score rules../_shared/common.md - Read
for book-level coverage, exceptions, and tradeoffs../_shared/source-coverage.md - Read
for symptom definitions and source attributions../_shared/decay-risks.md - Read
in this directory for the debt classification frameworkdebt-guide.md
Process
If the user has not described the codebase or pointed to specific areas: apply Auto Scope Detection from
../_shared/common.md to determine the assessment scope before proceeding.
- 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