Skills Development Brooks Sweep Auto Fix

Brooks Sweep Auto Fix

v20261105
brooks-sweep
This skill performs a full-sweep analysis across code decay, architecture, tech debt, and test quality. It applies fixes directly to the codebase with safety checks. Safe changes are auto-applied, while risky changes require confirmation. Based on twelve classic engineering books, it triggers when users want to fix everything or clean up the whole project in a single command.
Get Skill
157 downloads
Overview

Brooks-Lint — Full Sweep & Auto-Fix

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 — production risk symptoms
  4. ../_shared/test-decay-risks.md — test risk symptoms
  5. 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.

  1. Show the pre-flight consent notice and wait for one-time approval (Step 0 of the guide)
  2. Enumerate scope and initialize pipeline state (Step 1 of the guide)
  3. Run the four dimensions in sequence — review, test, debt, audit — each scanning, classifying, fixing, and verifying (Steps 2–5 of the guide)
  4. Iterate over modified files and their consumers until a clean round or the cap (Step 6 of the guide)
  5. Aggregate residual and unresolvable items and output the Full Sweep Report (Steps 7–8 of the guide)

Mode line in report: Full Sweep

Info
Category Development
Name brooks-sweep
Version v20261105
Size 6.6KB
Updated At 2026-11-06
Language