Brooks-Lint — Full Sweep & Auto-Fix

SkillDev tools

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.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Brooks-Lint skill

What this skill tells your AI

The instructions your AI receives, as published by hyhmrright/brooks-lint in skills/brooks-sweep/SKILL.md and read by ahel’s review.

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 symptoms
sweep-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

Signals

GitHub stars: 2k
Forks: 69
Last commit: Sep 2026

Others that do the same job

brooks-sweep
Skill · hashgraph-online

Advanced

Item type: skill
Key: brooks-sweep-hyhmrright
Source: github.com/hyhmrright/brooks-lint

github.com/hyhmrright/brooks-lint