mcpField
B
brooks-review

brooks-review

github.com/hyhmrrightTesting & quality1.6k360 installsUpdated 2d ago
Repository

About brooks-review

A PR review skill from Brooks-Lint that follows a defined process to inspect changes for decay risks and check tests when relevant. It uses shared review rules and a standard report template.

Key features

  1. 01Applies automatic scope detection
  2. 02Scans for decay risks in order
  3. 03Checks tests when applicable
  4. 04Applies the Iron Law to findings
  5. 05Uses a standard report template

Use cases

  1. 01Reviewing a pull request with no specified file scope
  2. 02Checking production changes for maintainability risks
  3. 03Producing a structured PR review report

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hyhmrright/brooks-lint --skill brooks-review

After installing, type/brooks-reviewin Claude Code to confirm it loaded.

Bundled filespr-review-guide.md

Details

From the project README

Brooks-Lint — PR Review

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 — symptom definitions and source attributions
  4. pr-review-guide.md (this directory) — the analysis process

Process

Scope: if the user did not specify files or paste code, apply Auto Scope Detection (../_shared/common.md) first.

  1. Understand the review scope, then scan for each decay risk in the order specified (Steps 1–6 of the guide)
  2. Run the Quick Test Check (Step 7 of the guide) — skip for docs-only or non-production changes
  3. Apply the Iron Law to every finding
  4. Output using the Report Template from common.md

Mode line in report: PR Review

Comments

Markdown supported