hyhmrright/brooks-lint

Brooks-lint is a linting and code quality tool that integrates with AI models to analyze code for engineering standards and decay risks. It provides a structured diagnostic pipeline that processes code input against classic engineering references to identify and cite specific findings. The system includes comprehensive automation for CI integration, evaluation benchmarking, and version management, along with local hooks to streamline user setup.

A new SessionStart hook has been added to automatically install short-form slash commands into the user's local commands directory when a session begins. The hook script reads the plugin version, copies relevant command definitions, and ensures they are correctly linked, providing immediate access to the tool's capabilities without manual setup.

hooks · high confidence

The assets directory now includes a complete set of localized banner images (English, Spanish, Japanese, Korean, Simplified Chinese, and Traditional Chinese) that visually explain the diagnostic pipeline's four-step flow: code input, classic engineering references, decay risks, and cited findings. Additionally, source HTML files for the hero image and an animated demo GIF have been added to support the README and landing page, and the project logo has been replaced with a proper SVG icon featuring a book and checkmark.

assets · high confidence

The repository now includes a \scripts/\ directory containing the core tooling and automation logic for brooks-lint. This introduces a canonical mode registry (\assemble-prompt.mjs\) that drives the system prompt assembly for CI and evaluation, a parser-fidelity benchmark (\benchmark.mjs\) to ensure report parsing accuracy against a frozen corpus, and a changelog audit tool (\changelog-audit.mjs\) to verify release coverage. It also adds a version propagation script (\bump-version.mjs\), CI quality gates (\ci-gate.mjs\), a CI review entry point (\ci-review.mjs\), and various utilities for history tracking, frontmatter parsing, and platform installation (\install.sh\).

scripts · high confidence

The evals directory now includes seven new evaluation scenarios (01–07) covering provider remapping, installer documentation mismatches, rule drift, composition root design, missing tests, and negative control cases, along with a pilot log recording calibration results across four pilot runs.

evals · high confidence

The project now includes a package.json file defining the 'brooks-lint' package at version 1.7.0. This file establishes the project as an ES module and defines several npm scripts for version management, validation, testing, evaluation, benchmarking, and changelog auditing. It also declares a single development dependency: @anthropic-ai/sdk version 0.52.0.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 57 → 64 (+6.9)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 64 → 68 (+3.6)
• Architecture 100 → 100 (+0.0)
• Maturity 69 → 65 (-4.0)
• Readiness 46 → 58 (+12.2)
• Security 88 → 87 (-0.6)
• Accessibility 63 → 71 (+8.2)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• LLM evaluation failed
• No exposed public API
• Scanner failed to run — not a clean result
• Test reliability not included

• Dependency hygiene PARTLY measured — npm pinning read, dependency currency not (no committed lockfile, so no resolved version to grade)
• Documentation: no installation or build instructions (README.md)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• Hotspot: scripts/eval-utils.mjs (scripts/eval-utils.mjs)
• Hotspot: scripts/report-parse.mjs (scripts/report-parse.mjs)
• Medium: security finding (details withheld)
• No assertions: validate-repo.mjs exits 0 against the current repository (scripts/validate-repo.test.mjs)
• No assertions: validate-repo.mjs ignores an inherited CLAUDE_PLUGIN_ROOT (scripts/validate-repo.test.mjs)
• No dependency advisory monitoring
• Repeated repair: scripts/changelog-audit.mjs (scripts/changelog-audit.mjs)
• Scanner failed to run — not a clean result
• Scanner failed to run — not a clean result
• changelog-audit.report (cognitive 21) (scripts/changelog-audit.mjs)
• eval-utils.classify (cyclomatic 17) (scripts/eval-utils.mjs)
• report-parse.parseFindings (cognitive 21) (scripts/report-parse.mjs)
• report-parse.parseFindings (cyclomatic 17) (scripts/report-parse.mjs)

• 33 commits — 27 feature/other, 6 fixes

• (root) — 19 commits
• assets/star-history.json — 5 commits
• evals/results — 2 commits
• scripts/changelog-audit.mjs — 2 commits
• (repo) — 1 commit
• .claude/agents — 1 commit
• assets/star-history.svg — 1 commit
• scripts/ci-review.mjs — 1 commit
• skills/_shared — 1 commit

• fix: fix(release): announce the coverage gate's audited runs, not just its skips
• fix: fix(release): close the coverage gate's silent failures and blind spots
• fix: fix(release): make the audit's counts read as English at 0 and 1
• fix: fix(scripts): read the first text block, not the first block
• fix: fix: chart star history from first-party data
• fix: test(evals): record pilots 3-4 and fix the case 04 severity rubric
• change: Merge pull request #34 from rapcal/feat/opencode-command-wrappers
• change: chore(release): 1.4.3
• change: chore(release): bump version to 1.5.1
• change: chore(release): bump version to 1.6.0
• change: chore(release): bump version to 1.7.0
• change: chore: refresh the star history chart
• change: chore: refresh the star history chart
• change: chore: refresh the star history chart
• change: chore: refresh the star history chart
• change: chore: refresh the star history chart
• change: chore: refresh the star history chart
• change: docs(changelog): cover the two 1.6.0 changes the section had missed
• change: docs(release): require a per-commit changelog audit before cutting a release
• change: docs(skills): cut duplicated prose from the skill and shared framework markdown
• …and 13 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

hyhmrright/brooks-lint was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.