Agent skill

specswarm-upgrade

Systematic compatibility analysis, migration guidance, and breaking change detection for dependency/framework upgrades. Auto-executes when user clearly wants to upgrade, update, migrate, or modernize software dependencies, frameworks, packages, or technology stacks.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/specswarm-upgrade-martybonacci-specswarm

SKILL.md

SpecSwarm Upgrade Workflow

Provides natural language access to /specswarm:upgrade command.

When to Invoke

Trigger this skill when the user mentions:

  • Upgrading or updating dependencies/packages
  • Migrating to new frameworks or versions
  • Modernizing technology stacks
  • Bumping version numbers

Examples:

  • "Upgrade React to version 19"
  • "Update all dependencies"
  • "Migrate from Webpack to Vite"
  • "Modernize the build system"
  • "Bump Node to version 20"

Instructions

Confidence-Based Execution:

  1. Detect that user mentioned upgrading/updating software

  2. Extract what to upgrade from their message

  3. Assess confidence and execute accordingly:

    High Confidence (95%+) - Auto-execute immediately:

    • Clear upgrade requests: "Upgrade React to version 19", "Update all dependencies", "Migrate from Webpack to Vite"
    • Action: Immediately run /specswarm:upgrade "upgrade description"
    • Show brief notification: "🎯 Running /specswarm:upgrade... (press Ctrl+C within 3s to cancel)"

    Medium Confidence (70-94%) - Ask for confirmation:

    • Less specific: "Update the packages", "Modernize the stack"
    • Action: Use AskUserQuestion tool with two options:
      • Option 1 (label: "Run /specswarm:upgrade"): Use SpecSwarm's upgrade workflow with compatibility analysis
      • Option 2 (label: "Process normally"): Handle as regular Claude Code request

    Low Confidence (<70%) - Always ask:

    • Vague: "Make it better", "Use newer stuff"
    • Action: Use AskUserQuestion as above
  4. If user cancels (Ctrl+C) or selects Option 2, process normally without SpecSwarm

  5. After command completes, STOP - do not continue with ship/merge

What the Upgrade Command Does

/specswarm:upgrade runs complete workflow:

  • Analyzes breaking changes and compatibility
  • Creates comprehensive upgrade plan
  • Generates migration tasks
  • Updates dependencies and code
  • Runs tests to verify compatibility
  • Documents upgrade process

Stops after upgrade is complete - does NOT merge/ship/deploy.

Semantic Understanding

This skill should trigger not just on exact keywords, but semantic equivalents:

Upgrade equivalents: upgrade, update, migrate, modernize, bump, move to, switch to, adopt Target terms: dependency, package, framework, library, version, technology stack

Example

User: "Upgrade React to version 19"

Didn't find tool you were looking for?

Be as detailed as possible for better results