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

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:

> **BLOCKED**: [reason]
> **Since:** YYYY-MM-DD
> **Can unblock:** [agent-X or "anyone"]

Also add a Ship's Log entry:

### YYYY-MM-DD: BLOCKED

**Reason:** [reason]
**Can unblock:** [who]
**Context:** [any additional context]

3. Commit and Push

git add kanban-work/expeditions/EXP-XXX*.md
git commit -m "blocked(exp-XXX): [short reason]

Co-Authored-By: Claude <[email protected]>"
git push origin HEAD

4. Confirm Block

Show:

• Current blocked items count
• Who can unblock
• Suggest notifying the unblocking agent

Common Block Reasons

Unblocking

When you unblock an item:

1. Remove the > **BLOCKED** section from the file
2. Add Ship's Log entry: "Unblocked: [what changed]"
3. Move status: yurtle-kanban move EXP-XXX in_progress