| name | ssot-check |
| description | Single-source-of-truth drift auditor for documentation-heavy repos. Use when asked to "check for drift," "find copies of this number," "audit the docs for stale facts," or "set up an SSOT manifest." Finds facts hand-copied across files, builds a manifest of canonical locations, and verifies every copy still matches. |
| argument-hint | [discover|check] |
/ssot-check — Fact-Copy Drift Auditor
Documentation-heavy repos repeat facts. An episode count lives in a README, then gets hand-copied into a media kit, a landing page, and a business plan. Someone updates the README. The copies drift. This skill finds those copies, records where the canonical value lives, and checks the copies against it on every run.
It complements /reconcile. Reconcile catches multi-session drift in state files. This skill catches fact-copy drift across documents: the same number or string living in several files, where exactly one file is allowed to be right.
Invocation: deliberately model-invocable — checks are read-only and belong in pre-commit moments; fixes are proposed, never auto-applied.
When to Use
- Discover mode: first run on a repo, or after adding a new doc surface (a media kit, a landing page, a pricing page)
- Check mode: before commits that touch docs, as a pre-commit habit, or any time a canonical number changed
- After a bulk find-and-replace, to confirm nothing was missed
- When a repo has a "grep for other files with the same number" rule that people forget to follow
When NOT to Use
- A repo with no duplicated facts — one source of record per value, nothing hand-copied. There is nothing to drift.
- Values that legitimately differ per file (dated snapshot series, goal targets vs. current numbers, historical records). Those are not copies; tracking them produces false positives. See Edge Cases.
