74 lines
2.7 KiB
Markdown
74 lines
2.7 KiB
Markdown
---
|
|
name: specswarm-upgrade
|
|
description: 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.
|
|
allowed-tools: AskUserQuestion, SlashCommand
|
|
---
|
|
|
|
# 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" |