GoalBuddy Conveyor
Runs broad work as sequential child boards with one active child at a time.
strict
PR/CI gates
handoff before compact
Local Codex manager / worker control plane
Agent Conveyor
Turn broad Codex work into repeatable manager recipes: one manager supervises one worker through Dispatch, evidence gates, handoffs, and an auditable SQLite trail.
npm install -g agent-conveyor
conveyor manager-recipes --show goalbuddy-conveyor --json
conveyor pair --manager-recipe goalbuddy-conveyor ...
Manager
→
Dispatch
→
Worker
Manager
Selects a recipe, checks evidence, records decisions, and nudges only when the gate allows it.
Dispatch
Routes notifications, blocks unsafe continuations, records command attempts, and keeps delivery mechanical.
Worker
Implements one slice, returns receipts, consumes inbox messages, and hands off before context cleanup.
manager_configs
recipe + permissions
recipe + permissions
routed_notifications
delivery + consume state
delivery + consume state
acceptance_criteria
open + satisfied proof
open + satisfied proof
worker_handoffs
resume + cleanup receipts
resume + cleanup receipts
Five manager modes for the work agents actually do
The setup conversation can stay free-form, but before the manager starts it resolves to a named recipe or explicit custom mode. Each recipe has settings, permissions, evidence gates, and cleanup rules.
Test Coverage Loop
Improves or proves test confidence before another worker pass can begin.
strict
coverage receipt
adversarial check
UX Polish Loop
Iterates visible quality using screenshots, browser evidence, and visual diffs.
guided
playwright
visual threshold
Nudge / What's Next
Observes, negotiates criteria, and asks focused next-step questions without taking over.
guided
criteria negotiation
low risk
PR / CI / Merge Ralph Loop
Drives PR readiness, CI monitoring, green merge, handoff, and fresh-worker replay.
strict
green CI
merge receipt
From setup to supervision without losing the thread
Agent Conveyor makes the manager commit to a mode before it gets cut loose, then keeps every loop grounded in Dispatch and receipts.
conveyor manager-config "$TASK" --recipe goalbuddy-conveyor --mode strict
conveyor cycle "$TASK"
conveyor replay "$TASK"
1
Resolve the recipe
The manager turns free-form intent into `goalbuddy-conveyor`, `ux-polish-loop`, or `custom`.
2
Lock settings
Mode, objective, permissions, tools, epilogues, and cleanup policy are saved in SQLite.
3
Route through Dispatch
Notifications are delivered by push or inbox, with command attempts and side effects recorded.
4
Finish with proof
Completion needs receipts: tests, screenshots, CI, handoff, audit, or an explicit blocker.
The database is the product feedback loop
Recipe behavior is not hidden in chat memory. The control plane records enough state to replay a run, report a bug, and improve the recipes when dogfooding exposes a weak gate.
manager_configs
Recipe name, supervision mode, permissions, tools, epilogues, and ack policy.
commands
Manager requests, Dispatch claims, retries, blocks, and side-effect risk.
routed_notifications
Worker and manager messages, delivery mode, consumed state, and failures.
acceptance_criteria
Living criteria, deferred follow-ups, satisfied proof, and rejected scope.
manager_cycles
Observation history and the manager context used for each decision.
telemetry_events
Dispatch heartbeat, routing issues, stale work, and searchable issue clues.
Start with a recipe. Keep the receipts.
Agent Conveyor is for local, auditable supervision: a manager that can watch useful work, ask the next good question, and prove why it continued, stopped, compacted, or finished.