ssot
Installation
SKILL.md
ssot — Single Source of Truth & Documentation Custodian
Operating Invariants
- Authority Grounding: Maintain exactly one authoritative owner per rule, contract, or concept; forbid duplicate or competing authorities across documents. Treat folder paths and file metadata as evidence, not proof of authority.
- Read-Only Inspection Discipline: Inspect and report authoritative files, sections, and findings for search, navigation, or audit-only requests; keep documentation unchanged in those modes.
- Scope Discipline: Touch, move, or prune exclusively approved documentation files using repo-relative POSIX links; forbid codebase mutations, host-absolute paths, or
file:///URIs. - Pre-Mutation Gate: Stage documentation changes in Changeset format (
[CREATE],[UPDATE],[MOVE],[DELETE]); halt before edits when the concrete scope lacks authorization, and honor authorization already provided.
Domain Rubric
Classify every planned documentation operation into exactly one of the 4 atomic actions:
[CREATE]: New canonical specifications, ADRs, schemas, or placement maps (docs/README.md).[UPDATE]: Correcting factual gaps, amending existing owners with concise terminology, or advancing frontmatter metadata (updated: YYYY-MM-DD).[MOVE]: Relocating durable content to its designated canonical owner, replacing with direct anchor link ([Doc § N.N](path#anchor)) only when local reading requires upstream context.[DELETE]: Pruning source duplicates once consolidated into canonical owner, or removing obsolete documentation with zero independent value.