epic-start-worktree

Epic Start

Launch parallel agents to work on epic tasks in a shared worktree.

Usage

/pm:epic-start <epic_name>

Quick Check

1. Verify epic exists:

   test -f .claude/epics/$ARGUMENTS/epic.md || echo "❌ Epic not found. Run: /pm:prd-parse $ARGUMENTS"
   

2. Check GitHub sync: Look for github: field in epic frontmatter. If missing: "❌ Epic not synced. Run: /pm:epic-sync $ARGUMENTS first"

3. Check for worktree:

   git worktree list | grep "epic-$ARGUMENTS"
   

Instructions

1. Create or Enter Worktree

Follow /rules/worktree-operations.md:

# If worktree doesn't exist, create it
if ! git worktree list | grep -q "epic-$ARGUMENTS"; then
  git checkout main
  git pull origin main
  git worktree add ../epic-$ARGUMENTS -b epic/$ARGUMENTS
  echo "✅ Created worktree: ../epic-$ARGUMENTS"
else
  echo "✅ Using existing worktree: ../epic-$ARGUMENTS"
fi

2. Identify Ready Issues

Read all task files in .claude/epics/$ARGUMENTS/:

• Parse frontmatter for status, depends_on, parallel fields
• Check GitHub issue status if needed
• Build dependency graph

Categorize issues:

• Ready: No unmet dependencies, not started
• Blocked: Has unmet dependencies
• In Progress: Already being worked on
• Complete: Finished

3. Analyze Ready Issues

For each ready issue without analysis:

# Check for analysis
if ! test -f .claude/epics/$ARGUMENTS/{issue}-analysis.md; then
  echo "Analyzing issue #{issue}..."
  # Run analysis (inline or via Task tool)
fi

4. Launch Parallel Agents

For each ready issue with analysis:

## Starting Issue #{issue}: {title}

Reading analysis...
Found {count} parallel streams:
  - Stream A: {description} (Agent-{id})
  - Stream B: {description} (Agent-{id})

Launching agents in worktree: ../epic-$ARGUMENTS/

Use Task tool to launch each stream:

Task:
  description: "Issue #{issue} Stream {X}"
  subagent_type: "{agent_type}"
  prompt: |
    Working in worktree: ../epic-$ARGUMENTS/
    Issue: #{issue} - {title}
    Stream: {stream_name}

    Your scope:
    - Files: {file_patterns}
    - Work: {stream_description}

    Read full requirements from:
    - .claude/epics/$ARGUMENTS/{task_file}
    - .claude/epics/$ARGUMENTS/{issue}-analysis.md

    Follow coordination rules in /rules/agent-coordination.md

    Commit frequently with message format:
    "Issue #{issue}: {specific change}"

    Update progress in:
    .claude/epics/$ARGUMENTS/updates/{issue}/stream-{X}.md