ssotchk
Installation
SKILL.md
Find every place a single truth lives, name its rightful home, and report the drift — without changing anything.
Goal
Locate Single-Source-of-Truth (SSOT) violations: one fact duplicated, paraphrased, or contradicted across artifacts or platforms. A fact with N copies carries N-1 liabilities, because copies drift out of sync. The output is a map — where it lives, which copy should be canonical, and what to do with the rest — that ssotize or a human can act on. This is read-only.
Reach for this when establishing order across many artifacts, especially messy or legacy states; once a fact is cleanly SSOT'd, it needs upkeep, not another consolidation.
Workflow
- Name the truth in scope — the specific fact, value, spec, decision, status, or definition being tracked, not the whole document.
- Enumerate every occurrence across the given artifacts and platforms.
- Classify each occurrence: exact copy, paraphrase, partial, stale, or contradictory.
- Pick the canonical home — the most authoritative and most-maintained location, closest to where the fact actually changes (the code/config for a value, the spec for a decision, the ticket for status); never arbitrarily.
- Decide the action per non-canonical occurrence: dedupe (redundant copy), reference (docs should link to canonical, code should import/source/include it, config should use a shared read), or reconcile (it disagrees — needs a human call on which is right).
- Report: a table of occurrences (location · kind · action), the proposed canonical home with a one-line justification, and a separate list of contradictions/drift that need a decision.