TUTORIAL | OpenSpec — retrofit en vervolgdelen (deel 3+)

[WilcoLouwerse]

Achtergrond

PR #38 op de academy levert deel 1 (Wat is OpenSpec?) en deel 2 (Je eerste OpenSpec change) van de OpenSpec-leerlijn op. Daarmee is de instaproute gedekt, maar de vervolgdelen uit het oorspronkelijke voorstel (zie issue #51) staan nog open. Dit issue splitst die vervolgdelen af, zodat #51 met PR #38 dichtgezet kan worden.

Doel

De OpenSpec-leerlijn op conduction.nl/academy uitbreiden met de vervolgtutorials voorbij "je eerste change", in dezelfde korte chained-stijl. Focus: hoe pas je OpenSpec toe op een bestaande codebase, en hoe werk je verder met changes na de eerste keer.

Doelgroep

Developers en partners die deel 1 + 2 hebben gevolgd en OpenSpec willen toepassen op een echt project of een bestaande Conduction-codebase.

Voorgestelde structuur (chaining)

Voorlopig één hoofdmoduul + ruimte voor optionele uitbreidingen. Doe eerst: deel 1 + 2.

3. Spec-coverage in een bestaande codebase (retrofit) — een bestaand project onder OpenSpec brengen: /opsx-retrofit, capabilities afleiden uit bestaande code/tests, spec-traceability opzetten, gaps in beeld krijgen.
4. (optioneel) Werken met meerdere changes & archiveren — parallelle changes, conflicten in deltas, validatie, en het archiveer-moment.
5. (optioneel) OpenSpec in PR-flow & Hydra — hoe een change door de quality gates komt, koppeling met de Hydra-leerlijn (issue #50).

Bestaande documentatie (referenties)

In .github/docs/claude/:

• docs/claude/retrofit.md — primaire bron voor deel 3
• docs/claude/commands-openspec.md
• docs/claude/writing-specs.md
• docs/claude/writing-docs.md

Externe referentie: openspec.dev.

Pluvo-vragen (minimaal 4 per deel)

Voorbeelden voor deel 3 (retrofit):

1. Wat doet /opsx-retrofit en wanneer zet je hem in?
2. Hoe leid je capabilities af uit bestaande code en tests?
3. Wat is "spec-coverage" en hoe meet je hem?
4. Welke gaps in de bestaande code maakt een retrofit zichtbaar — en wat doe je daarmee?
5. Wat is het verschil tussen een retrofit-change en een gewone feature-change?

Op te leveren

• Tutorial(s) in MDX op ConductionNL/conduction-website onder academy/, doorlinkend vanaf deel 2
• Cross-links naar deel 1 + 2 (PR #38), Hydra-leerlijn (issue #50) en Claude-skills (issue #52)
• Minimaal 4 Pluvo-vragen per deel
• Linkcheck
• Peer review

Schrijfstijl

Volg de Conduction-schrijfstijl (zie identity.conduction.nl). Voorbeeldstructuur: Bestanden bij een Woo-publicatie uploaden. Liever korte, gekoppelde delen dan één lange tutorial.

Tijdregistratie

Uren op dit issue boeken op de Jira-issue van het SLIM-account.

[WilcoLouwerse]

Splitsing actief 🟢

Dit issue is vandaag afgesplitst van #51 zodat PR ConductionNL/conduction-website#38 (deel 1 + 2) gemerged kan worden zonder op deel 3+ te wachten. Volgende stap: tutorial deel 3 (retrofit) opzetten in academy/ op basis van docs/claude/retrofit.md.