diff --git a/docs/runbooks/branch-and-commit.md b/docs/runbooks/branch-and-commit.md index 3646620..09bf0da 100644 --- a/docs/runbooks/branch-and-commit.md +++ b/docs/runbooks/branch-and-commit.md @@ -59,6 +59,33 @@ Wanneer de NAS-agent (`/opt/agent/`) een batch jobs uitvoert: - Één PR per batch → één Vercel preview-deployment. - Single-task batch (1 job in queue): dezelfde flow — 1 commit → push + PR. +#### End-to-end verificatie: 1 batch = 1 Vercel-deploy + +Gebruik deze checklist om te verifiëren dat de batch-flow correct werkt na een agent-run: + +**Voorbereiding** +1. Seed ≥ 2 taken onder één story (bv. README-edits). +2. Trigger de batch via **"Voer alle uit"** op het Solo Board. +3. Wacht tot de agent alle jobs als `done` markeert. + +**GitHub-checks** +- [ ] Er is precies **één PR** aangemaakt voor de batch-branch. +- [ ] De PR bevat **één commit per taak** (geen squash, geen force-push). +- [ ] Er zijn **geen losse pushes** op de branch vóór de definitieve push (check via `git log --all --graph` of GitHub's "commits" tab). + +**Vercel-checks** +- [ ] In het Vercel-dashboard → **Deployments**: er is **exact één preview-deployment** voor de branch in het run-window. +- [ ] Geen extra "cancelled" of "building" deployments voor dezelfde branch uit hetzelfde tijdsvenster (zou wijzen op tussentijdse pushes). + +**Alternatieve verificatie via Vercel MCP** (indien beschikbaar): +``` +mcp____list_deployments + → filter op branchName = feat/ + → verwacht: 1 entry met state = READY of BUILDING +``` + +**Race-condition scenario**: als een nieuwe taak in de queue terechtkomt terwijl de agent de queue-check uitvoert, kan er een tweede push volgen. Dit is acceptabel — de tweede push triggert een tweede deployment voor de resterende commits. Documenteer dit afwijkend gedrag in de PR-description als het zich voordoet. + --- ## Plan Mode