Madhura68
8d6bdef57e
Bundelt vier valkuilen in de huidige agent-flow: PBI-ordering, schema-conflicten bij parallelle migraties, branch-naam-collisies via 8-char suffix, cross-product orchestratie. Eerste is al gedekt door de merge-policy PBI; de andere drie zijn entries onder anchor-PBI "Agent-flow: openstaande beslissingen" (prio 4). Lokaal commit; PR pas wanneer er meer aanverwante docs-changes zijn. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.3 KiB
| title | status | audience | language | last_updated | when_to_read | |||
|---|---|---|---|---|---|---|---|---|
| Agent-flow: open issues & decision log | active |
|
nl | 2026-05-03 | When designing or auditing how the agent claims jobs and produces PRs across multiple stories, PBIs or products. |
Agent-flow: open issues & decision log
Deze runbook bundelt vier valkuilen in de huidige agent-flow waarover later
een bewuste beslissing moet vallen. Elk issue is óf gedekt door een
bestaande PBI óf gekoppeld aan een story onder de anchor-PBI
Agent-flow: openstaande beslissingen.
Status per issue is een van: open (nog geen besluit), decided (besluit
genomen, mitigatie volgt), mitigated (geïmplementeerd; story gesloten).
Promote een story naar een eigen prio-2 PBI zodra het issue acuut wordt.
1. PBI-ordering binnen één batch — decided
Probleem: in één batch kunnen jobs uit verschillende PBIs door elkaar
lopen, omdat wait_for_job FIFO claimt zonder PBI-grouping.
Status: gedekt door PBI Agent merge-policy: geen auto-merge, sequentieel per PBI. Daar wordt een gate ingebouwd
die voorkomt dat PBI B start zolang PBI A's PR nog open is.
Niet hier dupliceren.
2. Schema-conflict bij parallelle Prisma-migraties — open
Probleem: twee stories die elk een Prisma-migratie toevoegen krijgen elk een eigen migration-file met eigen timestamp. Mergen in willekeurige volgorde kan de schema-state inconsistent maken; oudere timestamps die ná nieuwere mergen geven Prisma-onverklaarbaar gedrag.
Mitigatie-opties: sequential-gating (#1 lost dit grotendeels op),
migration-rename CI-hook, geen agent-migrations toelaten, of
prisma migrate diff als CI-gate.
→ Story Schema-conflict tussen parallelle stories
3. Branch naam-collisie via 8-char-suffix — open
Probleem: feat/story-<last8-of-cuid> is geen garantie tegen
botsingen. Met genoeg stories wordt botskans niet-triviaal en de
worktree-create faalt of vermengt commits.
Mitigatie-opties: volledige cuid in branchnaam, Story.code als
branchnaam (bv. feat/ST-1115), suffix-lengte verhogen, of niets doen
en monitoren.
→ Story Branch naam-collisie via 8-char-suffix van story-id
4. Cross-product orchestratie — open
Probleem: een feature in twee producten (bv. tool in scrum4me-mcp + gebruik in Scrum4Me) heeft een dependency-volgorde die niet door het systeem wordt afgedwongen. Mergen in verkeerde volgorde breekt main.
Mitigatie-opties: mens-discipline + description-flag, Initiative-laag boven PBI (ADR-0010 optie C), gating per repo-pair, of "blocked-by"-tekstuele link.
→ Story Cross-product orchestratie: dependency-volgorde en mens-tussenstappen
Re-visit cadans
Bekijk dit document maandelijks of na elke significant agent-incident. Promote een story naar prio 2 zodra het issue concreet pijn doet.