graybeard-audit

name

graybeard-audit

description

Whole-repo audit for over-engineering. Like graybeard-review, but scans the entire codebase instead of a diff: a ranked list of what to delete, simplify, or replace with stdlib/native equivalents. Use when the user says "audit this codebase", "audit for over-engineering", "what can I delete from this repo", "find bloat", "graybeard-audit", or "/graybeard-audit". One-shot report, does not apply fixes.

graybeard-review, repo-wide. Scan the whole tree instead of a diff. Rank findings biggest cut first.

Tags

delete:, stdlib:, native:, yagni:, shrink: — same tags as graybeard-review; its examples demonstrate usage.

Hunt

Deps the stdlib or platform already ships, single-implementation interfaces, factories with one product, wrappers that only delegate, files exporting one thing, dead flags and config, hand-rolled stdlib.

Output

One line per finding, ranked: <tag> <what to cut>. <replacement>. [path]. End with net: -<N> lines, -<M> deps possible. Nothing to cut: Lean already. Ship.

Boundaries

Scope: over-engineering and complexity only. Correctness bugs, security holes, and performance are explicitly out of scope. Route them to a normal review pass. Lists findings, applies nothing. One-shot. Never print a per-repo savings number ("you saved X lines/tokens here") — the unbuilt version was never written, so there is no real baseline to subtract from. "stop graybeard-audit" or "normal mode" to revert.