brooks-debt
Tech debt assessment that identifies, classifies, and prioritizes maintainability problems — helping teams build a refactoring roadmap — drawing on twelve classic engineering books. Explicit invocation only: load solely when the user names it ("brooks-debt" / "brooks debt"). Never infer from generic tech-debt, refactoring, or cleanup requests. 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.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- 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. Explicit invocation only: load solely when the user names it ("brooks-debt" / "brooks debt"). Never infer from generic tech-debt, refactoring, or cleanup requests. 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.
02 资源文件 1
- 参考文档debt-guide.md5.2 KB
03 SKILL.md 正文
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
04 同仓库更多 Skills
writing-great-skills
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
session-retro
Use at the end of meaningful work to capture lessons, follow-ups, and process improvements.
grilling
Interview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.
grill-me
A relentless interview to sharpen a plan or design.
dev-workflow
Use when making a non-trivial code, test, configuration, or documentation change that should be planned, implemented, and verified end-to-end.
code-review
Use when reviewing a change, pull request, diff, or patch for bugs, regressions, missing tests, and maintainability risks.