Naad A · explorer → scaffolder

Het contract tussen de productdefinitie en de code-spine. Eén skill overbrugt hem: generate-scaffolder-config.

Vandaag

De skill leest een documentationFolder en zoekt op filename en heading naar:

Wat	Verplicht
business case	✅
functional specs	✅
personas	optioneel
user-stories/	optioneel

Daaruit leidt hij alleen toggles af — name, frontend/docs/ci, persistence/mailer/auth, i18n.locales — mét evidence en confidence per afleiding, en schrijft scaffolder.config.yaml.

De frictie

1. Layout-mismatch

solution-explorer schrijft solutions/<slug>/0N-*/… — Nederlands proza, wisselende volledigheid. De bridge verwacht business-case*, functional-spec*, user-stories/. Bij family-choirs is dit handmatig genormaliseerd naar een documentatie/-map.

2. Alleen toggles

Entiteiten, velden en routes worden niet afgeleid. Na generate moet iemand per entiteit scaffolder add-module <naam> draaien en elk veld met de hand invullen — de stub is CRUD over id / createdAt / updatedAt. Dit is de grootste handmatige brok in de hele keten.

3. Machine-leesbaar signaal — deels opgelost

Er was geen machine-leesbaar manifest aan de explorer-kant en geen readiness-vlag behalve een emoji-lifecycle-tabel in elke README.md. De kandidaat-registry vult dat gat nu deels: er is een candidacy-signaal.

Het doelcontract

1. De explorer exporteert een genormaliseerde documentatie/-map met vaste bestandsnamen die de bridge kent (business-case, functional-spec, personas, user-stories/). Nog open — dit is de scaffoldReady-vlag in het manifest.
2. De explorer emit een solution-manifest.json per solution: slug, lifecycle-status, tech-stack-keuzes uit gecontroleerd vocabulaire, entiteiten (+ velden), routes, en links naar de onderliggende markdown. Dan hoeft de scaffolder geen proza te freeform-parsen en kan add-module gevoed worden met echte velden. Basis gebouwd — velden en entiteiten nog uit te breiden.

Gerelateerde gaps

#	Gap	Status
G1	Geen genormaliseerde documentatie/-export; layout-mismatch	🟡 candidacy-signaal + scaffoldReady-vlag gebouwd; de export zelf nog open
G2	Entiteiten/velden niet afgeleid → handmatig add-module	🟡 manifest-basis gebouwd; entiteiten/velden nog toe te voegen

→ Volledige gap-lijst