Brooks-Lint

What's New

.brooks-lint.yaml Project Configuration

Place a config file in your project root to customize review behavior:

• disable — skip specific risk codes (R1–R6, T1–T6)
• severity — override severity tier per risk code
• ignore — glob patterns for files to exclude
• focus — evaluate only specific risk codes

Copy .brooks-lint.example.yaml as a starting point.

Ten-Book Framework

Expanded from six to ten classic engineering books:

• A Philosophy of Software Design (Ousterhout) — adds Shallow Module, Deep Module, and Tactical Programming symptoms
• Software Engineering at Google (Winters et al.) — adds Hyrum's Law and Diamond Dependency symptoms
• Working Effectively with Legacy Code (Feathers) — now covers T4–T6 test decay risks
• xUnit Test Patterns (Meszaros) — now covers T1–T3 test decay risks

Short-Form Slash Commands

Type commands without the /brooks-lint: prefix:
| Short | Full |
|-------|------|
| /brooks-review | /brooks-lint:brooks-review |
| /brooks-audit | /brooks-lint:brooks-audit |
| /brooks-debt | /brooks-lint:brooks-debt |
| /brooks-test | /brooks-lint:brooks-test |

Architecture Audit Improvements

Mode 2 now proactively gathers codebase context (Step 0) before analysis — no need to manually describe your project structure.

Installation

# Claude Code
cp -r skills/brooks-lint ~/.claude/skills/brooks-lint

# Codex CLI
cp -r skills/brooks-lint ~/.codex/skills/brooks-lint

Full Changelog

See commits since v0.6.2.