claude-autopm 2.8.1 → 2.8.2

package/autopm/.claude/commands/pm/epic-sync-original.md

@@ -1,473 +0,0 @@
----
-allowed-tools: Bash, Read, Write, LS, Task
----
-
-# Epic Sync
-
-Push epic and tasks to GitHub as issues.
-
-## Usage
-```
-/pm:epic-sync <feature_name>
-```
-
-## Required Documentation Access
-
-**MANDATORY:** Before project management workflows, query Context7 for best practices:
-
-**Documentation Queries:**
-- `mcp://context7/agile/epic-management` - epic management best practices
-- `mcp://context7/project-management/issue-tracking` - issue tracking best practices
-- `mcp://context7/agile/task-breakdown` - task breakdown best practices
-- `mcp://context7/project-management/workflow` - workflow best practices
-
-**Why This is Required:**
-- Ensures adherence to current industry standards and best practices
-- Prevents outdated or incorrect implementation patterns
-- Provides access to latest framework/tool documentation
-- Reduces errors from stale knowledge or assumptions
-
-
-## Quick Check
-
-```bash
-# Verify epic exists
-test -f .claude/epics/$ARGUMENTS/epic.md || echo "❌ Epic not found. Run: /pm:prd-parse $ARGUMENTS"
-
-# Count task files
-ls .claude/epics/$ARGUMENTS/*.md 2>/dev/null | grep -v epic.md | wc -l
-```
-
-If no tasks found: "❌ No tasks to sync. Run: /pm:epic-decompose $ARGUMENTS"
-
-## Instructions
-
-### 0. Check Remote Repository
-
-Follow `/rules/github-operations.md` to ensure we're not syncing to the AutoPM template:
-
-```bash
-# Check if remote origin is the AutoPM template repository
-remote_url=$(git remote get-url origin 2>/dev/null || echo "")
-if [[ "$remote_url" == *"rlagowski/autopm"* ]] || [[ "$remote_url" == *"rlagowski/autopm.git"* ]]; then
-  echo "❌ ERROR: You're trying to sync with the AutoPM template repository!"
-  echo ""
-  echo "This repository (rlagowski/autopm) is a template for others to use."
-  echo "You should NOT create issues or PRs here."
-  echo ""
-  echo "To fix this:"
-  echo "1. Fork this repository to your own GitHub account"
-  echo "2. Update your remote origin:"
-  echo "   git remote set-url origin https://github.com/YOUR_USERNAME/YOUR_REPO.git"
-  echo ""
-  echo "Or if this is a new project:"
-  echo "1. Create a new repository on GitHub"
-  echo "2. Update your remote origin:"
-  echo "   git remote set-url origin https://github.com/YOUR_USERNAME/YOUR_REPO.git"
-  echo ""
-  echo "Current remote: $remote_url"
-  exit 1
-fi
-```
-
-### 1. Create Epic Issue
-
-Strip frontmatter and prepare GitHub issue body:
-```bash
-# Extract content without frontmatter
-sed '1,/^---$/d; 1,/^---$/d' .claude/epics/$ARGUMENTS/epic.md > /tmp/epic-body-raw.md
-
-# Remove "## Tasks Created" section and replace with Stats
-awk '
-  /^## Tasks Created/ {
-    in_tasks=1
-    next
-  }
-  /^## / && in_tasks {
-    in_tasks=0
-    # When we hit the next section after Tasks Created, add Stats
-    if (total_tasks) {
-      print "## Stats\n"
-      print "Total tasks: " total_tasks
-      print "Parallel tasks: " parallel_tasks " (can be worked on simultaneously)"
-      print "Sequential tasks: " sequential_tasks " (have dependencies)"
-      if (total_effort) print "Estimated total effort: " total_effort " hours"
-      print ""
-    }
-  }
-  /^Total tasks:/ && in_tasks { total_tasks = $3; next }
-  /^Parallel tasks:/ && in_tasks { parallel_tasks = $3; next }
-  /^Sequential tasks:/ && in_tasks { sequential_tasks = $3; next }
-  /^Estimated total effort:/ && in_tasks {
-    gsub(/^Estimated total effort: /, "")
-    total_effort = $0
-    next
-  }
-  !in_tasks { print }
-  END {
-    # If we were still in tasks section at EOF, add stats
-    if (in_tasks && total_tasks) {
-      print "## Stats\n"
-      print "Total tasks: " total_tasks
-      print "Parallel tasks: " parallel_tasks " (can be worked on simultaneously)"
-      print "Sequential tasks: " sequential_tasks " (have dependencies)"
-      if (total_effort) print "Estimated total effort: " total_effort
-    }
-  }
-' /tmp/epic-body-raw.md > /tmp/epic-body.md
-
-# Determine epic type (feature vs bug) from content
-if grep -qi "bug\|fix\|issue\|problem\|error" /tmp/epic-body.md; then
-  epic_type="bug"
-else
-  epic_type="feature"
-fi
-
-# Create epic issue with labels
-epic_number=$(gh issue create \
-  --title "Epic: $ARGUMENTS" \
-  --body-file /tmp/epic-body.md \
-  --label "epic,epic:$ARGUMENTS,$epic_type" \
-  --json number -q .number)
-```
-
-Store the returned issue number for epic frontmatter update.
-
-### 2. Create Task Sub-Issues
-
-Check if gh-sub-issue is available:
-```bash
-if gh extension list | grep -q "yahsan2/gh-sub-issue"; then
-  use_subissues=true
-else
-  use_subissues=false
-  echo "⚠️ gh-sub-issue not installed. Using fallback mode."
-fi
-```
-
-Count task files to determine strategy:
-```bash
-task_count=$(ls .claude/epics/$ARGUMENTS/[0-9][0-9][0-9].md 2>/dev/null | wc -l)
-```
-
-### For Small Batches (< 5 tasks): Sequential Creation
-
-```bash
-if [ "$task_count" -lt 5 ]; then
-  # Create sequentially for small batches
-  for task_file in .claude/epics/$ARGUMENTS/[0-9][0-9][0-9].md; do
-    [ -f "$task_file" ] || continue
-
-    # Extract task name from frontmatter
-    task_name=$(grep '^name:' "$task_file" | sed 's/^name: *//')
-
-    # Strip frontmatter from task content
-    sed '1,/^---$/d; 1,/^---$/d' "$task_file" > /tmp/task-body.md
-
-    # Create sub-issue with labels
-    if [ "$use_subissues" = true ]; then
-      task_number=$(gh sub-issue create \
-        --parent "$epic_number" \
-        --title "$task_name" \
-        --body-file /tmp/task-body.md \
-        --label "task,epic:$ARGUMENTS" \
-        --json number -q .number)
-    else
-      task_number=$(gh issue create \
-        --title "$task_name" \
-        --body-file /tmp/task-body.md \
-        --label "task,epic:$ARGUMENTS" \
-        --json number -q .number)
-    fi
-
-    # Record mapping for renaming
-    echo "$task_file:$task_number" >> /tmp/task-mapping.txt
-  done
-
-  # After creating all issues, update references and rename files
-  # This follows the same process as step 3 below
-fi
-```
-
-### For Larger Batches: Parallel Creation
-
-```bash
-if [ "$task_count" -ge 5 ]; then
-  echo "Creating $task_count sub-issues in parallel..."
-
-  # Check if gh-sub-issue is available for parallel agents
-  if gh extension list | grep -q "yahsan2/gh-sub-issue"; then
-    subissue_cmd="gh sub-issue create --parent $epic_number"
-  else
-    subissue_cmd="gh issue create"
-  fi
-
-  # Batch tasks for parallel processing
-  # Spawn agents to create sub-issues in parallel with proper labels
-  # Each agent must use: --label "task,epic:$ARGUMENTS"
-fi
-```
-
-Use Task tool for parallel creation:
-```yaml
-Task:
-  description: "Create GitHub sub-issues batch {X}"
-  subagent_type: "general-purpose"
-  prompt: |
-    Create GitHub sub-issues for tasks in epic $ARGUMENTS
-    Parent epic issue: #$epic_number
-
-    Tasks to process:
-    - {list of 3-4 task files}
-
-    For each task file:
-    1. Extract task name from frontmatter
-    2. Strip frontmatter using: sed '1,/^---$/d; 1,/^---$/d'
-    3. Create sub-issue using:
-       - If gh-sub-issue available:
-         gh sub-issue create --parent $epic_number --title "$task_name" \
-           --body-file /tmp/task-body.md --label "task,epic:$ARGUMENTS"
-       - Otherwise:
-         gh issue create --title "$task_name" --body-file /tmp/task-body.md \
-           --label "task,epic:$ARGUMENTS"
-    4. Record: task_file:issue_number
-
-    IMPORTANT: Always include --label parameter with "task,epic:$ARGUMENTS"
-
-    Return mapping of files to issue numbers.
-```
-
-Consolidate results from parallel agents:
-```bash
-# Collect all mappings from agents
-cat /tmp/batch-*/mapping.txt >> /tmp/task-mapping.txt
-
-# IMPORTANT: After consolidation, follow step 3 to:
-# 1. Build old->new ID mapping
-# 2. Update all task references (depends_on, conflicts_with)
-# 3. Rename files with proper frontmatter updates
-```
-
-### 3. Rename Task Files and Update References
-
-First, build a mapping of old numbers to new issue IDs:
-```bash
-# Create mapping from old task numbers (001, 002, etc.) to new issue IDs
-> /tmp/id-mapping.txt
-while IFS=: read -r task_file task_number; do
-  # Extract old number from filename (e.g., 001 from 001.md)
-  old_num=$(basename "$task_file" .md)
-  echo "$old_num:$task_number" >> /tmp/id-mapping.txt
-done < /tmp/task-mapping.txt
-```
-
-Then rename files and update all references:
-```bash
-# Process each task file
-while IFS=: read -r task_file task_number; do
-  new_name="$(dirname "$task_file")/${task_number}.md"
-
-  # Read the file content
-  content=$(cat "$task_file")
-
-  # Update depends_on and conflicts_with references
-  while IFS=: read -r old_num new_num; do
-    # Update arrays like [001, 002] to use new issue numbers
-    content=$(echo "$content" | sed "s/\b$old_num\b/$new_num/g")
-  done < /tmp/id-mapping.txt
-
-  # Write updated content to new file
-  echo "$content" > "$new_name"
-
-  # Remove old file if different from new
-  [ "$task_file" != "$new_name" ] && rm "$task_file"
-
-  # Update github field in frontmatter
-  # Add the GitHub URL to the frontmatter
-  repo=$(gh repo view --json nameWithOwner -q .nameWithOwner)
-  github_url="https://github.com/$repo/issues/$task_number"
-
-  # Update frontmatter with GitHub URL and current timestamp
-  current_date=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-  # Use sed to update the github and updated fields
-  sed -i.bak "/^github:/c\github: $github_url" "$new_name"
-  sed -i.bak "/^updated:/c\updated: $current_date" "$new_name"
-  rm "${new_name}.bak"
-done < /tmp/task-mapping.txt
-```
-
-### 4. Update Epic with Task List (Fallback Only)
-
-If NOT using gh-sub-issue, add task list to epic:
-
-```bash
-if [ "$use_subissues" = false ]; then
-  # Get current epic body
-  gh issue view {epic_number} --json body -q .body > /tmp/epic-body.md
-
-  # Append task list
-  cat >> /tmp/epic-body.md << 'EOF'
-
-  ## Tasks
-  - [ ] #{task1_number} {task1_name}
-  - [ ] #{task2_number} {task2_name}
-  - [ ] #{task3_number} {task3_name}
-  EOF
-
-  # Update epic issue
-  gh issue edit {epic_number} --body-file /tmp/epic-body.md
-fi
-```
-
-With gh-sub-issue, this is automatic!
-
-### 5. Update Epic File
-
-Update the epic file with GitHub URL, timestamp, and real task IDs:
-
-#### 5a. Update Frontmatter
-```bash
-# Get repo info
-repo=$(gh repo view --json nameWithOwner -q .nameWithOwner)
-epic_url="https://github.com/$repo/issues/$epic_number"
-current_date=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-# Update epic frontmatter
-sed -i.bak "/^github:/c\github: $epic_url" .claude/epics/$ARGUMENTS/epic.md
-sed -i.bak "/^updated:/c\updated: $current_date" .claude/epics/$ARGUMENTS/epic.md
-rm .claude/epics/$ARGUMENTS/epic.md.bak
-```
-
-#### 5b. Update Tasks Created Section
-```bash
-# Create a temporary file with the updated Tasks Created section
-cat > /tmp/tasks-section.md << 'EOF'
-## Tasks Created
-EOF
-
-# Add each task with its real issue number
-for task_file in .claude/epics/$ARGUMENTS/[0-9]*.md; do
-  [ -f "$task_file" ] || continue
-
-  # Get issue number (filename without .md)
-  issue_num=$(basename "$task_file" .md)
-
-  # Get task name from frontmatter
-  task_name=$(grep '^name:' "$task_file" | sed 's/^name: *//')
-
-  # Get parallel status
-  parallel=$(grep '^parallel:' "$task_file" | sed 's/^parallel: *//')
-
-  # Add to tasks section
-  echo "- [ ] #${issue_num} - ${task_name} (parallel: ${parallel})" >> /tmp/tasks-section.md
-done
-
-# Add summary statistics
-total_count=$(ls .claude/epics/$ARGUMENTS/[0-9]*.md 2>/dev/null | wc -l)
-parallel_count=$(grep -l '^parallel: true' .claude/epics/$ARGUMENTS/[0-9]*.md 2>/dev/null | wc -l)
-sequential_count=$((total_count - parallel_count))
-
-cat >> /tmp/tasks-section.md << EOF
-
-Total tasks: ${total_count}
-Parallel tasks: ${parallel_count}
-Sequential tasks: ${sequential_count}
-EOF
-
-# Replace the Tasks Created section in epic.md
-# First, create a backup
-cp .claude/epics/$ARGUMENTS/epic.md .claude/epics/$ARGUMENTS/epic.md.backup
-
-# Use awk to replace the section
-awk '
-  /^## Tasks Created/ {
-    skip=1
-    while ((getline line < "/tmp/tasks-section.md") > 0) print line
-    close("/tmp/tasks-section.md")
-  }
-  /^## / && !/^## Tasks Created/ { skip=0 }
-  !skip && !/^## Tasks Created/ { print }
-' .claude/epics/$ARGUMENTS/epic.md.backup > .claude/epics/$ARGUMENTS/epic.md
-
-# Clean up
-rm .claude/epics/$ARGUMENTS/epic.md.backup
-rm /tmp/tasks-section.md
-```
-
-### 6. Create Mapping File
-
-Create `.claude/epics/$ARGUMENTS/github-mapping.md`:
-```bash
-# Create mapping file
-cat > .claude/epics/$ARGUMENTS/github-mapping.md << EOF
-# GitHub Issue Mapping
-
-Epic: #${epic_number} - https://github.com/${repo}/issues/${epic_number}
-
-Tasks:
-EOF
-
-# Add each task mapping
-for task_file in .claude/epics/$ARGUMENTS/[0-9]*.md; do
-  [ -f "$task_file" ] || continue
-
-  issue_num=$(basename "$task_file" .md)
-  task_name=$(grep '^name:' "$task_file" | sed 's/^name: *//')
-
-  echo "- #${issue_num}: ${task_name} - https://github.com/${repo}/issues/${issue_num}" >> .claude/epics/$ARGUMENTS/github-mapping.md
-done
-
-# Add sync timestamp
-echo "" >> .claude/epics/$ARGUMENTS/github-mapping.md
-echo "Synced: $(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> .claude/epics/$ARGUMENTS/github-mapping.md
-```
-
-### 7. Create Branch
-
-Follow `/rules/git-strategy.md` to create development branch:
-
-```bash
-# Ensure main is current
-git checkout main
-git pull origin main
-
-# Create branch for epic
-git checkout -b epic/$ARGUMENTS
-git push -u origin epic/$ARGUMENTS
-
-echo "✅ Created branch: epic/$ARGUMENTS"
-```
-
-### 8. Output
-
-```
-✅ Synced to GitHub
-  - Epic: #{epic_number} - {epic_title}
-  - Tasks: {count} sub-issues created
-  - Labels applied: epic, task, epic:{name}
-  - Files renamed: 001.md → {issue_id}.md
-  - References updated: depends_on/conflicts_with now use issue IDs
-  - Branch: epic/$ARGUMENTS
-
-Next steps:
-  - Start parallel execution: /pm:epic-start $ARGUMENTS
-  - Or work on single issue: /pm:issue-start {issue_number}
-  - View epic: https://github.com/{owner}/{repo}/issues/{epic_number}
-```
-
-## Error Handling
-
-Follow `/rules/github-operations.md` for GitHub CLI errors.
-
-If any issue creation fails:
-- Report what succeeded
-- Note what failed
-- Don't attempt rollback (partial sync is fine)
-
-## Important Notes
-
-- Trust GitHub CLI authentication
-- Don't pre-check for duplicates
-- Update frontmatter only after successful creation
-- Keep operations simple and atomic