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