orchestrate

Orchestrate Command

Scaffolding layer for parallel streams. Agent dispatch is handled by the harness, not by this command.

/orchestrate generate  # Create PRD + stream tasks via @agent-ta
/orchestrate start     # Validate streams, check conflicts, create worktrees, print dispatch cmds
/orchestrate status    # Show stream progress + live sessions
/orchestrate merge     # Merge completed worktrees back to main branch

---

generate (default if no subcommand)

Creates PRD and tasks with stream metadata. Prompt user for feature description if not provided.

1. Invoke @agent-ta to design architecture and return structured JSON:

{
  "prd": { "title": "...", "description": "...", "content": "# PRD..." },
  "tasks": [{
    "title": "...", "description": "...",
    "metadata": {
      "streamId": "Stream-A", "streamName": "Foundation",
      "files": ["src/auth.ts"], "dependencies": []
    }
  }]
}

1. Parse JSON, validate (no cycles, at least one task with dependencies: [])
2. Persist real rows for start: tc prd create --title "..." --description "..." --json (capture <prd-id>); per unique streamId, tc stream create --name "<streamName>" --prd <prd-id> --json (capture the numeric id); then per task, tc task create --title "..." --prd <prd-id> --stream <numeric-id> --description "..." --metadata '<json>' --json. Skipping --stream/--metadata leaves tc stream conflicts and tc task list --stream <id> empty.
3. Display plan summary and ask user to approve

---

start

Validates streams, checks for real file conflicts, creates an isolated git worktree per ready stream, and prints exact dispatch commands (claude --bg or tc worker).

1. tc stream list --json -- stop if no streams (tell user to run generate first)
2. Preflight: confirm tc is on PATH, you're inside a git repo, and the working tree is clean
3. tc stream conflicts --json (hard precondition) -- non-zero exit means a file is claimed by multiple streams. Report the conflicts; stop before creating worktrees.
4. For each stream whose dependencies are all satisfied, create an isolated worktree:

   git worktree add .worktrees/<stream-id> -b stream/<stream-id>
   

5. Print one dispatch command per ready stream; each agent works in .worktrees/<stream-id> on that stream's tasks (tc task list --stream <stream-id> --json):