ssotchk
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.
A different vector from re0, and they pair well. re0 refreshes one artifact into a clean v0 (depth, one thing at a time); SSOT work unifies one truth across many places (breadth, across artifacts and platforms). Reach for SSOT when establishing order — refactoring a legacy codebase, building or grading the severity of a knowledge base, or scaffolding a new project. Once a fact is cleanly SSOT'd, keep it tidy with re0 rather than repeated 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 (search files, docs, wikis, tickets, channels, code, config).
- 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).
- Decide the action per non-canonical occurrence: dedupe (redundant copy), reference (should link to canonical), 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.