| name | semantische-review |
| description | Periodieke semantische docs-review van een component — legt proza naast code/config en meldt tegenstrijdigheden. Gebruik bij "semantische review", "docs-review <component>", "klopt de documentatie van X nog". |
Semantische review
Cadans: maandelijks, twee componenten per beurt (roterend; volgorde =
langst niet gereviewd eerst, zie last_reviewed in de front-matter).
Dit vangt wat doc-assertions en verify-blokken níet kunnen: vrij proza.
Werkwijze per component
- Lees de docs via MCP
conduction-docs (list_components →
read_page per pagina); de lokale checkout is de code-kant.
- Extraheer per pagina de feitelijke beweringen (paden, namen,
defaults, flows, statusclaims — geen meningen/uitleg).
- Toets elke bewering tegen de bron: manifests, scripts, configs,
Makefiles. GET-check-first: lees écht, neem niets aan.
- Classificeer: klopt / drift (bewering ≠ werkelijkheid) /
ontoetsbaar-proza.
- Drift: triviale gevallen direct fixen (docs-as-code, zelfde
wijziging), structurele als bevinding melden via de
docs-drift-routing (issue in handbook, label
docs-drift) mét beide
bronnen geciteerd.
- Sluit af met: aantal beweringen getoetst / drift gevonden / gefixt,
en bump
last_reviewed van de gereviewde pagina's — de review ís
de handeling.
- Kandidaat-promotie: elke getoetste bewering die zich leent voor een
doc-assertion of verify-blok → voorstel in dezelfde wijziging
(semantisch werk hoort te slinken naarmate lagen 1-2 groeien).
