Skill

Scan, Fix & Verify Code Quality Across All Dimensions

A consent-gated full-sweep skill that scans and auto-fixes code decay, architecture, tech debt, and test quality in one pass.


71
Spark score
out of 100
Updated 23 days ago
Version 1.4.0

Add to Favorites

Why it matters

Automatically analyze your entire codebase for code decay, architecture violations, technical debt, and test quality issues, then apply safe fixes directly while confirming risky changes before execution.

Outcomes

What it gets done

01

Run unified scans across code review, test quality, tech debt, and architecture audit dimensions

02

Auto-apply safe fixes and request confirmation for risky changes before modifying code

03

Re-scan modified files and dependencies iteratively until quality converges or retry limits are reached

04

Generate comprehensive sweep reports with health scores, fix logs, and unresolvable issue tracking

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-brooks-sweep | bash

Overview

Brooks-Lint - Full Sweep & Auto-Fix

This skill runs a consent-gated full sweep across code decay, architecture, tech debt, and test quality, applying safe fixes automatically and confirming risky ones, iterating until convergence. Use it for a comprehensive auto-fixing pass across all quality dimensions in one run. Use the dedicated audit, review, or test skills for a single-dimension check instead.

What it does

This skill runs a unified full-sweep 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 require confirmation before execution. It draws on the same shared framework as sibling brooks-lint skills - the Iron Law and Health Score rules, book-level source coverage, and separate symptom definitions for production risks and test risks - plus its own sweep guide for the unified scan-and-fix process. If no project or directory is specified, it applies automatic scope detection to determine the review scope first.

The process starts by showing a pre-flight consent notice and waiting for one-time user approval, then enumerates scope and initializes tracking state for unresolvable items, non-critical-round counts, and a fix log. It runs four dimensions in sequence - review, test, debt, and audit - each scanning, classifying, applying safe and extended-safe fixes, and verifying via the project's own test command. It then iterates by re-scanning modified files, the same module, and static consumers, converging on a clean round, retiring items that fail three retries to an unresolvable set, and capping non-critical rounds at three. Finally it aggregates residual and unresolvable items into a Full Sweep Report.

When to use - and when NOT to

Use it for a comprehensive, auto-fixing pass across code decay, architecture, tech debt, and test quality in one run - not for a single-dimension check, where the dedicated audit, review, or test skills are the better fit.

Inputs and outputs

Given a project or an auto-detected scope, and only after explicit user consent, it produces directly applied safe fixes, confirmed risky fixes, a fix log, and a Full Sweep Report listing residual and unresolvable items.

Integrations

Depends on shared framework files defining the Iron Law, source coverage, and separate production and test risk symptom taxonomies, plus the project's own test command for fix verification.

Who it's for

Teams wanting a single, consent-gated pass that both diagnoses and fixes maintainability, architecture, tech-debt, and test-quality issues across a codebase, rather than running separate audit, review, and test skills one at a time.

Source README

Brooks-Lint - Full Sweep & Auto-Fix

When to Use

Use this skill when you need 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...

Setup

  1. Read ../_shared/common.md for the Iron Law, Project Config, Report Template, and Health Score rules
  2. Read ../_shared/source-coverage.md for book-level coverage, exceptions, and tradeoffs
  3. Read ../_shared/decay-risks.md for production risk symptom definitions
  4. Read ../_shared/test-decay-risks.md for test risk symptom definitions
  5. Read sweep-guide.md in this directory for the unified scan and fix process

Process

If the user has not specified a project or directory: apply Auto Scope Detection
from ../_shared/common.md to determine the review scope before proceeding.

  1. Show pre-flight consent notice and wait for the user's one-time approval (Step 0 of the guide)
  2. Enumerate scope and initialize the unresolvable / non_critical_rounds / fix_log state (Step 1 of the guide)
  3. Run the four dimensions in sequence - review, test, debt, audit - each scanning, classifying, applying Safe + Extended-Safe fixes, and verifying via the project test command (Steps 2-5 of the guide)
  4. Iterate: re-scan modified files + same-module + static consumers; converge on a clean round, retire 3-retry failures to the unresolvable set, cap non-critical rounds at 3 (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

Limitations

  • Use this skill only when the task clearly matches its upstream source and local project context.
  • Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
  • Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.

FAQ

Common questions

Discussion

Questions & comments ยท 0

Sign In Sign in to leave a comment.