gsd-loop
A spec-build-review loop that turns foggy ideas into decision maps, contract-grade GitHub issues, pull requests, and reviewed code.
Use it when you want agents working a GitHub queue continuously while humans stay in control of every irreversible decision.
$ gsd-loop run --repo open-gsd/project
queue: 3 issues labeled gsd:ready
loop: discover → spec → build → review
Discover, spec, build, and review as four bounded passes over a labeled GitHub queue, with humans gating merges.
gsd-loop direction
gsd-loop is available now and expanding as the queue-driven surface for continuous agent work: richer discovery maps, stronger issue contracts, and tighter review gates.
Human-gated by design
Agents open and review pull requests but never merge or enable auto-merge. Irreversible calls stay yours.
Contract-grade issues
Discovery maps resolve open decisions before an issue is written, so build passes have a real contract to satisfy.
Crash-safe queues
State is reconstructed from git and GitHub labels rather than agent memory, with idle backoff when the queue runs dry.
The operating loop for gsd-loop.
- 01Discover: chart an uncertain effort and resolve its decisions.
- 02Spec: turn cleared plans into contract-grade GitHub issues.
- 03Build: work the gsd:ready queue into pull requests.
- 04Review: audit each PR against its issue contract and CI before you merge.