SpecSwarm Modify Workflow
Provides natural language access to /specswarm:modify command.
When to Invoke
Trigger this skill when the user mentions:
- Modifying, changing, or updating existing feature behavior
- Enhancing or extending working features
- Altering how something works (that currently works)
- Making features work differently than they do now
Examples:
- "Change authentication from session to JWT"
- "Add pagination to the user list API"
- "Update search to use full-text search"
- "Modify the dashboard to show real-time data"
- "Extend the API to support filtering"
NOT for this skill:
- Fixing bugs (use specswarm-fix)
- Improving code quality without changing behavior (use specswarm-refactor)
- Building new features (use specswarm-build)
Instructions
Confidence-Based Execution:
Detect that user mentioned modifying/changing existing functionality
Extract the modification description from their message
Assess confidence and execute accordingly:
High Confidence (95%+) - Auto-execute immediately:
- Clear modification requests: "Change authentication from session to JWT", "Add pagination to user list API", "Update search algorithm to use full-text search"
- Action: Immediately run
/specswarm:modify "modification description"
- Show brief notification: "🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)"
Medium Confidence (70-94%) - Ask for confirmation:
- Less specific: "Update the authentication", "Modify the search"
- Action: Use AskUserQuestion tool with two options:
- Option 1 (label: "Run /specswarm:modify"): Use SpecSwarm's impact-analysis workflow
- Option 2 (label: "Process normally"): Handle as regular Claude Code request
Low Confidence (<70%) - Always ask:
- Vague: "Make the feature better", "Improve the UI"
- Action: Use AskUserQuestion as above
If user cancels (Ctrl+C) or selects Option 2, process normally without SpecSwarm
After command completes, STOP - do not continue with ship/merge
What the Modify Command Does
/specswarm:modify runs complete workflow:
- Analyzes impact and backward compatibility
- Identifies breaking changes
- Creates migration plan if needed
- Updates specification and plan
- Generates modification tasks
- Implements changes
- Validates against regression tests
Stops after modification is complete - does NOT merge/ship/deploy.
Semantic Understanding
This skill should trigger not just on exact keywords, but semantic equivalents:
Modify equivalents: modify, change, update, adjust, enhance, extend, alter, revise, adapt, transform, convert
Target terms: feature, functionality, behavior, workflow, process, mechanism, system
Distinguish from:
- Fix (broken/not working things): "fix", "repair", "resolve", "debug"
- Refactor (code quality): "refactor", "clean up", "reorganize", "optimize code structure"
- Build (new things): "build", "create", "add", "implement new"
Example
User: "Change authentication from session to JWT"
Claude: 🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)
[Executes /specswarm:modify "Change authentication from session to JWT"]
User: "Update the authentication"
Claude: [Shows AskUserQuestion]
1. Run /specswarm:modify - Use SpecSwarm's impact-analysis workflow
2. Process normally - Handle as regular Claude Code request
User selects Option 1
1---2name: specswarm-modify3description: Impact-analysis-first modification workflow with backward compatibility assessment and breaking change detection. Auto-executes when user clearly wants to modify, change, update, adjust, enhance, extend, or alter existing feature behavior (not fixing bugs, not refactoring quality). For features that work but need to work differently.4---5
6# SpecSwarm Modify Workflow
7
8Provides natural language access to `/specswarm:modify` command.
9
10## When to Invoke
11
12Trigger this skill when the user mentions:
13- Modifying, changing, or updating existing feature behavior
14- Enhancing or extending working features
15- Altering how something works (that currently works)
16- Making features work differently than they do now
17
18**Examples:**
19- "Change authentication from session to JWT"
20- "Add pagination to the user list API"
21- "Update search to use full-text search"
22- "Modify the dashboard to show real-time data"
23- "Extend the API to support filtering"
24
25**NOT for this skill:**
26- Fixing bugs (use specswarm-fix)
27- Improving code quality without changing behavior (use specswarm-refactor)
28- Building new features (use specswarm-build)
29
30## Instructions
31
32**Confidence-Based Execution:**
33
341. **Detect** that user mentioned modifying/changing existing functionality
352. **Extract** the modification description from their message
363. **Assess confidence and execute accordingly**:
37
38 **High Confidence (95%+)** - Auto-execute immediately:
39 - Clear modification requests: "Change authentication from session to JWT", "Add pagination to user list API", "Update search algorithm to use full-text search"
40 - Action: Immediately run `/specswarm:modify "modification description"`
41 - Show brief notification: "🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)"
42
43 **Medium Confidence (70-94%)** - Ask for confirmation:
44 - Less specific: "Update the authentication", "Modify the search"
45 - Action: Use AskUserQuestion tool with two options:
46 - Option 1 (label: "Run /specswarm:modify"): Use SpecSwarm's impact-analysis workflow
47 - Option 2 (label: "Process normally"): Handle as regular Claude Code request
48
49 **Low Confidence (<70%)** - Always ask:
50 - Vague: "Make the feature better", "Improve the UI"
51 - Action: Use AskUserQuestion as above
52
534. **If user cancels (Ctrl+C) or selects Option 2**, process normally without SpecSwarm
545. **After command completes**, STOP - do not continue with ship/merge
55
56## What the Modify Command Does
57
58`/specswarm:modify` runs complete workflow:
59- Analyzes impact and backward compatibility
60- Identifies breaking changes
61- Creates migration plan if needed
62- Updates specification and plan
63- Generates modification tasks
64- Implements changes
65- Validates against regression tests
66
67Stops after modification is complete - does NOT merge/ship/deploy.
68
69## Semantic Understanding
70
71This skill should trigger not just on exact keywords, but semantic equivalents:
72
73**Modify equivalents**: modify, change, update, adjust, enhance, extend, alter, revise, adapt, transform, convert
74**Target terms**: feature, functionality, behavior, workflow, process, mechanism, system
75
76**Distinguish from:**
77- **Fix** (broken/not working things): "fix", "repair", "resolve", "debug"
78- **Refactor** (code quality): "refactor", "clean up", "reorganize", "optimize code structure"
79- **Build** (new things): "build", "create", "add", "implement new"
80
81## Example
82
83```
84User: "Change authentication from session to JWT"
85
86Claude: 🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)
87
88[Executes /specswarm:modify "Change authentication from session to JWT"]
89```
90
91```
92User: "Update the authentication"
93
94Claude: [Shows AskUserQuestion]
951. Run /specswarm:modify - Use SpecSwarm's impact-analysis workflow
962. Process normally - Handle as regular Claude Code request
97
98User selects Option 1
99```