scopes: Command for Claude Code

Issue Close

Mark an issue as complete and close it on GitHub.

Usage

/pm:issue-close <issue_number> [completion_notes]

Instructions

1. Find Local Task File

First check if .claude/epics/*/$ARGUMENTS.md exists (new naming). If not found, search for task file with github:.*issues/$ARGUMENTS in frontmatter (old naming). If not found: "❌ No local task for issue #$ARGUMENTS"

2. Update Local Status

Get current datetime: date -u +"%Y-%m-%dT%H:%M:%SZ"

Update task file frontmatter:

status: closed
updated: {current_datetime}

3. Update Progress File

If progress file exists at .claude/epics/{epic}/updates/$ARGUMENTS/progress.md:

• Set completion: 100%
• Add completion note with timestamp
• Update last_sync with current datetime

4. Close on GitHub

Add completion comment and close:

# Add final comment
echo "✅ Task completed

$ARGUMENTS

---
Closed at: {timestamp}" | gh issue comment $ARGUMENTS --body-file -

# Close the issue
gh issue close $ARGUMENTS

5. Update Epic Task List on GitHub

Check the task checkbox in the epic issue:

# Get epic name from local task file path
epic_name={extract_from_path}

# Get epic issue number from epic.md
epic_issue=$(grep 'github:' .claude/epics/$epic_name/epic.md | grep -oE '[0-9]+$')

if [ ! -z "$epic_issue" ]; then
  # Get current epic body
  gh issue view $epic_issue --json body -q .body > /tmp/epic-body.md
  
  # Check off this task
  sed -i "s/- \[ \] #$ARGUMENTS/- [x] #$ARGUMENTS/" /tmp/epic-body.md
  
  # Update epic issue
  gh issue edit $epic_issue --body-file /tmp/epic-body.md
  
  echo "✓ Updated epic progress on GitHub"
fi

6. Update Epic Progress

• Count total tasks in epic
• Count closed tasks
• Calculate new progress percentage
• Update epic.md frontmatter progress field

7. Output

✅ Closed issue #$ARGUMENTS
  Local: Task marked complete
  GitHub: Issue closed & epic updated
  Epic progress: {new_progress}% ({closed}/{total} tasks complete)
  
Next: Run /pm:next for next priority task