About brooks-sweep
A Brooks-Lint skill that runs a full codebase sweep across review, tests, debt, and architecture audit, then fixes and verifies findings. It requires one-time approval before scanning begins.
Key features
- 01Scanning review, test, debt, and audit dimensions
- 02Classifying, fixing, and verifying findings
- 03Iterating over changed files and consumers
- 04Reporting residual and unresolvable issues
Use cases
- 01Running a broad codebase quality pass
- 02Fixing and verifying findings across project areas
- 03Summarizing issues that remain unresolved
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/brooks-sweepin Claude Code to confirm it loaded.
Bundled filessweep-guide.md
Details
From the project READMEBrooks-Lint — Full Sweep & Auto-Fix
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— production risk symptoms../_shared/test-decay-risks.md— test risk symptomssweep-guide.md(this directory) — the unified scan and fix process
Process
Scope: if the user did not specify a project or directory, apply Auto Scope Detection
(../_shared/common.md) first.
- Show the pre-flight consent notice and wait for one-time approval (Step 0 of the guide)
- Enumerate scope and initialize pipeline state (Step 1 of the guide)
- Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, fixing, and verifying (Steps 2–5 of the guide)
- Iterate over modified files and their consumers until a clean round or the cap (Step 6 of the guide)
- Aggregate residual and unresolvable items and output the Full Sweep Report (Steps 7–8 of the guide)
Mode line in report: Full Sweep
Comments
Markdown supported