scopes: Command for Claude Code

Sync

Full bidirectional sync between local and GitHub.

Usage

/pm:sync [epic_name]

If epic_name provided, sync only that epic. Otherwise sync all.

Instructions

1. Pull from GitHub

Get current state of all issues:

# Get all epic and task issues
gh issue list --label "epic" --limit 1000 --json number,title,state,body,labels,updatedAt
gh issue list --label "task" --limit 1000 --json number,title,state,body,labels,updatedAt

2. Update Local from GitHub

For each GitHub issue:

• Find corresponding local file by issue number
• Compare states:
  • If GitHub state newer (updatedAt > local updated), update local
  • If GitHub closed but local open, close local
  • If GitHub reopened but local closed, reopen local
• Update frontmatter to match GitHub state

3. Push Local to GitHub

For each local task/epic:

• If has GitHub URL but GitHub issue not found, it was deleted - mark local as archived
• If no GitHub URL, create new issue (like epic-sync)
• If local updated > GitHub updatedAt, push changes:

  gh issue edit {number} --body-file {local_file}
  

4. Handle Conflicts

If both changed (local and GitHub updated since last sync):

• Show both versions
• Ask user: "Local and GitHub both changed. Keep: (local/github/merge)?"
• Apply user's choice

5. Update Sync Timestamps

Update all synced files with last_sync timestamp.

6. Output

🔄 Sync Complete

Pulled from GitHub:
  Updated: {count} files
  Closed: {count} issues
  
Pushed to GitHub:
  Updated: {count} issues
  Created: {count} new issues
  
Conflicts resolved: {count}

Status:
  ✅ All files synced
  {or list any sync failures}

Important Notes

Follow /rules/github-operations.md for GitHub commands. Follow /rules/frontmatter-operations.md for local updates. Always backup before sync in case of issues.