| argument-hint | [path ...] |
| name | stale-comments-audit |
| user-invocable | true |
| description | Audit and fix JavaScript, TypeScript, and Go comments that are verified as stale, orphaned, misleading, or redundant. |
Stale Comments Audit
Audit source comments against the code they describe, then fix every confirmed mismatch or source of noise in the same
run. Limit edits to comments; never change executable code merely to make a comment true.
Scope
Accept zero or more file or directory paths. With no arguments, use the current repository root. Resolve every path from
the current working directory and report any path that cannot be read.
Discover JavaScript, JSX, TypeScript, TSX, and Go source files. By default exclude:
- tests, testdata, fixtures, snapshots, and stories;
- generated, vendor, dependency, coverage, cache, and build-output directories;
- minified JavaScript and generated Go files.
An explicitly named test file or test directory overrides only the test exclusion. Generated, vendored, minified, and
build-output files remain excluded unless the user explicitly requests them.
Use repository-aware discovery when available (git ls-files or rg --files) and preserve the user's path order. Do
not impose an arbitrary result cap.
Analysis
Split discovered files into non-overlapping batches of about ten. Delegate independent batches to read-only subagents
when supported; otherwise inspect them directly. Continue useful work while delegated batches run.
