Waarom dit handboek

Het project heeft drie soorten geschreven artefacten over architectuur:

1. ADRs in docs/06-adr/ — beslissings-records. Eén ADR per genomen beslissing, met formele status (Draft / Accepted / Superseded). Korte motivatie, concrete keuzes, datum, beslisser.
2. Werkdocumenten in docs/01-architecture/, docs/24-research/, docs/40-implementation-plans/, etc. — plat-markdown, gevarieerd in vorm, vaak één onderwerp per file zonder onderling kruisverband.
3. Handoffs in docs/handoffs/ — sessie-einde-noten van wat er besproken is en wat de volgende sessie moet oppakken. Tijd-stempel-georganiseerd.

Inmiddels zijn er 60+ ADRs, 100+ werkdocumenten, en tientallen handoffs. Het probleem: bij een specifieke vraag — "waarom hebben we instrument-manifestaties los van publicatie-rijen?" — moet je nu door drie tot vijf bestanden zoeken om het verhaal compleet te krijgen. Het beslissings-fragment staat in een ADR, de evidence in een research-doc, het narratief in een handoff, de feitelijke schema-vorm in een migratie. Geen daarvan vertelt het volledige verhaal in één lopende lezing.

Dit handboek is die lopende lezing. Het is:

• Narrative, niet beslissings-fragmentarisch. Een hoofdstuk loopt door, met verwijzingen naar de onderliggende ADRs en evidence.
• Brede contextverzameling — schema-redeneringen, evidence-tabellen uit corpus, discussies, alternatieven die zijn afgevallen.
• Navigeerbaar — hoofdstukken, subsecties, zijbalk, zoekfunctie. Zoals API-documentatie.

Dit handboek is niet:

• ADR-archief — beslissingen blijven in docs/06-adr/. Dit handboek verwijst ernaar, maar herhaalt niet de beslissings-formaliteit.
• Kennisgraaf — geen RDF, geen SHACL, geen SPARQL. Lees-georiënteerd, niet machine-georiënteerd.
• Volledig per moment — het groeit. Pagina's mogen 'work in progress' zijn zolang de strekking helder is.

Wanneer voeg je iets toe?

Bij elke sessie waar een schema-beslissing wordt genomen of een taxonomie wordt uitgewerkt: zet de essentie van die discussie in een sub-pagina van het juiste hoofdstuk. Niet alle alternatieven die zijn besproken — wel de uitkomst, het waarom, en links naar de ADR die de formele beslissing vastlegt.

Doel: een nieuwe lezer (jezelf over zes maanden, of een collega) leest dit handboek en heeft binnen 30 minuten een werkend model van hoe het schema in elkaar zit en waarom de keuzes zo gemaakt zijn.