Brooks Debt

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

.agents/skills/_shared

.agents/skills/brooks-audit

.agents/skills/brooks-debt

.agents/skills/brooks-health

.agents/skills/brooks-review

Audit 0.4.1 · source sha 8d83fdc82bd2 · 21 Oct 2026Report an issue or request a re-scan

• Publisherhyhmrright GitHub userOwner of the repository this skill is read from
• Source folderhyhmrright/brooks-lint/skills/brooks-debtThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict8d83fdc82bd2A new audit runs when the source changes
• Repository statusNot archivedLast push 2 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: 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…

---
name: brooks-debt
description: >
  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.
metadata:
  opencode/slash: "true"
---

# 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`

Excerpt, first 1,620 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/hyhmrright/brooks-lint
git -C brooks-lint checkout 8d83fdc82bd2

Works in

1. 2026-10-21
   !CAUTION B 89 / 100

   first audit · source 8d83fdc82bd2

Questions about Brooks Debt

• github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-debt — the audited source at commit 8d83fdc82bd2 and every finding aboveObserved · 21 Oct 2026

Spotted something wrong? Report a correction · Methodology