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.
@@ -1,99 +1,69 @@
1
1
  ---
2
2
  name: specweave-detector
3
- description: Entry point for SpecWeave framework. Automatically activates when .specweave directory is detected in the project. Acts as a factory of agents, parsing user requests and routing to appropriate skills. Supports nested skill calls and context management. This skill should ALWAYS be loaded first in SpecWeave projects. Activates for ANY user request in a SpecWeave project (auto-detects .specweave/).
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 **automatic entry point** for all SpecWeave operations. When Claude Code detects a `.specweave/config.yaml` file, this skill activates and orchestrates the SpecWeave framework.
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
- // AUTO-INSTALL MISSING COMPONENTS (NEW!)
29
- await autoInstallComponents(userPrompt);
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
- ## Just-In-Time Component Installation (CRITICAL!)
41
+ ## Pre-Installed Components (0.1.5+)
37
42
 
38
- **SpecWeave uses intelligent auto-installation** - components are installed on-demand based on user intent.
43
+ **IMPORTANT**: SpecWeave 0.1.5+ uses **pre-installation** instead of auto-installation.
39
44
 
40
- ### How It Works
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
- 1. **User makes a request** (e.g., "Create Next.js authentication")
43
- 2. **Analyze user intent** - Extract keywords (Next.js, authentication)
44
- 3. **Map to required components**:
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
- ### Example User Experience
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: Already Installed**
83
+ **Example 2: Real Estate Platform**
115
84
  ```
116
- User: "Add another Next.js feature"
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 0002-next-feature...
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
- ### Configuration
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
- Set `auto_install: false` to require manual installation (advanced users only).
112
+ ### Benefits of Pre-Installation (0.1.5+)
159
113
 
160
- ### Installation Process
161
-
162
- When auto-installing:
163
-
164
- 1. **Find npm package**: Locate `node_modules/specweave/`
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 Feature 002
139
+ # 4. increment-planner creates Increment 0002
198
140
  # 5. Returns result to user
199
141
 
200
142
  # User sees:
201
- Feature created: 002-payment-processing
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 feature → `increment-planner`
224
- 2. Implement code → Load context via `context-loader`
225
- 3. Implement code → `developer`
226
- 4. Generate tests → `qa-engineer`
227
- 5. Update docs → `docs-updater`
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 003-payment-processing/
179
+ increment-planner: Create .specweave/increments/0003-payment-processing/
238
180
 
239
- context-loader: Load specs/modules/payments/**
181
+ context-loader: Load .specweave/docs/internal/strategy/payments/**
240
182
 
241
- developer: Implement based on tasks.md
183
+ Implementation: Use nodejs-backend skill + security agent
242
184
 
243
- qa-engineer: Generate test cases
185
+ Testing: Use QA Lead agent (generate E2E tests)
244
186
 
245
- docs-updater: Update README, docs/
187
+ Documentation: Update .specweave/docs/internal/architecture/
246
188
 
247
- Result: "✅ Feature 003 implemented and documented"
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 a feature:
214
+ When a user is working on an increment:
273
215
 
274
216
  ```javascript
275
- // Detect active work
276
- const activeIssue = detectActiveIssue(); // work/issues/###-xxx/
217
+ // Detect active increment
218
+ const activeIncrement = detectActiveIncrement(); // .specweave/increments/####-xxx/
277
219
 
278
- if (activeIssue) {
279
- const manifest = loadManifest(`${activeIssue}/context-manifest.yaml`);
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 work item** (in `work/issues/`)
290
- 2. **Current feature** (referenced in git branch)
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 (specs/overview.md, principles.md)
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 feature 005"
274
+ User: "Implement increment 0005"
333
275
 
334
- specweave-detector: Route to developer
276
+ specweave-detector: Route to implementation
335
277
 
336
- developer: ERROR - Feature 005 not found
278
+ ERROR: Increment 0005 not found
337
279
 
338
280
  specweave-detector: Catch error, suggest:
339
- "Feature 005 doesn't exist. Would you like to:
340
- 1. Create it first (increment-planner)
341
- 2. List existing features
342
- 3. Implement a different feature"
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
- skills:
357
- install_location: "local" # Where skills are installed
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 features ↔ GitHub issues
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
- 📦 spec-author - Create specifications (install with: npx specweave install spec-author)
394
- 📦 architect - System design (install with: npx specweave install architect)
395
-
396
- Custom Skills:
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: features/004-realtime-chat/
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: "Feature 004 created. Would you like to:
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 feature"
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: features/004-realtime-chat/context-manifest.yaml
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 developer:
432
- Input: features/004-realtime-chat/tasks.md
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, route to qa-engineer:
437
- Input: features/004-realtime-chat/tests.md
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, route to docs-updater:
441
- Update: docs/reference/api.md (add WebSocket endpoints)
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
- Feature 004 implemented, tested, and documented
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 Feature 003 (increment-planner)
470
- 2. Load relevant specs (context-loader)
471
- 3. Implement code (developer)
472
- 4. Generate tests (qa-engineer)
473
- 5. Update documentation (docs-updater)
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 Feature 00X
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 → developerqa-engineerdocs-updater
496
+ - Then: Orchestrates: increment-planner → context-loader → implementation (with agents) testingdocumentation
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/ # Installed agents/skills
146
- │ ├── agents/ # Selective installation
147
- │ ├── skills/ # Selective installation
148
- │ └── commands/ # Slash 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 for all projects):
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
- **Implementation Agents** (installed based on your tech stack):
214
+ **All 10 agents are pre-installed** - Claude uses the right one based on your request!
211
215
 
212
- {#IF_PYTHON}
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
- **Integration Skills** (optional, install when needed):
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
- | Skill | Purpose | Install Command |
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
- - Install needed agents & skills on-demand
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! No manual configuration needed.
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 (/create-increment, etc.)
44
- │ ├── agents/ # AI agents (auto-installed on-demand)
45
- │ └── skills/ # AI skills (auto-installed on-demand)
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**: Agents and skills are NOT pre-installed. They install automatically when you describe your project!
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
- - **Components auto-install on-demand** (no manual setup)
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
  ---