Ik wil een bug of feature implementeren
Van issue naar merge request. Spexso isoleert je werk in een worktree en dwingt TDD af.
Steps
Start het issue (moet in
stage::specof later staan):/spexso-start 42WARNING
Issues in
stage::opportunityworden geblokkeerd. Gebruik eerst/spexso-brainstormom een spec te maken.Open blockers?
Als het issue een blocker heeft die nog open staat (niet gemerged, niet gesloten), waarschuwt
/spexso-start:⚠ Issue #42 is blocked by: #38 'XSUAA setup' (stage::build, state: opened) Suggestion: start a blocker first → /spexso-start 38In pilot/copilot kies je zelf of je doorgaat. In
--yolois dit een hard block (gelijk aan marathon-gedrag).Kies een modus:
Modus Wat gebeurt er Wanneer gebruiken yolo Volledig autonoom, geen gates Solide specs, greenfield pilot Plan-approval + test-review checkpoints Aanbevolen default copilot Elke stap vraagt goedkeuring Nieuw in het team, complex Plan de taken (automatisch in yolo):
/spexso-planBouw met TDD — tests eerst, dan implementatie. Onafhankelijke taken draaien in waves:
npx spexso wavesgroepeert taken zonder gedeelde bestanden of onderlinge dependencies, en per wave worden alle testers tegelijk gestart (parallelle RED —parallel.redin.spexso/config.json, standaard aan), daarna alle builders (parallelle GREEN —parallel.green, ook standaard aan). Verificatie en commits blijven per taak sequentieel:/spexso-buildTwee code-enforced safety rails
Na 3 mislukte pogingen op een taak stopt de build en escaleert naar jou. Overschrijdt een taak zijn tijdsbudget (
budgets.perTaskMinutes, standaard 30 min), dan stopt de build ook — check dannpx spexso observe reportvoor de latency-uitsplitsing (wall clock, subagent hops, testruns).Review de code:
/spexso-reviewFinish — push, merge en post de test checklist:
/spexso-finishSpexso pusht de branch, maakt een MR aan, en merget automatisch in de geconfigureerde target branch (
targetBranchin.spexso/config.json). Na de merge krijgt het issue labelstage::ship+needs::manual-testen wordt er een test checklist op het issue gepost.Merge conflict?
Als de auto-merge faalt, probeert Spexso automatisch een rebase. Als dat ook mislukt, krijgt het issue label
needs::conflict-resolutionen moet je manueel resolven in GitLab.
WARNING
Elke stap werkt in een geïsoleerde git worktree. Je main branch blijft onaangeraakt.
Tips
- Gebruik pilot als je twijfelt over de modus
- Check
npx spexso statusom te zien wat er in progress is /spexso-finishmerget automatisch, ververst de debt ledger (.spexso/debt.md), post een test checklist op het issue, schrijft een learning card naardocs/learning/, schrijft CHANGELOG en ruimt de worktree op- Na de merge staat het issue in
stage::shipmet labelneeds::manual-test— verwijder dit label manueel in GitLab na je tests