Batch Dev

Prerequisites

A Panel Todo sprint must exist with:

1. Sprint created with description (context, rules, file ownership)
2. Issues batch-created with tags and blocked_by references
3. Context docs referenced in sprint description

Set up via /sprint-planning before spinning up sessions.

Workflow Steps

Step 1: LOAD SPRINT

panelTodo_getSprint(sprintId="...")

Read the sprint description for context, file ownership rules, and agent mapping.

Step 2: FIND AVAILABLE WORK

panelTodo_listIssues(sprintId="...", assignee=null, isBlocked=false)

Returns issues that are unassigned AND unblocked (all dependencies completed).

Step 3: CLAIM THE ISSUE

panelTodo_updateIssue(issueId="...", assignee="session-1")

Step 4: READ CONTEXT

Load relevant context document from .claude/contexts/ before implementing.

Step 5: INVOKE AGENT

CRITICAL: Must invoke a specialized agent for code changes.

Step 6: COMPLETE AND MOVE ON

panelTodo_completeIssue(issueId="...")
// This may unblock other issues that had blocked_by this one

panelTodo_listIssues(sprintId="...", assignee=null, isBlocked=false)
// Claim next issue and repeat

Multi-Session Coordination

SESSION 1 (backend):                 SESSION 2 (frontend):
  /batch-dev                           /batch-dev
  Load sprint                          Load sprint
  listIssues(unassigned, unblocked)    listIssues(unassigned, unblocked)
  Claim PT-1 (create models)           Claim PT-4 (shared types)
  Invoke backend-engineer              Invoke frontend-engineer
  Complete PT-1                        Complete PT-4
  → PT-2, PT-3 now unblocked!         listIssues...
  Claim PT-2                           → PT-3 now available!
                                       Claim PT-3

Rules for parallel sessions

1. Always query before claiming — don't assume availability
2. Respect track ownership — follow sprint description assignments
3. Release on exit — set assignee back to null if you can't finish
4. Comment on handoffs — add comments explaining partial state

Sprint Setup Example

panelTodo_createSprint({
  name: "API Redesign Sprint",
  description: "File ownership:\n- track-backend: src/api/, src/models/\n- track-frontend: src/components/, src/hooks/"
})

panelTodo_batchCreateIssues({
  sprintId: "...",
  issues: [
    { title: "P1: New data models", priority: "high", tags: ["track-backend"], blocked_by: [] },
    { title: "P2: API endpoints", priority: "high", tags: ["track-backend"], blocked_by: ["PT-1"] },
    { title: "P3: UI components", priority: "medium", tags: ["track-frontend"], blocked_by: ["PT-2"] },
    { title: "P4: Shared types", priority: "high", tags: ["track-shared"], blocked_by: [] },
    { title: "P5: Integration tests", priority: "low", tags: ["track-backend", "track-frontend"], blocked_by: ["PT-2", "PT-3"] }
  ]
})

Enforcement

• Direct code edits BLOCKED (must use agents)
• Panel Todo required for coordination
• Tests should pass after each agent completes