Create New Expedition
Create a new expedition with properly allocated ID to prevent conflicts between agents.
Steps
1. Allocate ID
CRITICAL: Always allocate the ID first to prevent duplicates:
bash
yurtle-kanban next-id EXP --json
This atomically allocates the next available ID (e.g., EXP-720).
2. Create Expedition File
Create kanban-work/expeditions/EXP-XXX-Title.md with this template:
yaml
--- yurtle: v1.3 id: EXP-XXX type: expedition title: "EXP-XXX: $ARGUMENTS" status: ready priority: MEDIUM created: YYYY-MM-DD assignee: TBD tags: [] depends_on: [] --- # EXP-XXX: $ARGUMENTS ## Problem Statement [What problem does this solve?] ## Solution [High-level approach] ## Build Steps ### Phase 1: [Name] [Steps to implement] ## Success Criteria - [ ] [Criterion 1] - [ ] [Criterion 2] ## Files to Modify | File | Action | Description | |------|--------|-------------| | path/to/file | Create/Modify | What changes | ## Ship's Log ### YYYY-MM-DD: Expedition Created [Initial context and decision] ## Related - [Related doc](path)
3. IMMEDIATELY Commit and Push
CRITICAL: Push the expedition file immediately to prevent conflicts:
bash
git add kanban-work/expeditions/EXP-XXX-*.md git commit -m "feat(kanban): create EXP-XXX expedition" git push
The next-id command only reserves the ID. If you don't push the file, other agents won't see it and may create conflicting work.
4. Update Kanban Status
Explicitly set the kanban status so other agents can see it:
bash
yurtle-kanban move EXP-XXX ready
5. Confirm Creation
Show the created expedition and suggest next steps:
- •Review and fill in details
- •Set priority and assignee
- •Add dependencies if any
- •Run
/work EXP-XXXto start working on it