update-superpowers

Upstream Superpowers Sync Workflow

Purpose: Sync modified skills with upstream superpowers while preserving spex enhancements.

Context: This command is for maintaining the cc-spex plugin, not for end users.

Safety Check

Before proceeding, verify we're in the plugin development directory:

# Check for plugin marker
if [ ! -f "spex/.superpowers-sync" ] || [ ! -f "spex/.claude-plugin/plugin.json" ]; then
  echo "ERROR: This command only works in cc-spex plugin directory"
  echo "Current directory: $(pwd)"
  exit 1
fi

# Verify we're in the right repo
if ! grep -q "cc-spex" spex/.claude-plugin/plugin.json 2>/dev/null; then
  echo "ERROR: This doesn't appear to be the cc-spex repository"
  exit 1
fi

echo "Plugin directory confirmed"

If checks fail, STOP and inform user this command is only for plugin maintenance.

Pre-Sync Preparation

1. Load Current Sync State

cat spex/.superpowers-sync

Extract:

• last_sync_commit: Last upstream commit we synced from
• modified_skills: Which skills are modified and how
• upstream_repo: Upstream repository URL

2. Clone/Update Upstream Repository

# Create temp directory
TEMP_DIR=$(mktemp -d)
cd "$TEMP_DIR"

# Clone upstream
git clone https://github.com/obra/superpowers superpowers-upstream
cd superpowers-upstream

# Get current HEAD
CURRENT_COMMIT=$(git rev-parse HEAD)
CURRENT_DATE=$(git log -1 --format=%cd --date=short)

echo "Upstream HEAD: $CURRENT_COMMIT ($CURRENT_DATE)"

3. Check What Changed

For each modified skill, get the diff:

LAST_SYNC=$(jq -r '.last_sync_commit' spex/.superpowers-sync)

# For each modified skill
for skill in writing-plans code-review verification-before-completion brainstorming; do
  UPSTREAM_FILE="skills/${skill}/SKILL.md"

  # Get changes since last sync
  if [ "$LAST_SYNC" != "INITIAL" ]; then
    echo "=== Changes to $skill ==="
    git log --oneline $LAST_SYNC..HEAD -- "$UPSTREAM_FILE"
    echo ""
  else
    echo "=== $skill (INITIAL SYNC) ==="
    echo "Will use current upstream version as baseline"
    echo ""
  fi
done