| 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.
