What problem does it solve?
Worker agents in a multi-agent colony need a durable, shared record of which tasks are claimed, which steps are done, and which required SOP gates remain, so work is not duplicated or skipped when agents race on a shared queue.
Core Features & Use Cases
- Atomic Task Claiming: Claim a pre-assigned task by ID or race for the next pending task using a single UPDATE statement, avoiding SELECT-then-UPDATE race conditions.
- Step Progress Tracking: Mark steps as in_progress or done with evidence, and skip already-completed steps so resumed work never repeats.
- SOP Gate Enforcement: Block task completion until all required sop_checklist rows are checked off, preventing premature success declarations.
- Use Case: A worker agent spawned with a db_path and task_id claims its row in the SQLite queue, executes each pending step while recording evidence, clears the required SOP gates, marks the task done, and loops to claim the next task until the queue is drained.
Quick Start
Claim your assigned task from the colony SQLite queue, record progress on each step, and verify all SOP gates before marking the task done.