brooks-sweep
Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution. Drawing on twelve classic engineering books. Triggers when: user wants to "fix everything", "sweep the codebase", "auto-fix all issues", "clean up the whole project", or asks for a single command that both diagnoses and remediates quality problems. Do NOT trigger for: read-only audits or health reports where the user only wants findings without code changes; single-dimension reviews (use the focused skill instead: brooks-review / brooks-audit / brooks-debt / brooks-test); server health checks, HTTP /health endpoints, Kubernetes probes, database health, or application uptime.
How do I install this agent skill?
npx skills add https://github.com/hyhmrright/brooks-lint --skill brooks-sweepIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill autonomously executes project-defined test scripts and generates code fixes, which can be risky when used on untrusted repositories.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Brooks-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- Read each focused guide at its pass:
../brooks-review/pr-review-guide.md,../brooks-test/test-guide.md,../brooks-debt/debt-guide.md,../brooks-audit/architecture-guide.md, then../brooks-health/health-guide.md
Process
Scope: if the user did not specify a project or directory, apply Auto Scope Detection
(../_shared/common.md) first.
- Confirm scope and existing edit authorization; obtain approval only if missing (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 residuals, run the health dashboard from the final snapshot, and output the Full Sweep Report (Steps 7–8 of the guide)
Mode line in report: Full Sweep
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hyhmrright/brooks-lint/brooks-sweep">View brooks-sweep on skillZs</a>