What problem does it solve? When a constant value (retry budget, timeout, page size, magic number) is duplicated across multiple files, updating it in some sites but missing others creates silent drift. Author-maintained SEE ALSO comments are documentation, not enforcement, so they decay and lie when a site is missed. ## Core Features & Use Cases - Multi-shape grep audit: Enumerates every shape a constant can take (raw value, named symbol, unit-suffixed comment, composite expression, string tokens) and greps each shape separately across the repo. - Hit classification: Groups every match into moved-together, missed, or intentionally-different, halting the edit when a site cannot be classified confidently. - Bidirectional SEE ALSO repair: Adds cross-reference comments to newly found sites and updates existing sites so the trail stays accurate in both directions. - Use Case: Before merging a PR that raises a retry budget from 60s to 180s, run the audit to confirm all four call sites moved, catch the missed one in rename.ts, and emit a structured audit report. ## Quick Start Ask the agent to audit all sites of the constant you just changed, for example: run /audit-coupled-constant to verify every site of the 180s retry budget moved together before committing.
