specweave 0.1.4 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +162 -243
- package/SPECWEAVE.md +14 -12
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +42 -26
- package/dist/cli/commands/init.js.map +1 -1
- package/package.json +1 -1
- package/src/commands/README.md +171 -0
- package/src/commands/at.md +114 -0
- package/src/commands/ci.md +63 -0
- package/src/commands/done.md +103 -0
- package/src/commands/init.md +123 -0
- package/src/commands/ls.md +100 -0
- package/src/commands/si.md +83 -0
- package/src/commands/vi.md +89 -0
- package/src/skills/specweave-detector/SKILL.md +137 -178
- package/src/templates/CLAUDE.md.template +29 -26
- package/src/templates/README.md.template +7 -7
|
@@ -1,99 +1,69 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: specweave-detector
|
|
3
|
-
description:
|
|
3
|
+
description: MANDATORY entry point for SpecWeave framework. Activates when .specweave/ exists OR when user mentions "SpecWeave", "increment", "feature", "/create-increment". All 10 agents and 35+ skills are PRE-INSTALLED during init - no auto-installation needed. Routes requests to increment-planner, skill-router, or appropriate agents. Keywords SpecWeave, spec-driven, increment, feature, spec, plan, task, create feature, build feature, new increment.
|
|
4
4
|
proactive: true
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# SpecWeave Detector & Entry Point
|
|
8
8
|
|
|
9
|
-
This skill is the **
|
|
9
|
+
This skill is the **MANDATORY entry point** for all SpecWeave operations. When Claude Code detects a `.specweave/config.yaml` file OR user mentions SpecWeave-related keywords, this skill MUST activate and orchestrate the framework.
|
|
10
10
|
|
|
11
11
|
## Purpose
|
|
12
12
|
|
|
13
13
|
Act as the "factory of agents" that:
|
|
14
|
-
1. Detects SpecWeave projects automatically
|
|
15
|
-
2. Parses user requests
|
|
16
|
-
3. Routes to appropriate skills
|
|
17
|
-
4. Orchestrates nested skill calls
|
|
18
|
-
5. Manages context loading
|
|
14
|
+
1. **Detects SpecWeave projects automatically** (when .specweave/ exists)
|
|
15
|
+
2. **Parses user requests** and determines intent
|
|
16
|
+
3. **Routes to appropriate skills/agents** (all pre-installed!)
|
|
17
|
+
4. **Orchestrates nested skill calls** for complex operations
|
|
18
|
+
5. **Manages context loading** via context-loader skill
|
|
19
19
|
|
|
20
|
-
## Detection Logic
|
|
20
|
+
## Detection Logic (0.1.5 - Pre-Installation)
|
|
21
21
|
|
|
22
22
|
```javascript
|
|
23
23
|
// Pseudo-code for detection
|
|
24
24
|
if (fileExists('.specweave/config.yaml')) {
|
|
25
|
+
// ACTIVATE SPECWEAVE MODE
|
|
25
26
|
activateSpecWeaveMode();
|
|
26
27
|
loadConfiguration();
|
|
27
28
|
|
|
28
|
-
//
|
|
29
|
-
|
|
29
|
+
// ALL COMPONENTS ALREADY INSTALLED!
|
|
30
|
+
// ✅ 10 agents in .claude/agents/
|
|
31
|
+
// ✅ 35+ skills in .claude/skills/
|
|
32
|
+
// ✅ 10 commands in .claude/commands/
|
|
33
|
+
|
|
34
|
+
// NO AUTO-INSTALLATION NEEDED (pre-installed in 0.1.5)
|
|
30
35
|
|
|
31
36
|
parseUserIntent();
|
|
32
37
|
routeToSkills();
|
|
33
38
|
}
|
|
34
39
|
```
|
|
35
40
|
|
|
36
|
-
##
|
|
41
|
+
## Pre-Installed Components (0.1.5+)
|
|
37
42
|
|
|
38
|
-
**SpecWeave uses
|
|
43
|
+
**IMPORTANT**: SpecWeave 0.1.5+ uses **pre-installation** instead of auto-installation.
|
|
39
44
|
|
|
40
|
-
|
|
45
|
+
After `specweave init`, ALL components are ready:
|
|
46
|
+
- ✅ **10 agents**: PM, Architect, Security, QA Lead, DevOps, Tech Lead, SRE, Docs Writer, Performance, Diagrams Architect
|
|
47
|
+
- ✅ **35+ skills**: Technology stacks, integrations, utilities
|
|
48
|
+
- ✅ **10 slash commands**: /create-increment, /validate-increment, etc.
|
|
41
49
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
- "Next.js" → nextjs skill, nodejs-backend skill
|
|
46
|
-
- "authentication" → security agent
|
|
47
|
-
- "Create" → pm agent, architect agent
|
|
48
|
-
4. **Check if components installed** in `.claude/skills/` and `.claude/agents/`
|
|
49
|
-
5. **Auto-install missing components** from npm package (`node_modules/specweave/src/`)
|
|
50
|
-
6. **Proceed with routing** - now all needed components are available
|
|
51
|
-
|
|
52
|
-
### Keyword → Component Mapping
|
|
53
|
-
|
|
54
|
-
```typescript
|
|
55
|
-
// From src/utils/auto-install.ts
|
|
56
|
-
const COMPONENT_MAPPING = {
|
|
57
|
-
// Framework detection
|
|
58
|
-
'next.js': { skills: ['nextjs', 'nodejs-backend'], agents: [] },
|
|
59
|
-
'react': { skills: ['frontend'], agents: [] },
|
|
60
|
-
'fastapi': { skills: ['python-backend'], agents: [] },
|
|
61
|
-
'django': { skills: ['python-backend'], agents: [] },
|
|
62
|
-
'.net': { skills: ['dotnet-backend'], agents: [] },
|
|
63
|
-
|
|
64
|
-
// Feature detection
|
|
65
|
-
'authentication': { skills: ['nodejs-backend'], agents: ['security'] },
|
|
66
|
-
'auth': { skills: [], agents: ['security'] },
|
|
67
|
-
'oauth': { skills: [], agents: ['security'] },
|
|
68
|
-
'payment': { skills: ['stripe-integrator'], agents: ['security'] },
|
|
69
|
-
'stripe': { skills: ['stripe-integrator'], agents: ['security'] },
|
|
70
|
-
|
|
71
|
-
// Infrastructure detection
|
|
72
|
-
'deploy': { skills: [], agents: ['devops'] },
|
|
73
|
-
'hetzner': { skills: ['hetzner-provisioner'], agents: ['devops'] },
|
|
74
|
-
'aws': { skills: [], agents: ['devops'] },
|
|
75
|
-
|
|
76
|
-
// Testing detection
|
|
77
|
-
'test': { skills: [], agents: ['qa-lead'] },
|
|
78
|
-
'e2e': { skills: ['e2e-playwright'], agents: ['qa-lead'] },
|
|
79
|
-
'playwright': { skills: ['e2e-playwright'], agents: ['qa-lead'] },
|
|
80
|
-
|
|
81
|
-
// Design detection
|
|
82
|
-
'figma': { skills: ['figma-implementer', 'figma-designer'], agents: [] },
|
|
83
|
-
'design system': { skills: ['design-system-architect'], agents: [] },
|
|
84
|
-
|
|
85
|
-
// Integration detection
|
|
86
|
-
'jira': { skills: ['jira-sync'], agents: [] },
|
|
87
|
-
'github': { skills: ['github-sync'], agents: [] },
|
|
88
|
-
};
|
|
89
|
-
|
|
90
|
-
// Always include strategic agents for new features
|
|
91
|
-
if (prompt.includes('create') || prompt.includes('build')) {
|
|
92
|
-
agents.push('pm', 'architect');
|
|
93
|
-
}
|
|
94
|
-
```
|
|
50
|
+
**No installation wait time** - components activate immediately!
|
|
51
|
+
|
|
52
|
+
### How It Works (0.1.5+)
|
|
95
53
|
|
|
96
|
-
|
|
54
|
+
1. **User makes a request** (e.g., "Create Next.js authentication")
|
|
55
|
+
2. **SpecWeave detector activates** (all components already installed!)
|
|
56
|
+
3. **Analyze user intent**:
|
|
57
|
+
- "Create" → Route to increment-planner skill
|
|
58
|
+
- "Next.js" → Will use nextjs skill (already installed)
|
|
59
|
+
- "authentication" → Will involve security agent (already installed)
|
|
60
|
+
4. **Route to increment-planner**:
|
|
61
|
+
- Creates increment folder
|
|
62
|
+
- Generates spec.md, plan.md, tasks.md, tests.md
|
|
63
|
+
- Coordinates with PM agent → Architect agent
|
|
64
|
+
5. **Implementation ready** - All skills/agents available immediately
|
|
65
|
+
|
|
66
|
+
### Example User Experience (0.1.5+)
|
|
97
67
|
|
|
98
68
|
**Example 1: Next.js Authentication**
|
|
99
69
|
```
|
|
@@ -101,24 +71,28 @@ User: "Create Next.js authentication with OAuth"
|
|
|
101
71
|
|
|
102
72
|
🔷 SpecWeave Active
|
|
103
73
|
|
|
104
|
-
📦 Installing required components...
|
|
105
|
-
✅ Installed nextjs skill
|
|
106
|
-
✅ Installed nodejs-backend skill
|
|
107
|
-
✅ Installed security agent
|
|
108
|
-
✅ Installed pm agent
|
|
109
|
-
✅ Installed architect agent
|
|
110
|
-
|
|
111
74
|
🚀 Creating increment 0001-nextjs-authentication...
|
|
75
|
+
📝 Using nextjs skill (already installed!)
|
|
76
|
+
🤖 PM agent creating requirements...
|
|
77
|
+
🏗️ Architect agent designing system...
|
|
78
|
+
|
|
79
|
+
✅ Increment created: .specweave/increments/0001-nextjs-authentication/
|
|
80
|
+
✅ Files: spec.md, plan.md, tasks.md, tests.md
|
|
112
81
|
```
|
|
113
82
|
|
|
114
|
-
**Example 2:
|
|
83
|
+
**Example 2: Real Estate Platform**
|
|
115
84
|
```
|
|
116
|
-
User: "
|
|
85
|
+
User: "Build a real estate listing platform with Node.js/Express"
|
|
117
86
|
|
|
118
87
|
🔷 SpecWeave Active
|
|
119
|
-
(Components already installed, proceeding...)
|
|
120
88
|
|
|
121
|
-
🚀 Creating increment
|
|
89
|
+
🚀 Creating increment 0001-real-estate-platform...
|
|
90
|
+
📝 Using nodejs-backend skill (already installed!)
|
|
91
|
+
🤖 PM agent creating requirements...
|
|
92
|
+
🏗️ Architect agent designing system...
|
|
93
|
+
🛡️ Security agent reviewing authentication...
|
|
94
|
+
|
|
95
|
+
✅ Increment created with complete specifications
|
|
122
96
|
```
|
|
123
97
|
|
|
124
98
|
**Example 3: Python FastAPI**
|
|
@@ -127,53 +101,21 @@ User: "Create FastAPI backend with PostgreSQL"
|
|
|
127
101
|
|
|
128
102
|
🔷 SpecWeave Active
|
|
129
103
|
|
|
130
|
-
📦 Installing required components...
|
|
131
|
-
✅ Installed python-backend skill
|
|
132
|
-
✅ Installed pm agent
|
|
133
|
-
✅ Installed architect agent
|
|
134
|
-
|
|
135
104
|
🚀 Creating increment 0001-fastapi-backend...
|
|
136
|
-
|
|
105
|
+
📝 Using python-backend skill (already installed!)
|
|
106
|
+
🤖 PM agent creating requirements...
|
|
107
|
+
🏗️ Architect agent designing system...
|
|
137
108
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
Auto-install can be disabled in `.specweave/config.yaml`:
|
|
141
|
-
|
|
142
|
-
```yaml
|
|
143
|
-
# .specweave/config.yaml
|
|
144
|
-
auto_install: true # Default: enabled
|
|
145
|
-
|
|
146
|
-
# Tracked installed components (auto-updated)
|
|
147
|
-
installed_components:
|
|
148
|
-
skills:
|
|
149
|
-
- nextjs
|
|
150
|
-
- nodejs-backend
|
|
151
|
-
- security
|
|
152
|
-
agents:
|
|
153
|
-
- pm
|
|
154
|
-
- architect
|
|
155
|
-
- security
|
|
109
|
+
✅ Increment created: .specweave/increments/0001-fastapi-backend/
|
|
156
110
|
```
|
|
157
111
|
|
|
158
|
-
|
|
112
|
+
### Benefits of Pre-Installation (0.1.5+)
|
|
159
113
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
2. **Copy component**: `src/skills/nextjs/` → `.claude/skills/nextjs/`
|
|
166
|
-
3. **Verify**: Check component has SKILL.md or AGENT.md
|
|
167
|
-
4. **Update config**: Add to `installed_components` list
|
|
168
|
-
5. **Continue routing**: Component now available for use
|
|
169
|
-
|
|
170
|
-
### Benefits
|
|
171
|
-
|
|
172
|
-
- ✅ **Zero manual installation** - users never run `specweave install`
|
|
173
|
-
- ✅ **Just-in-time** - only install what's actually needed
|
|
174
|
-
- ✅ **Automatic** - completely transparent to users
|
|
175
|
-
- ✅ **Intelligent** - understands intent from natural language
|
|
176
|
-
- ✅ **Efficient** - unused components never installed
|
|
114
|
+
- ✅ **Zero wait time** - all components ready immediately
|
|
115
|
+
- ✅ **No installation confusion** - everything works out of the box
|
|
116
|
+
- ✅ **Predictable** - same components every time
|
|
117
|
+
- ✅ **Simple mental model** - init once, use forever
|
|
118
|
+
- ✅ **Offline-friendly** - all components local after init
|
|
177
119
|
|
|
178
120
|
## Auto-Activation
|
|
179
121
|
|
|
@@ -194,11 +136,11 @@ User: "I want to add payment processing"
|
|
|
194
136
|
# 1. specweave-detector intercepts request
|
|
195
137
|
# 2. Parses request: "add feature" + "payment processing"
|
|
196
138
|
# 3. Routes to: increment-planner skill
|
|
197
|
-
# 4. increment-planner creates
|
|
139
|
+
# 4. increment-planner creates Increment 0002
|
|
198
140
|
# 5. Returns result to user
|
|
199
141
|
|
|
200
142
|
# User sees:
|
|
201
|
-
✅
|
|
143
|
+
✅ Increment created: .specweave/increments/0002-payment-processing/
|
|
202
144
|
```
|
|
203
145
|
|
|
204
146
|
## Request Parsing & Routing
|
|
@@ -220,11 +162,11 @@ User: "I want to add payment processing"
|
|
|
220
162
|
**Example**: "Create and implement a new payment feature"
|
|
221
163
|
|
|
222
164
|
**Request Breakdown**:
|
|
223
|
-
1. Create
|
|
224
|
-
2.
|
|
225
|
-
3. Implement code →
|
|
226
|
-
4. Generate tests →
|
|
227
|
-
5. Update docs →
|
|
165
|
+
1. Create increment → `increment-planner`
|
|
166
|
+
2. Load context → `context-loader`
|
|
167
|
+
3. Implement code → Coordinate with appropriate agents/skills
|
|
168
|
+
4. Generate tests → Use QA Lead agent
|
|
169
|
+
5. Update docs → Use Docs Writer agent
|
|
228
170
|
|
|
229
171
|
**Execution Flow**:
|
|
230
172
|
```
|
|
@@ -234,17 +176,17 @@ specweave-detector parses: CREATE + IMPLEMENT + FEATURE + PAYMENT
|
|
|
234
176
|
↓
|
|
235
177
|
Orchestrate nested skills:
|
|
236
178
|
↓
|
|
237
|
-
increment-planner: Create
|
|
179
|
+
increment-planner: Create .specweave/increments/0003-payment-processing/
|
|
238
180
|
↓
|
|
239
|
-
context-loader: Load
|
|
181
|
+
context-loader: Load .specweave/docs/internal/strategy/payments/**
|
|
240
182
|
↓
|
|
241
|
-
|
|
183
|
+
Implementation: Use nodejs-backend skill + security agent
|
|
242
184
|
↓
|
|
243
|
-
|
|
185
|
+
Testing: Use QA Lead agent (generate E2E tests)
|
|
244
186
|
↓
|
|
245
|
-
|
|
187
|
+
Documentation: Update .specweave/docs/internal/architecture/
|
|
246
188
|
↓
|
|
247
|
-
Result: "✅
|
|
189
|
+
Result: "✅ Increment 0003 implemented and documented"
|
|
248
190
|
```
|
|
249
191
|
|
|
250
192
|
### Ambiguous Request
|
|
@@ -269,14 +211,14 @@ skill-router asks:
|
|
|
269
211
|
|
|
270
212
|
### Automatic Context Loading
|
|
271
213
|
|
|
272
|
-
When a user is working on
|
|
214
|
+
When a user is working on an increment:
|
|
273
215
|
|
|
274
216
|
```javascript
|
|
275
|
-
// Detect active
|
|
276
|
-
const
|
|
217
|
+
// Detect active increment
|
|
218
|
+
const activeIncrement = detectActiveIncrement(); // .specweave/increments/####-xxx/
|
|
277
219
|
|
|
278
|
-
if (
|
|
279
|
-
const manifest = loadManifest(`${
|
|
220
|
+
if (activeIncrement) {
|
|
221
|
+
const manifest = loadManifest(`${activeIncrement}/context-manifest.yaml`);
|
|
280
222
|
const context = await contextLoader.load(manifest);
|
|
281
223
|
// Context now available for all skills
|
|
282
224
|
}
|
|
@@ -286,10 +228,10 @@ if (activeIssue) {
|
|
|
286
228
|
|
|
287
229
|
When multiple contexts are relevant:
|
|
288
230
|
|
|
289
|
-
1. **Active
|
|
290
|
-
2. **Current
|
|
231
|
+
1. **Active increment** (in `.specweave/increments/####-xxx/`)
|
|
232
|
+
2. **Current branch** (git branch name features/###-xxx)
|
|
291
233
|
3. **User-specified** context
|
|
292
|
-
4. **Global** context (
|
|
234
|
+
4. **Global** context (.specweave/docs/internal/strategy/overview.md, principles.md)
|
|
293
235
|
|
|
294
236
|
## Skill Orchestration
|
|
295
237
|
|
|
@@ -329,17 +271,17 @@ Each step waits for previous to complete
|
|
|
329
271
|
If a skill fails:
|
|
330
272
|
|
|
331
273
|
```
|
|
332
|
-
User: "Implement
|
|
274
|
+
User: "Implement increment 0005"
|
|
333
275
|
↓
|
|
334
|
-
specweave-detector: Route to
|
|
276
|
+
specweave-detector: Route to implementation
|
|
335
277
|
↓
|
|
336
|
-
|
|
278
|
+
ERROR: Increment 0005 not found
|
|
337
279
|
↓
|
|
338
280
|
specweave-detector: Catch error, suggest:
|
|
339
|
-
"
|
|
340
|
-
1. Create it first (increment
|
|
341
|
-
2. List existing
|
|
342
|
-
3. Implement a different
|
|
281
|
+
"Increment 0005 doesn't exist. Would you like to:
|
|
282
|
+
1. Create it first (/create-increment)
|
|
283
|
+
2. List existing increments (/list-increments)
|
|
284
|
+
3. Implement a different increment"
|
|
343
285
|
```
|
|
344
286
|
|
|
345
287
|
## Configuration Awareness
|
|
@@ -353,14 +295,17 @@ principles:
|
|
|
353
295
|
context_precision: true # Use context manifests
|
|
354
296
|
routing_accuracy_target: 0.90 # Accuracy threshold
|
|
355
297
|
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
auto_install: true # Auto-install missing skills
|
|
298
|
+
# All components pre-installed in 0.1.5+ (no auto_install setting needed)
|
|
299
|
+
# Agents and skills are in .claude/ folder, ready to use
|
|
359
300
|
|
|
360
301
|
integrations:
|
|
361
302
|
github:
|
|
362
303
|
enabled: true
|
|
363
|
-
sync_issues: true # Sync
|
|
304
|
+
sync_issues: true # Sync increments ↔ GitHub issues
|
|
305
|
+
jira:
|
|
306
|
+
enabled: false
|
|
307
|
+
ado:
|
|
308
|
+
enabled: false
|
|
364
309
|
```
|
|
365
310
|
|
|
366
311
|
When `auto_role_routing: false`, this skill still activates but prompts user for explicit skill selection.
|
|
@@ -379,21 +324,35 @@ This helps users know SpecWeave framework is orchestrating their request.
|
|
|
379
324
|
|
|
380
325
|
## Skill Discovery
|
|
381
326
|
|
|
382
|
-
List available skills:
|
|
327
|
+
List available skills (all pre-installed):
|
|
383
328
|
|
|
384
329
|
```bash
|
|
385
330
|
User: "What can SpecWeave do?"
|
|
386
331
|
↓
|
|
387
|
-
specweave-detector: List installed skills
|
|
332
|
+
specweave-detector: List all pre-installed skills
|
|
388
333
|
|
|
389
|
-
SpecWeave Skills:
|
|
334
|
+
SpecWeave Framework Skills (35+, all ready):
|
|
390
335
|
✅ increment-planner - Plan implementation features
|
|
391
336
|
✅ context-loader - Selective specification loading
|
|
392
337
|
✅ skill-router - Route ambiguous intents
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
338
|
+
✅ nodejs-backend - Node.js/Express/NestJS backend
|
|
339
|
+
✅ python-backend - Python/FastAPI/Django backend
|
|
340
|
+
✅ nextjs - Next.js App Router specialist
|
|
341
|
+
✅ frontend - React/Vue/Angular frontend
|
|
342
|
+
✅ diagrams-generator - C4 Model diagrams
|
|
343
|
+
✅ github-sync - GitHub integration
|
|
344
|
+
✅ jira-sync - JIRA integration
|
|
345
|
+
... and 25+ more!
|
|
346
|
+
|
|
347
|
+
SpecWeave Agents (10, all ready):
|
|
348
|
+
✅ pm - Product Manager (requirements, user stories)
|
|
349
|
+
✅ architect - System Architect (design, ADRs)
|
|
350
|
+
✅ security - Security Engineer (threat modeling)
|
|
351
|
+
✅ qa-lead - QA Lead (test strategy)
|
|
352
|
+
✅ devops - DevOps Engineer (deployment)
|
|
353
|
+
... and 5+ more!
|
|
354
|
+
|
|
355
|
+
Custom Skills (user-created):
|
|
397
356
|
✅ newrelic-monitor - New Relic integration
|
|
398
357
|
✅ cqrs-implementer - CQRS pattern implementation
|
|
399
358
|
```
|
|
@@ -410,38 +369,38 @@ Custom Skills:
|
|
|
410
369
|
|
|
411
370
|
2. Route to increment-planner:
|
|
412
371
|
Input: "Real-time chat feature"
|
|
413
|
-
Output:
|
|
372
|
+
Output: .specweave/increments/0004-realtime-chat/
|
|
414
373
|
- spec.md (5 user stories)
|
|
415
374
|
- plan.md (WebSocket architecture)
|
|
416
375
|
- tasks.md (78 tasks)
|
|
417
376
|
- tests.md (20 test cases)
|
|
418
377
|
|
|
419
378
|
3. Detect next request: User likely wants to implement
|
|
420
|
-
Prompt: "
|
|
379
|
+
Prompt: "Increment 0004 created. Would you like to:
|
|
421
380
|
1. Review the plan
|
|
422
381
|
2. Start implementation
|
|
423
|
-
3. Load context for this
|
|
382
|
+
3. Load context for this increment"
|
|
424
383
|
|
|
425
384
|
4. User chooses 2 (Start implementation)
|
|
426
385
|
|
|
427
386
|
5. Route to context-loader:
|
|
428
|
-
Load:
|
|
387
|
+
Load: .specweave/increments/0004-realtime-chat/context-manifest.yaml
|
|
429
388
|
Output: Loaded specs/modules/realtime/**, architecture/websockets.md
|
|
430
389
|
|
|
431
|
-
6. Route to
|
|
432
|
-
Input:
|
|
390
|
+
6. Route to implementation:
|
|
391
|
+
Input: .specweave/increments/0004-realtime-chat/tasks.md
|
|
433
392
|
Context: Loaded specs
|
|
434
393
|
Output: Implement Phase 1 (Setup WebSocket server)
|
|
435
394
|
|
|
436
|
-
7. After implementation,
|
|
437
|
-
Input:
|
|
438
|
-
Output: Generate test suite
|
|
395
|
+
7. After implementation, coordinate testing:
|
|
396
|
+
Input: .specweave/increments/0004-realtime-chat/tests.md
|
|
397
|
+
Output: Generate test suite (E2E with Playwright)
|
|
439
398
|
|
|
440
|
-
8. Finally,
|
|
441
|
-
Update: docs/
|
|
399
|
+
8. Finally, update documentation:
|
|
400
|
+
Update: .specweave/docs/internal/architecture/api.md (add WebSocket endpoints)
|
|
442
401
|
|
|
443
402
|
9. Return to user:
|
|
444
|
-
✅
|
|
403
|
+
✅ Increment 0004 implemented, tested, and documented
|
|
445
404
|
```
|
|
446
405
|
|
|
447
406
|
## Best Practices
|
|
@@ -466,11 +425,11 @@ For multi-step operations, confirm before proceeding:
|
|
|
466
425
|
You want to "create and implement a payment feature".
|
|
467
426
|
|
|
468
427
|
This will:
|
|
469
|
-
1. Create
|
|
470
|
-
2. Load relevant specs (context-loader)
|
|
471
|
-
3. Implement code (
|
|
472
|
-
4. Generate tests (
|
|
473
|
-
5. Update documentation (
|
|
428
|
+
1. Create Increment 0003 (increment-planner skill)
|
|
429
|
+
2. Load relevant specs (context-loader skill)
|
|
430
|
+
3. Implement code (nodejs-backend skill + security agent)
|
|
431
|
+
4. Generate tests (QA Lead agent)
|
|
432
|
+
5. Update documentation (Docs Writer agent)
|
|
474
433
|
|
|
475
434
|
Estimated time: 15-30 minutes
|
|
476
435
|
|
|
@@ -529,12 +488,12 @@ if (specweaveDetectorActive()) {
|
|
|
529
488
|
- Given: User says "Plan a feature for authentication"
|
|
530
489
|
- When: specweave-detector parses request
|
|
531
490
|
- Then: Routes to increment-planner
|
|
532
|
-
- And: increment-planner creates
|
|
491
|
+
- And: increment-planner creates Increment 000X (.specweave/increments/000X-authentication/)
|
|
533
492
|
|
|
534
493
|
### TC-003: Route Complex Request
|
|
535
494
|
- Given: User says "Create and implement payment feature"
|
|
536
495
|
- When: specweave-detector parses request
|
|
537
|
-
- Then: Orchestrates: increment-planner → context-loader →
|
|
496
|
+
- Then: Orchestrates: increment-planner → context-loader → implementation (with agents) → testing → documentation
|
|
538
497
|
- And: All steps complete successfully
|
|
539
498
|
|
|
540
499
|
### TC-004: Handle Ambiguous Request
|
|
@@ -142,10 +142,10 @@ project-root/
|
|
|
142
142
|
│ │ └── reports/ # ✅ Analysis, reports
|
|
143
143
|
│ └── tests/ # Centralized test repository
|
|
144
144
|
│
|
|
145
|
-
├── .claude/ #
|
|
146
|
-
│ ├── agents/ #
|
|
147
|
-
│ ├── skills/ #
|
|
148
|
-
│ └── commands/ #
|
|
145
|
+
├── .claude/ # Pre-installed components
|
|
146
|
+
│ ├── agents/ # 10 agents ready to use
|
|
147
|
+
│ ├── skills/ # 35+ skills ready to use
|
|
148
|
+
│ └── commands/ # 10 slash commands
|
|
149
149
|
│
|
|
150
150
|
├── CLAUDE.md # This file (ONLY file we add)
|
|
151
151
|
└── src/ # Your source code (unchanged)
|
|
@@ -197,7 +197,7 @@ backlog → planned → in-progress → completed → closed
|
|
|
197
197
|
|
|
198
198
|
## Agents (Activate Automatically)
|
|
199
199
|
|
|
200
|
-
**Strategic Agents** (installed
|
|
200
|
+
**Strategic Agents** (pre-installed & ready to use):
|
|
201
201
|
|
|
202
202
|
| Agent | Purpose | Activates When |
|
|
203
203
|
|-------|---------|----------------|
|
|
@@ -206,23 +206,14 @@ backlog → planned → in-progress → completed → closed
|
|
|
206
206
|
| `security` | Threat modeling | Security review |
|
|
207
207
|
| `qa-lead` | Test strategy | Testing |
|
|
208
208
|
| `devops` | Infrastructure, deployment | Deployment needed |
|
|
209
|
+
| `tech-lead` | Code review | Code review |
|
|
210
|
+
| `sre` | Incident response | Troubleshooting |
|
|
211
|
+
| `docs-writer` | Documentation | Writing docs |
|
|
212
|
+
| `performance` | Performance optimization | Optimization needed |
|
|
209
213
|
|
|
210
|
-
**
|
|
214
|
+
**All 10 agents are pre-installed** - Claude uses the right one based on your request!
|
|
211
215
|
|
|
212
|
-
|
|
213
|
-
- `python-backend` - Python APIs (FastAPI, Django)
|
|
214
|
-
{#ENDIF}
|
|
215
|
-
{#IF_NODEJS}
|
|
216
|
-
- `nodejs-backend` - Node.js APIs (Express, NestJS)
|
|
217
|
-
{#ENDIF}
|
|
218
|
-
{#IF_NEXTJS}
|
|
219
|
-
- `nextjs` - Next.js applications
|
|
220
|
-
{#ENDIF}
|
|
221
|
-
{#IF_FRONTEND}
|
|
222
|
-
- `frontend` - React/Vue/Angular frontend
|
|
223
|
-
{#ENDIF}
|
|
224
|
-
|
|
225
|
-
**See**: `.claude/agents/` for all installed agents
|
|
216
|
+
**See**: `.claude/agents/` for complete list
|
|
226
217
|
|
|
227
218
|
---
|
|
228
219
|
|
|
@@ -237,13 +228,25 @@ backlog → planned → in-progress → completed → closed
|
|
|
237
228
|
| `context-loader` | Load context selectively | Working on increments |
|
|
238
229
|
| `skill-router` | Route to appropriate skill | Ambiguous requests |
|
|
239
230
|
|
|
240
|
-
**
|
|
231
|
+
**Technology Skills** (all pre-installed):
|
|
232
|
+
|
|
233
|
+
| Skill | Purpose | Activates When |
|
|
234
|
+
|-------|---------|----------------|
|
|
235
|
+
| `nodejs-backend` | Node.js/Express/NestJS | Node.js backend requests |
|
|
236
|
+
| `python-backend` | Python/FastAPI/Django | Python backend requests |
|
|
237
|
+
| `nextjs` | Next.js App Router | Next.js requests |
|
|
238
|
+
| `frontend` | React/Vue/Angular | Frontend requests |
|
|
239
|
+
| `dotnet-backend` | ASP.NET Core | .NET requests |
|
|
240
|
+
|
|
241
|
+
**Integration Skills** (all pre-installed):
|
|
242
|
+
|
|
243
|
+
| Skill | Purpose | Activates When |
|
|
244
|
+
|-------|---------|----------------|
|
|
245
|
+
| `jira-sync` | Sync with JIRA | JIRA integration needed |
|
|
246
|
+
| `github-sync` | Sync with GitHub | GitHub integration needed |
|
|
247
|
+
| `hetzner-provisioner` | Deploy to Hetzner | Hetzner deployment needed |
|
|
241
248
|
|
|
242
|
-
|
|
243
|
-
|-------|---------|-----------------|
|
|
244
|
-
| `jira-sync` | Sync with JIRA | `npx specweave install jira-sync` |
|
|
245
|
-
| `github-sync` | Sync with GitHub | `npx specweave install github-sync` |
|
|
246
|
-
| `hetzner-provisioner` | Deploy to Hetzner | `npx specweave install hetzner-provisioner` |
|
|
249
|
+
**See**: `.claude/skills/` for complete list of 35+ skills!
|
|
247
250
|
|
|
248
251
|
---
|
|
249
252
|
|
|
@@ -20,13 +20,13 @@ Your project is initialized! Now describe what you want to build.
|
|
|
20
20
|
|
|
21
21
|
3. **SpecWeave will automatically**:
|
|
22
22
|
- Detect your tech stack (or ask you to choose)
|
|
23
|
-
-
|
|
23
|
+
- Use the right agents & skills (all pre-installed!)
|
|
24
24
|
- Create strategic documentation
|
|
25
25
|
- Generate specifications
|
|
26
26
|
- Build the implementation
|
|
27
27
|
- Write tests
|
|
28
28
|
|
|
29
|
-
That's it!
|
|
29
|
+
That's it! All components ready - just describe what you want!
|
|
30
30
|
|
|
31
31
|
---
|
|
32
32
|
|
|
@@ -40,14 +40,14 @@ That's it! No manual configuration needed.
|
|
|
40
40
|
│ ├── docs/ # Documentation (generated)
|
|
41
41
|
│ └── tests/ # Tests (generated)
|
|
42
42
|
├── .claude/
|
|
43
|
-
│ ├── commands/ # Slash commands (
|
|
44
|
-
│ ├── agents/ # AI agents (
|
|
45
|
-
│ └── skills/ # AI skills (
|
|
43
|
+
│ ├── commands/ # Slash commands (10 installed)
|
|
44
|
+
│ ├── agents/ # AI agents (9 installed & ready)
|
|
45
|
+
│ └── skills/ # AI skills (30+ installed & ready)
|
|
46
46
|
├── CLAUDE.md # Instructions for Claude
|
|
47
47
|
└── README.md # This file
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
**Note**:
|
|
50
|
+
**Note**: All agents and skills are pre-installed and ready to use!
|
|
51
51
|
|
|
52
52
|
---
|
|
53
53
|
|
|
@@ -56,7 +56,7 @@ That's it! No manual configuration needed.
|
|
|
56
56
|
SpecWeave is a spec-driven development framework where:
|
|
57
57
|
- **Specifications are the source of truth** (code follows specs)
|
|
58
58
|
- **AI agents work autonomously** (PM, Architect, Security, QA, DevOps)
|
|
59
|
-
- **
|
|
59
|
+
- **All components pre-installed** (10 agents + 35+ skills ready!)
|
|
60
60
|
- **Works with ANY tech stack** (TypeScript, Python, Go, Rust, etc.)
|
|
61
61
|
|
|
62
62
|
---
|