# Verbeterplan — Uniforme Deliverables Borging

**Doel**: de 12 gaps uit `sop_audit.md` dichten met concrete, implementeerbare maatregelen.
**Ontwerpprincipe**: *mechanisch vóór mentaal* — elke regel die nu op discipline leunt, krijgt een tooling-hook die dezelfde regel afdwingt op een moment dat er nog geen zonnige avond-kostbare uren in zitten.

---

## Maatregel 1 — Deliverables Gatekeeper (oplossing voor A1, A2, B2, C2, C3, C4)

**Wat**: Eén script, `scripts/deliverables_gatekeeper.py`, drie run-modes:

| Mode | Moment | Checks | Effect bij FAIL |
|------|--------|--------|-----------------|
| `--phase entry` | Vóór eerste subagent-spawn | project_prompts.log bestaat +7 submappen + research/sources.md + (waarschuwing) GO-log | Blokkeert: orchestator krijgt FAIL + concrete fix-instructies |
| `--phase artefact --file <pad>` | Direct na elke subagent-run | Bestaat, >0 bytes, formaat klopt met extensie | Triggert Artefact Recovery Protocol (maatregel 2) |
| `--phase deliverables --manifest <manifest>` | Vóór oplevering | Golden-Standard diff, legacy/combined detectie, changelog-vs-fs consistentie, anti-corruptie scan | Blokkeert levering; rapporteert per bestand |

**Implementatie**: zie `implementatie.md` + werkende script in `scripts/deliverables_gatekeeper.py` (meegeleverd, getest tegen beide auditprojecten).

**Borging**: MASTER_SOP §3.0/§5.2-#13 verwijst naar dit script; exit code 0 = verplicht vóór spawn respectievelijk levering.

## Maatregel 2 — Artefact Recovery Protocol (oplossing voor B1, B2, B3)

**Wat**: gestandaardiseerd recept bij "subagent OK maar geen fysiek artefact":

1. **Verifieer** — `deliverables_gatekeeper.py --phase artefact --file <verwacht-pad>` (mislukking = bewijs, geen interpretatie)
2. **Re-spawn met output-contract** — de taakbeschrijving bevat verplicht het blok:
   ```
   OUTPUT-CONTRACT (VERPLICHT):
   - Absoluut pad: /root/projects/jg/<project>/working/<naam>_v<x>.<ext>
   - Minimale grootte: 1 KB
   - Formaat: markdown met vereiste secties: [lijst]
   - Laatste actie van je run: schrijf het bestand, verify met `test -f && wc -c`
   ```
3. **NOOIT zelf produceren** — ook niet "eventjes nood-QC" (§5.4); herhaald = Critical System Failure-log in `logs/system_failures.log`

**Borging**: tekst-blok opgenomen in §1.3-stappen; output-contract-template komt in de standaard spawn-macro.

## Maatregel 3 — Onafhankelijke QC-heraudit Chromium VI (oplossing voor B4, directe schade)

**Wat**: het bestaande `qa_report.md` (Director als auditor) is per §5.4 VOID:
1. Markeer het bestand: hernoem naar `qa_report_VOID_director_qc.md` + voeg VOID-header toe
2. Spawn een **nieuwe onafhankelijke QC-subagent** die de 20 checklist-items opnieuw uitvoert — mét de eerder ontbrekende DOCX-inspecties (gatekeeper-artefact-check zorgt voor fysiek rapport)
3. De 8 "Onbekend"-items (branding, logo-ratio, kleuren, headers/footers, styleguide) moeten **bewezen** PASS/FAIL worden, niet "Onbekend"

## Maatregel 4 — Chromium VI cleanup (oplossing voor C3-restanten)

**Wat**: verontreinigde deliverables-map saneren:
1. Verplaats 3 legacy-combined bestanden naar `archive/`:
   - `docx/003.056_CrVI_Compliance_Audit_en_Herzieningsvoorstel_v1.0.docx`
   - `html/003.056_CrVI_Compliance_Audit_en_Herzieningsvoorstel_v1.0.html`
   - `checklists/003.056_CrVI_Checklists_v1.0.docx`
2. CHANGELOG v1.1-entry: "Splitsing in aparte deliverables 1:1 Mercury Golden Standard; combined v1.0 naar archive/"
3. Run `deliverables_gatekeeper.py --phase deliverables` → moet PASS geven

