DNA / SSoT Enforcement
SSoT Enforcement
One truth. Zero divergence.
Single Source of Truth (SSoT) is the principle that every domain has exactly one canonical data source, and all other representations are derived from it. In a multi-agent ecosystem, SSoT prevents the catastrophic divergence that happens when agents have different views of reality.
Key Principles
- 01One file per domain: product-master-table.json, ecosystem.json, repos.yaml — each is the canon
- 02Derived representations only: dashboards, docs, and UI read from SSoT — they never define it
- 03Conflict detection: Flex-vcms scans all repos for divergence from canonical definitions
- 04Agent reads SSoT first: before any agent makes a change, it reads the canonical source
Real Examples from Production
ecosystem.json
Single source for all 8 repos: their status, stack, dependencies, and health endpoints. Every tool that needs to know "what's running" reads this file.
public/ecosystem.json →
product-master-table.json (ZZPackage)
All product definitions, prices, descriptions, and dependencies live here. The WordPress theme, the wizard UI, and the validation scripts all read from this one file.
zzpackage.flexgrafik.nl/ →
repos.yaml (Flex-vcms)
Canonical list of all repositories, their roles, and scan rules. vcms-scan.js reads this to generate ecosystem maps and detect conflicts.
Flex-vcms/flex-vcms/repos.yaml →
Traditional vs AI Systems Architect
Traditional Developer
Product name updated in the UI but not in the database. Price changed in code but not in the CMS. Three months later: three different versions of reality.AI Systems Architect
Product name updated in product-master-table.json. All representations auto-derived. One commit. Zero divergence.