mcpField
B
brooks-debt

brooks-debt

github.com/hyhmrrightDevelopment1.6k265 installsUpdated 2d ago
Repository

About brooks-debt

brooks-debt is a Brooks-Lint skill for assessing technical debt in a codebase. It scans six decay risks, prioritizes findings by Pain × Spread, classifies debt intent, and reports findings by risk.

Key features

  1. 01Scans six decay risks
  2. 02Prioritizes by Pain × Spread
  3. 03Classifies debt intent
  4. 04Groups findings by risk
  5. 05Produces a debt summary table

Use cases

  1. 01Assessing technical debt across a codebase
  2. 02Prioritizing debt findings for remediation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hyhmrright/brooks-lint --skill brooks-debt

After installing, type/brooks-debtin Claude Code to confirm it loaded.

Bundled filesdebt-guide.md

Details

From the project README

Brooks-Lint — Tech Debt Assessment

Setup

Read in order:

  1. ../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
  2. ../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
  3. ../_shared/decay-risks.md — symptom definitions and source attributions
  4. debt-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.

  1. Scan for all six decay risks (Step 1 of the guide); list every finding before scoring
  2. Apply the Pain × Spread priority formula and classify debt intent (Steps 2–3 of the guide)
  3. Group findings by decay risk (Step 4 of the guide)
  4. Output using the Report Template from common.md, plus the Debt Summary Table

Mode line in report: Tech Debt Assessment

Comments

Markdown supported