*(Bewust als voorgestelde actie voor Kas gelaten — mutaties in een afgerond auditeindossier horen bij de Director-flow, niet bij dit reparatierapport.)*

## Maatregel 5 — Golden Standard Manifest (oplossing voor C1)

**Wat**: codificeer de Mercury-structuur als machine-leesbaar contract (`golden_standard_manifest.json`), op te nemen in `assets/` van de workspace:

```json
{
  "manifest_versie": "1.0",
  "referentieproject": "2026-audit-koole-mercury-003057",
  "documenttypes": [
    {"naam": "audit_rapport", "root_md": "audit_rapport_*.md", "docx": "docx/Compliance_Audit_*.docx", "gescheiden": true},
    {"naam": "herzieningsvoorstel", "root_md": "herzieningsvoorstel_*.md", "docx": "docx/Herzieningsvoorstel_*.docx", "gescheiden": true},
    {"naam": "checklist", "checklists_md": "checklists/*_Checklist_*.md", "checklists_pdf": "checklists/*_Checklist_*.pdf"},
    {"naam": "elearning", "html": "html/*_elearning.html", "html": "html/quiz.html", "json": "html/*_quiz.json"}
  ],
  "verboden_patronen": ["*_en_*_v*.docx", "*_en_*_v*.html"]
}
```

De gatekeeper verbruikt dit manifest in `--phase deliverables`-mode. Nieuwe projecttypen = nieuw manifest met eigen referentieproject.

## Maatregel 6 — Spawn-protocol wijziging (oplossing voor A1, B1 preventief)

**Wat**: de standaard spawn-flow van Kas krijgt twee verplichte stappen:

```
VOOR spawn:    deliverables_gatekeeper.py --phase entry <projectmap>
               → FAIL? → eerst Fase 0-1 afronden (incl. GO-log), NIET spawnen
TAKTBESCHRIJVING: altijd OUTPUT-CONTRACT-blok (maatregel 2)
NA spawn:      deliverables_gatekeeper.py --phase artefact --file <contract-pad>
               → FAIL? → Artefact Recovery Protocol
```

**Borging**: opnemen in MASTER_SOP v8.9 §3.0 en in de spawn-macro van de orchestrator.

## Maatregel 7 — SOP v8.9-wijzigingsvoorstel (oplossing: consolidatie)

**Wat**: de vijf sectiewijzigingen uit `sop_audit.md` (§3.0 Phase-Entry Gate, §1.3 Artefact Recovery, §5.2 checks #13/#14, §3.5 Golden Standard Manifest, §5.4 VOID-detectie) als wijzigingsvoorstel aanleveren aan Kas voor formele SOP-release 8.9. Dit rapport + de werkende gatekeeper dienen als bewijs van haalbaarheid.

---

## Prioritering & planning

| Prioriteit | Maatregel | Type | Inspanning | Status in dit project |
|-----------|-----------|------|-----------|----------------------|
| P1 | 3. QC-heraudit Chromium VI | Herstel | 1 subagent-run | ✅ Voorgesteld (VOID-markering voorbereid in gatekeeper-rapport) |
| P1 | 4. Chromium cleanup | Herstel | 15 min | ✅ Gedocumenteerd + gatekeeper detecteert restanten |
| P1 | 1. Gatekeeper | Preventie | 1 script | ✅ Gebouwd + getest (PASS op Mercury, FAIL-checks geverifieerd op Chromium) |
| P2 | 2. Artefact Recovery Protocol | Preventie | SOP-tekst | ✅ Uitgewerkt (implementatie.md §3) |
| P2 | 6. Spawn-protocol wijziging | Preventie | Config | ✅ Uitgewerkt (implementatie.md §4) |
| P2 | 5. Golden Standard Manifest | Preventie | JSON | ✅ Uitgewerkt + in gatekeeper verwerkt |
| P3 | 7. SOP v8.9-wijziging | Governance | Review Kas | ✅ Voorstel klaar (sop_audit.md) |

## Succescriteria

1. **Vandaag nog**: gatekeeper draait op beide auditprojecten met correcte PASS/FAIL (bewijs in rapport §6)
2. **Bij eerstvolgende audit**: geen spawn zonder entry-PASS; geen subagent-run zonder artefact-PASS
3. **Bij eerstvolgende levering**: deliverables-diff tegen manifest vóór oplevering; nul legacy-bestanden in deliverables/
4. **Bij eerstvolgende QC**: QC-rapport fysiek, door subagent, 0 "Onbekend"-items