Speculator Orchestration
Core Principle
Claim before you code.
Never start work on a task without atomically claiming it first. This prevents duplicate effort and merge conflicts in multi-agent scenarios.
Quick Reference
| Command | Purpose |
|---|---|
spec tasks ready | Find tasks available for work (todo, unblocked, dependencies complete) |
spec task claim <id> | Atomically claim a task (marks as in_progress) |
spec task complete <id> | Mark a task as done |
spec task block <id> --reason <reason> | Record a blocker with reason |
spec task unblock <id> | Remove a block |
spec task release <id> | Return a claimed task to todo |
spec task add --feature <id> --title <title> | Create a new task or subtask |
spec task depend <id> --on <other-id> | Add a dependency between tasks |
Workflows
- •Claiming Tasks - How to find and claim work
- •Completing Tasks - When and how to mark work done
- •Blocking Tasks - When and how to record blockers
Patterns
- •Parallelization - Which tasks can run concurrently
- •Decomposition - Breaking large tasks into subtasks
Examples
- •Multi-Agent Session - Two agents working concurrently
The Orchestration Loop
code
1. spec tasks ready → find available work 2. Evaluate conflicts → check for file overlap with other in-progress tasks 3. spec task claim <id> → atomically claim 4. Implement → do the work 5. spec task complete <id> | spec task block <id> --reason <reason> → finish or record blocker 6. Repeat
Important Notes
- •Always check
spec tasks readybefore starting work - •If claim fails, another agent got it first - move on
- •Block tasks with clear, actionable reasons
- •Release tasks if you can't complete them
- •Create subtasks for large pieces of work