— Single Source of Truth (SSOT)¶

Doel¶

Deze map is de centrale waarheidslaag van het Buurts Ecosysteem. Alle governance-documenten, templates, compliance-records en content-inventarisaties die als definitief en gevalideerd worden beschouwd, horen hier thuis.

Wat hoort hier wél¶

Gevalideerde governance-documenten (risicoregisters, beleid, compliance)
Universele sjablonen (templates) voor alle documenttypen
Content-inventarisatie en gap-analyses (AI-ready)
Architectuurbeslissingen en acceptatiecriteria die zijn vastgesteld

Wat hoort hier NIET¶

Concepten of drafts → gebruik docs/plans/ totdat iets gevalideerd is
Audience-specifieke vertalingen → gebruik docs/stakeholders/
Publiceerbare externe content → gebruik docs/website-reports/
Operationele procedures → gebruik docs/operations/

Mapstructuur¶

docs/truth/
  README.md                  ← dit bestand
  content-inventory.yml      ← volledige content-inventarisatie (AI-ready)
  gap_report.md              ← gap-analyse template (governance/compliance)
  templates/
    governance/              ← risicoregister, audit, security, beleid
    project/                 ← projectplan, communicatie, stakeholderanalyse
    operationeel/            ← how-to, API-ref, incident, release-notes
    stakeholder/             ← voortgangsrapport, blogpost, FAQ, kennisbank
    ai/                      ← content-inventory, gap-rapport, standaardvragen
    ms365/                   ← sync-log, Teams-aankondiging, Loop-component

Acceptatiecriteria¶

Een document mag in docs/truth/ worden geplaatst als:

Het is beoordeeld door de owner of een aangewezen reviewer
De frontmatter is volledig ingevuld (verplichte velden, zie templates)
De status staat op accepted of validated
Compliance-velden (compliance_tags, ai_audit_level) zijn ingevuld
Er is een last_reviewed datum aanwezig

Gebruik door agents¶

Lees de templates in templates/ als basis voor nieuwe documenten
Schrijf geen documenten direct in deze map; gebruik docs/plans/ als staging
Verifieer altijd status en validation velden vóór gebruik van content
Signaleer gaps via gap_report.md en open vragen via open_questions

Beheer: Niels (architect) | Zone: GREEN | Retentie: permanent