| name | track-task-setup |
| description | Set up a track task before implementation — create task, description, register repos, add TODOs and links. Assumes agent-skill-jj for jj-task repo init and workspace creation. Use when workflow.phase is setup. |
| license | MIT |
| compatibility | Requires track CLI and jj-task (agent-skill-jj) |
| metadata | {"author":"track","version":"3.1.0","tags":["track","setup","planning","todo","repo"]} |
Track — Task Setup
Prepare what to build. JJ workspaces are created later via jj-task (see track-task-execute and $jj).
When to use
workflow.phase is setup- User asks to create, plan, or scaffold a track task
Outcome checklist
- Task with name (ticket/alias recommended)
- Registered repo(s)
- TODO list (one jj-task workspace per task;
--no-workspace for research TODOs)
track alias set <slug> when ticket ID is not a good jj-task slug
Workflow
1. Create task
track new "Implement OAuth" --ticket PROJ-123 --ticket-url https://...
track alias set oauth-login
2. Describe scope
track desc "Acceptance criteria, constraints, links"
3. Register repository
track repo add
4. Initialize jj-task (once per repo)
From the main workspace (repo root):
jj git init --colocate
jj-task repo init
5. Add TODOs
track todo add "Implement token refresh"
track todo add "Compare providers" --no-workspace
track todo add "Add integration tests"
One jj-task workspace covers all code TODOs sequentially.
6. Review
track status --json
Check jj.slug and workflow.phase.
7. Hand off
Switch to track-task-execute → jj-task start <jj.slug>.
jj.slug derivation
| Priority | Source | Example slug |
|---|
| 1 | alias | oauth-login |
| 2 | ticket_id | proj-123 |
| 3 | task id | task-42 |
Next step
track-task-execute — setup-workflow.md
