Foreman
A terminal orchestrator that supervises headless Claude Code agents through a gated plan-to-merge pipeline, with human review at each design phase and guardrails the agents cannot bypass during the build.
Foreman spawns the locally installed claude CLI in headless stream-json mode, parses its event stream, enforces per-run turn, cost and time budgets, and drives a pipeline of plan, ADR or PRD, issues, TDD build and end-to-end testing. Human review gates sit at every design phase, with a hash-sealed approval that auto-reverts if the underlying document changes afterward.
All state is stored as human-readable files committed inside the target repository rather than in a database, so killing and restarting Foreman fully recovers from disk. Parallel workers each run in their own git worktree, gated by a declared set of files they may touch so they never collide, and a hook blocks workers from writing their own verification code. Every run is outcome-labeled, and a retrospective command clusters failures into gated skill or prompt patches that must pass a benchmark before they can land. It is driven from a keyboard-controlled terminal UI.