Retrofit skills & documentation improvement (Openregister)

[WilcoLouwerse]

Uitvoeren van de Retrofit skills voor de Openregister app en verbeteren van de skills waar nodig.

Follow-up/split from #20.

Scope

• /opsx-coverage-scan — Audit skill: produceert een 6-bucket coverage report vóór retrofit annotatie
• /opsx-annotate — Past Bucket 1 @spec tags toe via een ghost change, opent een annotation-only PR
• /opsx-reverse-spec — Reverse-engineert een spec uit bestaande code voor één Bucket 2 cluster per run
• Retrofit playbook — Documentatie in .github met de stapsgewijze uitleg van de retrofit flow

Mogelijke verbeterpunten

• Retrofit skills uitvoeren voor Openregister (volgende app in de roll-out volgorde na opencatalogi pilot)
• Skills verbeteren op basis van bevindingen tijdens de Openregister retrofit run

Gerelateerde issues

• ADR cleanup pass — openregister coverage-report.md Bucket 4 openregister#1370 — ADR cleanup pass gegenereerd door /opsx-coverage-scan tijdens de Openregister retrofit run (Bucket 4 bevindingen)

[WilcoLouwerse]

21-04-2026

hydra repo - chore(skills): raise opsx-reverse-spec to L6 + rebalance target levels

• opsx-reverse-spec skill verhoogd naar L6
• Target levels van overige skills herzien en rebalanced

[WilcoLouwerse]

23-04-2026

• Retrofit playbook geconsolideerd in .github repo
• OpenRegister coverage report en retrofit-annotate doorgevoerd

.github repo - docs: consolidate retrofit playbook

• Retrofit playbook documentatie geconsolideerd

hydra repo - skills onderhoud

• opsx-coverage-scan learnings van de openregister scan vastgelegd

openregister - openspec: coverage report en retrofit-annotate

• Coverage report en retrofit-annotate change proposal aangemaakt
• Methods geannoteerd met @SPEC tags op basis van coverage scan
• ObjectServiceMapperAdapter toegevoegd voor externe mapper-style access

[WilcoLouwerse]

24-04-2026

• Hydra opsx skills geconsolideerd en skill library uitgebreid met L5/L6 evals
• OpenRegister Bucket 1 retrofit gestart — 395 methods geannoteerd

hydra repo - chore(skills): consolidate opsx family, add L5/L6 evals, extract templates

• Learnings gepromoveerd naar SKILL.md voor opsx-annotate, opsx-coverage-scan, opsx-reverse-spec en retrofit skills
• Eval grading/timing artifacts en REQ-NNN spec heading format toegevoegd

openregister - retrofit: annotate openregister Bucket 1

• Archival-destruction-workflow REQ-009 gedraft en 11 methods geannoteerd
• Spec headings genormaliseerd naar REQ-NNN format
• blame-ignore-revs bijgewerkt

Voor meer details zie de open PR's;

https://github.com/ConductionNL/hydra/pull/184
ConductionNL/openregister#1337

[WilcoLouwerse]

28-04-2026

• OpenRegister Bucket 2a + Bucket 2b retrofit volledig afgerond
• Nieuwe specs aangemaakt voor meerdere capabilities

openregister - retrofit: Bucket 2a/2b reverse-spec + annotate (~380 methods)

• Tenant-lifecycle REQ-005 spec gedraft + gearchiveerd
• Object-lifecycle spec aangemaakt (5 REQs) + 252 methods geannoteerd
• Content-versioning REQ-017 en calendar-integration (2 REQs) toegevoegd
• Tenant-isolation-audit, schema-hooks, notificatie-engine clusters geannoteerd
• Bucket 2b — ~70 + 19 resterende files geannoteerd
• Coverage report gerefreshed, blame-ignore-revs bijgewerkt

Voor meer details zie de open PR's;

ConductionNL/openregister#1337
ConductionNL/openregister#1350

[WilcoLouwerse]

30-04-2026

• OpenRegister retrofit voortgezet — nieuwe Bucket 1 pas, chat-ai spec, Bucket 3b triage
• 2 PR's gemerged vandaag

openregister - retrofit: Bucket 1 herpas + chat-ai cluster + Bucket 3b triage

• Bucket 1 herpas — 169 methods geannoteerd over 67 files (gemerged ✅)
• Chat-ai spec gedraft (5 REQs) + 22 methods geannoteerd (gemerged ✅)
• Bucket 3b getriaged — 5 niet-geïmplementeerde REQs gemarkeerd als deferred
• Audit-trail immutabiliteit afgedwongen op destroyMultiple()

Voor meer details zie de PR's;

ConductionNL/openregister#1364
ConductionNL/openregister#1365 (gemerged)
ConductionNL/openregister#1368 (gemerged)

[WilcoLouwerse]

01-05-2026

• PR #1364 gemerged ✅ (goedgekeurd door Remko)
• 3 nieuwe Bucket 2a clusters als aparte PR's aangemaakt

openregister - retrofit: actions, oas-generation en approval-workflow

• Actions spec gedraft (5 REQs) + 9 methods geannoteerd
• OAS-generation spec gedraft (2 REQs) + 2 methods geannoteerd
• Approval-workflow spec gedraft (5 REQs) + 13 methods geannoteerd
• Coverage report bijgewerkt, blame-ignore-revs bijgewerkt

Voor meer details zie de PR's;

ConductionNL/openregister#1364 (gemerged ✅)
ConductionNL/openregister#1394 (open — needs review)
ConductionNL/openregister#1397 (open — needs review)
ConductionNL/openregister#1400 (open — needs review)

---

Deze issue lijkt inhoudelijk klaar. Na een korte check/review door MWest2020 kan hij naar done. Verdere of toekomstige werkzaamheden worden bijgehouden in #33