Werkwijze

Development operating model: wie doet wat, de standaard agent-pipeline, hooks/checkpoints en het escalatiebeleid. De cockpit is de verkeerstoren; Git/GitHub blijft de bron van waarheid.

Read-only t.o.v. repositoriesSTALE (MANUAL_SNAPSHOT)· 8 dagen geleden

ChatGPT

Rol
  • productstrategie
  • architectuur
  • complexe besluitvorming
  • ownerbeslispakketten
  • onafhankelijke analyse
  • beoordeling van agentuitkomsten
  • formulering van grote opdrachten
  • regie
Niet voor
  • ✗ rechtstreeks werken in lokale repositories
  • ✗ zelfstandig ownerbesluiten nemen

Claude Code

Rol
  • implementatie
  • refactors
  • tests
  • documentatie
  • quality remediation
  • langdurige autonome runs
  • lokale repositorywerkzaamheden
Niet voor
  • ✗ merge naar main of productie zonder owner-GO
  • ✗ externe gates sluiten
  • ✗ projectgrenzen overschrijden

Codex

Rol
  • second opinion
  • onafhankelijke AI-code review
  • alternatieve implementatieanalyse
  • testanalyse
  • securityreview
  • architectuurreview
  • gerichte coding tasks waar nuttig
Niet voor
  • ✗ vervanging van een menselijke reviewer waar governance menselijke review vereist (D-013)

GitHub

Rol
  • bron van waarheid
  • code
  • commits
  • branches
  • PR's
  • CI
  • evidence
  • decision records
Niet voor
  • ✗ automatische merges zonder gesloten gates

Vercel

Rol
  • preview
  • deployment
  • release evidence
  • protection
  • runtime status
Niet voor
  • ✗ productie-deployment zonder owner-GO
  • ✗ configuratiewijziging zonder GO

Development Cockpit

Rol
  • centrale verkeerstoren
  • observability
  • routing
  • job preparation
  • voortgang
  • sessions
  • gates
  • ideeën
  • quality status
  • orchestration (voorbereidend)
Niet voor
  • ✗ bron van waarheid
  • ✗ opdrachten uitvoeren of processen starten
  • ✗ schrijven naar projectrepositories
  • ✗ besluiten nemen

Agent-pipeline

  1. Plan
  2. Implementeren
  3. Zelftest
  4. Onafhankelijke AI-review
  5. Herstellen
  6. Evidence vastleggen
  7. Owner / externe gate
  8. Merge-ready
  9. Release-gate
FaseAgentOutputEvidenceKlaar als
Plan PLANChatGPT of Claude Code (plan mode)scope, aanpak, risico's, gatesplan in handoff/taakbeschrijvingscope binnen één werkstroom; owner-gates benoemd
Implementeren IMPLEMENTClaude Codecommits op featurebranchcommitsbinnen scope; geen verboden handelingen
Zelftest SELF_TESTClaude Codelint, typecheck, unit, integratie, e2e, buildtestuitvoer / CI-runalles groen of falen gedocumenteerd
Onafhankelijke AI-review INDEPENDENT_AI_REVIEWCodex of Claude-subagent (alleen-lezen)bevindingenreviewverslagbevindingen geclassificeerd; vervangt GEEN menselijke review
Herstellen REMEDIATEClaude Codeherstelcommitscommits + hertestgeen open high/critical
Evidence vastleggen EVIDENCEClaude CodeSTATE, JOURNAL, REVIEW_READINESS, quality dossierdocumentcommitsevidence herleidbaar naar exacte commit
Owner / externe gate OWNER_EXTERNAL_GATEOwner / externe partijbesluit of reviewdecision record / reviewverslaggate formeel gesloten — nooit door een agent
Merge-ready MERGE_READYOwnerGO voor mergealle gates geslotenexpliciete owner-GO
Release-gate RELEASE_GATEOwnerrelease/productie-GOrelease evidence (commit, preview, smoke, rollback)expliciete owner-GO voor productie

Hooks (niet-destructief)

  • Na codewijziging (PostToolUse op Edit/Write)Checks: lint; typecheck; relevante testsGedrag: rapporteert; blokkeert niet; voert nooit cleanup uit
  • Vóór commit (PreToolUse op Bash: git commit)Checks: secrets scan op staged diff; security scan waar aanwezig; teststatusGedrag: blokkeert de commit bij een secret; geen automatische correctie
  • Vóór elke shellopdracht (PreToolUse op Bash)Checks: destructieve git-acties (force-push, reset --hard, clean -f, history rewrite); productie-deployment (--prod); --dangerously-skip-permissionsGedrag: blokkeert en vraagt owner-GO; voert zelf niets uit
  • Vóór merge-ready (handmatig/Stop)Checks: quality evidence; documentatiecontrole; open gates; ownerbesluiten; reviewstatusGedrag: rapporteert ontbrekende evidence; zet niets op merge-ready

Templates in templates/claude-code/. Activatie per repository is een owner-besluit (DC-015).

Claude Code-automatisering

  • Subagents (.claude/agents)Gebruik: onafhankelijke AI-review en onderzoek met beperkte, alleen-lezende toolsGuardrail: geen schrijf- of shelltools voor reviewers; uitkomst is advies
  • Hooks (settings.json)Gebruik: kwaliteitschecks na wijziging en guards vóór commit/shellGuardrail: alleen rapporteren of blokkeren; nooit destructieve cleanup; activatie per repository vraagt owner-GO
  • AchtergrondtakenGebruik: lange builds/tests en CI-watch zonder te blokkerenGuardrail: geen deploy of merge op de achtergrond
  • Checkpoints / rewindGebruik: terug naar een eerdere stand in de sessie bij een fout padGuardrail: geen vervanging van git-historie; nooit gedeelde historie herschrijven
  • Context/handoff (compact, AI_HANDOFF)Gebruik: voortgang overdraagbaar houden tussen sessies en runsGuardrail: handoff in de repository is leidend, niet het sessiegeheugen
  • Hervatten (claude --continue / --resume)Gebruik: dezelfde sessie per werkstroom blijven gebruikenGuardrail: altijd eerst branch en HEAD controleren
  • Stopvoorwaarden in de opdrachtGebruik: agent stopt zelf bij escalatiecriteriaGuardrail: STOP DIRECT-lijst uit het escalatiebeleid zit in iedere gegenereerde opdracht

Escalatiebeleid

STOP DIRECT

  • onverwachte production-impact
  • destructieve Git-actie (force-push, history rewrite, reset --hard, clean -f)
  • blootstelling van secrets
  • werk dat een andere repository of werkstroom raakt (repository crossing)
  • irreversibele datawijziging
  • security-regressie
  • onverwacht ander deployment-target (bijv. production in plaats van preview)

WAITING_OWNER

  • productbesluit
  • architectuurwijziging
  • risicoacceptatie
  • production release
  • nieuwe externe afhankelijkheid
  • nieuwe repository of publieke blootstelling die niet vooraf is toegestaan

WAITING_EXTERNAL

  • onafhankelijke menselijke review
  • externe audit
  • juridische beoordeling
  • providerbesluit of -bevestiging

DOORWERKEN

  • tests
  • documentatie
  • remediation
  • evidence vastleggen
  • research
  • onafhankelijke, veilige voorbereidende taken