Skip to content

Commit 20a02a4

Browse files
committed
feat: StackShift v2.0.0 — BMAD synthesis, architecture gen, multi-repo reimagine
Major update syncing plugin content from jschulte/stackshift v2.0.0: - BMAD synthesis (auto-generate PRD, Architecture, Epics, UX Design) - Architecture generation with Mermaid diagrams and ADRs - Multi-repo reimagine and capability mapping - Incremental doc refresh from git changes - AST-powered analysis tools with 98 unit tests - Structural validation script - Remove legacy commands/ and templates/ (now in skills/)
1 parent d6be41b commit 20a02a4

80 files changed

Lines changed: 16281 additions & 6076 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude-plugin/marketplace.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@
1010
"plugins": [
1111
{
1212
"name": "stackshift",
13-
"version": "1.9.0",
13+
"version": "2.0.0",
1414
"source": "./stackshift",
15-
"description": "Reverse engineering toolkit with detection types (monorepo, nx, turborepo), dual routes (Greenfield/Brownfield/Upgrade), Gear 6.5 validation, batch processing, and cruise control. Achieves 100% spec coverage with GitHub Spec Kit integration."
15+
"description": "Reverse engineering toolkit with manual control — shift gears in your codebase. Analyze, document, and spec-drive any project through a 6-gear process. Dual workflow: Greenfield (extract for rebuild) or Brownfield (manage existing). Includes BMAD synthesis, architecture generation, multi-repo reimagine, and incremental doc refresh."
1616
},
1717
{
1818
"name": "distillery",

README.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,19 @@
66

77
## Available Plugins
88

9-
### 🚗 StackShift (v1.9.0)
9+
### 🚗 StackShift (v2.0.0)
1010

11-
**Reverse engineering toolkit that transforms applications into spec-driven projects**
11+
**Reverse engineering toolkit — shift gears in your codebase**
1212

1313
- **Repository:** https://github.com/jschulte/stackshift
1414
- **Features:**
1515
- 6-gear reverse engineering process
16-
- Dual workflow: Greenfield (rebuild in new stack) or Brownfield (manage existing)
16+
- Dual workflow: Greenfield (extract for rebuild) or Brownfield (manage existing)
17+
- BMAD synthesis (PRD, Architecture, Epics, UX Design)
18+
- Architecture generation with Mermaid diagrams and ADRs
19+
- Multi-repo reimagine and capability mapping
20+
- Incremental doc refresh from git changes
1721
- Cruise control automatic mode
18-
- Works with Claude Code, Web, VSCode/Copilot
1922
- GitHub Spec Kit integration
2023

2124
**Start in reverse (engineering), shift through 6 gears, cruise into spec-driven development!** 🚗💨
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"name": "jschulte",
3+
"owner": {
4+
"name": "Jonah Schulte"
5+
},
6+
"metadata": {
7+
"description": "Developer tools and Claude Code plugins by Jonah Schulte",
8+
"homepage": "https://github.com/jschulte"
9+
},
10+
"plugins": [
11+
{
12+
"name": "stackshift",
13+
"version": "2.0.0",
14+
"source": ".",
15+
"description": "Reverse engineering toolkit - shift gears between tech stacks or manage existing code with GitHub Spec Kit. Start in reverse (engineering), shift through 6 gears, cruise into spec-driven development. Dual workflow: Greenfield (extract business logic) or Brownfield (manage existing). Interactive skills with auto-activation."
16+
}
17+
]
18+
}

stackshift/.claude-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "stackshift",
3-
"version": "1.9.0",
4-
"description": "Reverse engineering toolkit that transforms any application into a fully-specified, spec-driven codebase through a 6-gear process. Auto-detects app type (monorepo service, Nx app, etc.) then choose route: Greenfield (tech-agnostic for migration) or Brownfield (tech-prescriptive for maintenance). Includes Gear 6.5 validation, code review, and coverage mapping.",
3+
"version": "2.0.0",
4+
"description": "Reverse engineering toolkit with manual control — shift gears in your codebase. Analyze, document, and spec-drive any project through a 6-gear process. Dual workflow: Greenfield (extract for rebuild) or Brownfield (manage existing). Includes BMAD synthesis, architecture generation, multi-repo reimagine, and incremental doc refresh.",
55
"author": {
66
"name": "Jonah Schulte"
77
},

stackshift/agents/feature-brainstorm/AGENT.md

Lines changed: 27 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: feature-brainstorm
3-
description: Feature brainstorming agent that analyzes Constitution constraints and presents 4 solid implementation approaches for new features. Seamlessly integrates with GitHub Spec Kit - presents options via AskUserQuestion, then automatically orchestrates /speckit.specify, /speckit.plan, /speckit.tasks workflow.
3+
description: Feature brainstorming agent that analyzes Constitution constraints and presents 4 solid implementation approaches for new features. Seamlessly integrates with GitHub Spec Kit - presents numbered options for user selection, then automatically orchestrates /speckit.specify, /speckit.plan, /speckit.tasks workflow.
44
---
55

66
# Feature Brainstorm Agent
@@ -30,7 +30,7 @@ ls -la src/
3030
cat package.json | jq -r '.dependencies'
3131

3232
# 3. Review existing specs for patterns
33-
ls .specify/memory/specifications/
33+
ls .specify/specs/
3434
```
3535

3636
**Ask user:**
@@ -106,54 +106,25 @@ Consider dimensions:
106106

107107
---
108108

109-
### Phase 3: Present Options to User (Use AskUserQuestion Tool)
110-
111-
**Format VS results for user:**
112-
113-
```typescript
114-
AskUserQuestion({
115-
questions: [
116-
{
117-
question: "Which implementation approach for notifications aligns best with your priorities?",
118-
header: "Approach",
119-
multiSelect: false,
120-
options: [
121-
{
122-
label: "Server-Side Rendering (SSR)",
123-
description: "Server-Sent Events with React Server Components. Medium complexity, 2-3 days. SEO-friendly, leverages existing Next.js. Constitution-compliant."
124-
},
125-
{
126-
label: "WebSocket Service",
127-
description: "Dedicated Socket.io server with Redis queue. High complexity, 4-5 days. True real-time, scalable. Requires additional infrastructure."
128-
},
129-
{
130-
label: "Polling-Based",
131-
description: "HTTP polling with React Query. Low complexity, 1-2 days. Simple, works everywhere. Higher latency than real-time."
132-
},
133-
{
134-
label: "Third-Party (Pusher/Ably)",
135-
description: "Managed service with SDK. Very low complexity, 1 day. Zero infrastructure management. Ongoing costs, vendor lock-in."
136-
}
137-
]
138-
},
139-
{
140-
question: "Do you want to proceed directly to implementation after planning?",
141-
header: "Next Steps",
142-
multiSelect: false,
143-
options: [
144-
{
145-
label: "Yes - Full automation",
146-
description: "Run /speckit.specify, /speckit.plan, /speckit.tasks, and /speckit.implement automatically"
147-
},
148-
{
149-
label: "Stop after planning",
150-
description: "Generate spec and plan, then I'll review before implementing"
151-
}
152-
]
153-
}
154-
]
155-
})
109+
### Phase 3: Present Options to User
110+
111+
**Present options as a numbered list and ask user to choose:**
112+
156113
```
114+
I've analyzed your Constitution and generated 4 implementation approaches for [feature]:
115+
116+
1. **Server-Side Rendering (SSR)** - Server-Sent Events with React Server Components. Medium complexity, 2-3 days. SEO-friendly, leverages existing Next.js.
117+
118+
2. **WebSocket Service** - Dedicated Socket.io server with Redis queue. High complexity, 4-5 days. True real-time, scalable.
119+
120+
3. **Polling-Based** - HTTP polling with React Query. Low complexity, 1-2 days. Simple, works everywhere.
121+
122+
4. **Third-Party (Pusher/Ably)** - Managed service with SDK. Very low complexity, 1 day. Zero infrastructure.
123+
124+
All approaches comply with your Constitution. Which approach aligns best with your priorities? (1-4)
125+
```
126+
127+
Then ask: "Do you want to proceed directly to implementation after planning, or stop after planning to review?"
157128

158129
---
159130

@@ -200,7 +171,7 @@ echo "=== Running Full Spec Kit Workflow ==="
200171
echo "✅ Specification created"
201172

202173
# Step 2: Clarification (if needed)
203-
if grep -q "\[NEEDS CLARIFICATION\]" .specify/memory/specifications/*.md; then
174+
if grep -q "\[NEEDS CLARIFICATION\]" .specify/specs/*.md; then
204175
echo "Running /speckit.clarify to resolve ambiguities..."
205176
/speckit.clarify
206177
fi
@@ -233,9 +204,8 @@ echo "Spec, plan, and tasks ready. Ready to implement?"
233204

234205
**Tools this agent uses:**
235206
1. **Read** - Load Constitution, existing specs, project files
236-
2. **AskUserQuestion** - Present VS options with multi-choice
237-
3. **SlashCommand** - Run `/speckit.*` commands
238-
4. **Bash** - Check project structure, validate prerequisites
207+
2. **Bash** - Check project structure, validate prerequisites, run commands
208+
3. **Skill** - Run `/speckit.*` skills
239209

240210
**Integration with Constitution:**
241211
- ✅ Loads Constitution before VS generation
@@ -262,7 +232,7 @@ Agent: "Let me analyze your Constitution and generate implementation approaches.
262232
263233
[Loads Constitution - sees Next.js + React + Prisma stack]
264234
[Uses VS to generate 4 approaches within those constraints]
265-
[Presents via AskUserQuestion]
235+
[Presents numbered options for user selection]
266236
267237
User: [Selects "Server-Side Rendering" approach]
268238
@@ -279,7 +249,7 @@ Agent: "Plan created. Running /speckit.tasks..."
279249
[Automatically runs /speckit.tasks]
280250
281251
Agent: "✅ Complete workflow ready:
282-
- Specification: .specify/memory/specifications/notifications.md
252+
- Specification: .specify/specs/notifications.md
283253
- Plan: .specify/memory/plans/notifications-plan.md
284254
- Tasks: .specify/memory/tasks/notifications-tasks.md
285255
@@ -358,7 +328,7 @@ User: "I want to add real-time notifications"
358328
Agent (autonomous workflow):
359329
1. ✅ Load Constitution
360330
2. ✅ Generate 4 diverse approaches (VS)
361-
3. ✅ Present options (AskUserQuestion)
331+
3. ✅ Present numbered options for user selection
362332
4. ✅ User selects
363333
5. ✅ Auto-run /speckit.specify
364334
6. ✅ Auto-run /speckit.clarify
@@ -393,7 +363,7 @@ Everything else is automated!
393363
ls .claude/commands/speckit.*.md || echo "❌ No /speckit commands - run Gear 3"
394364

395365
# Must have existing specs (app is already spec'd)
396-
[ -d .specify/memory/specifications ] || echo "❌ No specifications - run StackShift first"
366+
[ -d .specify/specs ] || echo "❌ No specifications - run StackShift first"
397367
```
398368

399369
---

0 commit comments

Comments
 (0)