25 — Onderzoek

Verkennend schrijfwerk over onderwerpen waar nog geen vaste besluiten op zitten. Notities, bevindingen, ruwe redeneringen, externe links — alles wat helpt om eerst te denken voordat we vastleggen.

Onderzoek is kortlevend maar niet wegwerp. Een doc hier kan maanden mee terwijl we iets uitzoeken, en eindigt dan ofwel als gepromoveerd (naar een PRD/ADR/TDS) of gearchiveerd (we hebben gekeken, geleerd, en zijn doorgegaan).

Reikwijdte in Documentatie

Onderzoek hier gaat over cross-repo onderwerpen — generatie-tooling voor overlays, gedeelde schema-formaten, MCP-tool registries, etc. Onderzoek binnen één app hoort in die app zijn eigen docs/25-onderzoek/.

Wanneer wel

• Een onderwerp blijft terugkomen maar we hebben er nog geen vaste mening over
• Je verzamelt externe context (papers, vendor-docs, concurrentieanalyse) en wilt dat vastleggen
• Een mogelijk besluit vormt zich maar is nog niet klaar voor een ADR
• Je wilt schrijvend nadenken zonder de formaliteit van een PRD

Wanneer niet

• Het besluit is al genomen — schrijf een ADR
• De wijziging is al gescoped — schrijf een PRD
• Eenmalige kladnotitie zonder publiek of vervolg — bewaar lokaal

Levenscyclus

concept  ──►  actief  ──►  gepromoveerd  (werd PRD/ADR/TDS — link erheen)
                  └─►  geparkeerd     (gepauzeerd, mogelijk hervat)
                  └─►  gearchiveerd   (klaar, bewaard ter referentie)
                  └─►  gestaakt       (liep dood, korte notitie waarom)

Statuswaarden:

Status	Betekenis
Concept	Net begonnen, ruwe notities
Actief	Wordt aan gewerkt
Geparkeerd	Gepauzeerd; mogelijk hervat
Gepromoveerd	Heeft elders een artefact opgeleverd; link erheen
Gearchiveerd	Klaar, bewaard voor toekomstige referentie
Gestaakt	Liep dood; korte notitie legt uit waarom

Bestandspatroon

<onderwerp>.md — kort. Geen -onderzoek-suffix nodig; de map maakt het al impliciet.

Voorbeelden: mcp-tool-registry-generatie.md, cross-repo-schema-versionering.md, overlay-pipeline-keuzes.md.

Sjabloon

# <Onderwerp>

**Gestart:** YYYY-MM-DD
**Laatst bijgewerkt:** YYYY-MM-DD
**Status:** Concept | Actief | Geparkeerd | Gepromoveerd | Gearchiveerd | Gestaakt
**Auteur:** <naam>

## Vraag

(Wat proberen we uit te zoeken. Eén of twee zinnen.)

## Waarom dit ertoe doet

(Wat verandert er stroomafwaarts als we dit beantwoorden. Wat zit nu vast zonder dit antwoord.)

## Notities

(Vrije vorm. Bevindingen, halve redeneringen, doodlopende paden. Dateer entries als het doc meerdere zittingen beslaat.)

## Bronnen

- [Link](https://…) — één-regel notitie over wat hier relevant is
-

## Voorlopige richting

(Als een mening vorm krijgt, schrijf hem hier op. Nog geen besluit.)

## Wat dit zou kunnen informeren

- PRD: [[prd-slug]] (gepland)
- ADR: [[ADR-slug]] (gepland)
- TDS: [[TDS-slug]] (gepland)

## Uitkomst

(Invullen wanneer status naar Gepromoveerd/Gearchiveerd/Gestaakt gaat. Eén zin: waar landde dit.)