Mark as Blocked
Mark an expedition as blocked with a clear reason so other agents know why and who can help.
Required Arguments
- •
EXP-XXX- The expedition ID to block - •
reason- Why it's blocked (quote if multiple words)
Optional Arguments
- •
--unblock-by agent-X- Which agent can unblock this
Steps
1. Move to Blocked Status
bash
yurtle-kanban move EXP-XXX blocked
2. Update Expedition File
Add a blocked section to the expedition file:
Find the expedition file and add after the frontmatter:
markdown
> **BLOCKED**: [reason] > **Since:** YYYY-MM-DD > **Can unblock:** [agent-X or "anyone"]
Also add a Ship's Log entry:
markdown
### YYYY-MM-DD: BLOCKED **Reason:** [reason] **Can unblock:** [who] **Context:** [any additional context]
3. Commit and Push
bash
git add kanban-work/expeditions/EXP-XXX*.md git commit -m "blocked(exp-XXX): [short reason] Co-Authored-By: Claude <noreply@anthropic.com>" git push origin HEAD
4. Confirm Block
Show:
- •Current blocked items count
- •Who can unblock
- •Suggest notifying the unblocking agent
Common Block Reasons
| Reason | Who Can Unblock |
|---|---|
| "Waiting for GPU training to complete" | agent-a, agent-c |
| "Needs architecture decision" | agent-b, agent-d, captain |
| "Waiting for PR review" | any agent |
| "Blocked by EXP-XXX" | whoever finishes that expedition |
| "Needs Captain input" | captain |
| "External dependency" | depends |
Unblocking
When you unblock an item:
- •Remove the
> **BLOCKED**section from the file - •Add Ship's Log entry: "Unblocked: [what changed]"
- •Move status:
yurtle-kanban move EXP-XXX in_progress