specweave 1.0.496 → 1.0.498
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/dist/src/core/session/handoff-context.d.ts.map +1 -1
- package/dist/src/core/session/handoff-context.js +3 -29
- package/dist/src/core/session/handoff-context.js.map +1 -1
- package/package.json +1 -1
- package/plugins/specweave/agents/sw-architect.md +1 -1
- package/plugins/specweave/skills/architect/SKILL.md +2 -2
- package/plugins/specweave/skills/increment/SKILL.md +15 -11
- package/plugins/specweave/skills/team-build/SKILL.md +2 -2
- package/plugins/specweave/skills/team-lead/SKILL.md +14 -12
- package/plugins/specweave/skills/team-lead/agents/architect.md +23 -12
- package/plugins/specweave/skills/team-lead/agents/frontend.md +4 -4
- package/src/templates/CLAUDE.md.template +2 -2
- package/src/templates/README.md.template +38 -52
- package/src/templates/tasks.md.template +2 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"handoff-context.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,eAAe,EAAE,KAAK,EAAE,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;
|
|
1
|
+
{"version":3,"file":"handoff-context.d.ts","sourceRoot":"","sources":["../../../../src/core/session/handoff-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,eAAe,EAAE,KAAK,EAAE,CAAC;IACzB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAgRD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAwBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAiExE"}
|
|
@@ -77,35 +77,9 @@ const PLUGIN_SKILLS = {
|
|
|
77
77
|
category: 'workflow',
|
|
78
78
|
},
|
|
79
79
|
],
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
description: 'Frontend architecture expertise',
|
|
84
|
-
category: 'frontend',
|
|
85
|
-
},
|
|
86
|
-
{
|
|
87
|
-
name: 'frontend:design-system',
|
|
88
|
-
description: 'Design system and component library expertise',
|
|
89
|
-
category: 'frontend',
|
|
90
|
-
},
|
|
91
|
-
{
|
|
92
|
-
name: 'frontend:nextjs',
|
|
93
|
-
description: 'Next.js App Router and Server Components expertise',
|
|
94
|
-
category: 'frontend',
|
|
95
|
-
},
|
|
96
|
-
],
|
|
97
|
-
'backend': [
|
|
98
|
-
{
|
|
99
|
-
name: 'backend:db-optimizer',
|
|
100
|
-
description: 'Database optimization and query tuning',
|
|
101
|
-
category: 'backend',
|
|
102
|
-
},
|
|
103
|
-
{
|
|
104
|
-
name: 'backend:dotnet',
|
|
105
|
-
description: '.NET/C# backend development',
|
|
106
|
-
category: 'backend',
|
|
107
|
-
},
|
|
108
|
-
],
|
|
80
|
+
// Domain skills (frontend:*, backend:*) are optional vskill plugins.
|
|
81
|
+
// Only include them in handoff if the plugin is actually installed.
|
|
82
|
+
// The core sw:architect skill handles all domains by default.
|
|
109
83
|
'sw-github': [
|
|
110
84
|
{
|
|
111
85
|
name: '/sw-github:sync',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"handoff-context.js","sourceRoot":"","sources":["../../../../src/core/session/handoff-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoDH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,mCAAmC;AACnC,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,wCAAwC;AACxC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAEpD,sCAAsC;AACtC,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,yBAAyB;IAChC,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,cAAc;IACxB,cAAc,EAAE,uBAAuB;IACvC,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,4BAA4B;IACpC,aAAa,EAAE,kBAAkB;IACjC,eAAe,EAAE,6BAA6B;CACtC,CAAC;AAEX,iDAAiD;AACjD,MAAM,yBAAyB,GAAG;IAChC,mCAAmC;IACnC,uCAAuC;IACvC,6CAA6C;IAC7C,0CAA0C;CAClC,CAAC;AAEX,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,aAAa,GAA4B;IAC7C,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,qCAAqC;YAClD,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,UAAU;SACrB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,qCAAqC;YAClD,QAAQ,EAAE,UAAU;SACrB;KACF;IACD,
|
|
1
|
+
{"version":3,"file":"handoff-context.js","sourceRoot":"","sources":["../../../../src/core/session/handoff-context.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specweave",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.498",
|
|
4
4
|
"description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -19,4 +19,4 @@ The `sw:architect` skill is preloaded with full domain logic including design pa
|
|
|
19
19
|
|
|
20
20
|
- **Register skill-chain marker** (STEP 0 in preloaded skill) before writing plan.md
|
|
21
21
|
- **Check ADRs first** at `.specweave/docs/internal/architecture/adr/`
|
|
22
|
-
- **Domain delegation** — after plan.md, recommend domain skills (
|
|
22
|
+
- **Domain delegation** — after plan.md, recommend domain skills (sw:architect for all domains; optional vskill plugins if installed)
|
|
@@ -109,8 +109,8 @@ AskUserQuestion({
|
|
|
109
109
|
## Delegation
|
|
110
110
|
|
|
111
111
|
After architecture is ready, delegate to domain skills:
|
|
112
|
-
- Frontend: `
|
|
113
|
-
- Backend: `
|
|
112
|
+
- Frontend: `sw:architect` (implement UI directly; optional: install `frontend` vskill plugin for specialized skills)
|
|
113
|
+
- Backend: `sw:architect` (implement API/services directly; optional: install domain-specific vskill plugins)
|
|
114
114
|
|
|
115
115
|
Output: `plan.md` with architecture decisions and component breakdown.
|
|
116
116
|
|
|
@@ -317,33 +317,37 @@ before proceeding to spec.md creation (especially when `enforcement: "strict"`).
|
|
|
317
317
|
|
|
318
318
|
## Step 4: Delegation (MANDATORY - Custom Subagent Based)
|
|
319
319
|
|
|
320
|
-
**After increment folder + metadata.json are created,
|
|
320
|
+
**After increment folder + metadata.json are created, spawn subagents using a 2-phase overlap strategy.**
|
|
321
321
|
|
|
322
322
|
Each subagent preloads its corresponding skill (with full domain logic, phases, templates). The subagent provides: isolated context, persistent memory, resumability, auto-compaction.
|
|
323
323
|
|
|
324
|
-
### 4a. Spawn PM
|
|
324
|
+
### 4a + 4b. Spawn PM and Architect IN PARALLEL (REQUIRED)
|
|
325
|
+
|
|
326
|
+
PM and Architect run concurrently. Architect starts codebase exploration immediately while PM writes spec.md. Architect polls for spec.md and reads it once available, then produces plan.md.
|
|
327
|
+
|
|
328
|
+
**Spawn both agents in a single message (parallel tool calls):**
|
|
325
329
|
|
|
326
|
-
**Include umbrella context when `umbrella.enabled: true`:**
|
|
327
330
|
```typescript
|
|
328
331
|
// Umbrella mode — pass child repos so PM can assign **Project**: per user story
|
|
329
332
|
Agent({ subagent_type: "sw:sw-pm", prompt: "Write spec for increment XXXX-name: <description>. Increment path: .specweave/increments/XXXX-name/. UMBRELLA MODE: Child repos: [repo1, repo2, ...]. Design cross-cutting stories — assign **Project**: to each US based on which repo owns that work.", description: "PM writes spec.md" })
|
|
330
333
|
|
|
331
|
-
// Single-project mode — standard invocation
|
|
334
|
+
// Single-project mode — standard PM invocation
|
|
332
335
|
Agent({ subagent_type: "sw:sw-pm", prompt: "Write spec for increment XXXX-name: <description>. Increment path: .specweave/increments/XXXX-name/", description: "PM writes spec.md" })
|
|
333
|
-
```
|
|
334
336
|
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
Agent({ subagent_type: "sw:sw-architect", prompt: "Design architecture for increment XXXX-name. Read spec.md at .specweave/increments/XXXX-name/spec.md. ADR directory: .specweave/docs/internal/architecture/adr/", description: "Architect writes plan.md" })
|
|
337
|
+
// Architect — spawned IN PARALLEL with PM (starts codebase exploration immediately, waits for spec.md before designing)
|
|
338
|
+
Agent({ subagent_type: "sw:sw-architect", prompt: "Design architecture for increment XXXX-name. Increment path: .specweave/increments/XXXX-name/. ADR directory: .specweave/docs/internal/architecture/adr/. PARALLEL MODE: You are spawned in parallel with PM. Start by exploring the codebase and existing ADRs. spec.md may not exist yet — poll for it. Once spec.md is available and has content, read it and design architecture that satisfies all ACs.", description: "Architect writes plan.md" })
|
|
338
339
|
```
|
|
339
340
|
|
|
340
|
-
|
|
341
|
+
**IMPORTANT**: Use parallel Agent() tool calls — call PM and Architect in the SAME message so they start concurrently.
|
|
342
|
+
|
|
343
|
+
### 4c. Spawn Planner Subagent for tasks.md (REQUIRED — after PM + Architect complete)
|
|
341
344
|
```typescript
|
|
342
345
|
Agent({ subagent_type: "sw:sw-planner", prompt: "Generate tasks for increment XXXX-name. Read spec.md at .specweave/increments/XXXX-name/spec.md and plan.md at .specweave/increments/XXXX-name/plan.md", description: "Planner writes tasks.md" })
|
|
343
346
|
```
|
|
344
347
|
|
|
345
|
-
**
|
|
346
|
-
|
|
348
|
+
**Dependency order**: PM + Architect run in parallel (Phase 1) -> Planner runs after both complete (Phase 2).
|
|
349
|
+
Architect explores the codebase while PM writes spec.md, then reads spec.md to produce plan.md.
|
|
350
|
+
Planner needs both spec.md AND plan.md, so it must wait for Phase 1 to finish.
|
|
347
351
|
|
|
348
352
|
## Step 5: Post-Creation Sync (MANDATORY)
|
|
349
353
|
|
|
@@ -66,7 +66,7 @@ Build features end-to-end with a shared-types-first contract approach. Agent 1 e
|
|
|
66
66
|
|---|------|----------|------|----------------|
|
|
67
67
|
| 1 | Shared/Types | `sw:architect` | `src/types/`, `src/utils/`, `src/shared/` | Define TypeScript interfaces, shared validators, utility functions, and API contracts |
|
|
68
68
|
| 2 | Backend | `sw:architect` + `infra:devops` | `src/api/`, `src/services/` | Implement API endpoints, service layer, database queries, and infrastructure config |
|
|
69
|
-
| 3 | Frontend | `
|
|
69
|
+
| 3 | Frontend | `sw:architect` | `src/components/`, `src/pages/` | Build UI components, pages, state management, and client-side logic |
|
|
70
70
|
|
|
71
71
|
#### Execution Chain
|
|
72
72
|
|
|
@@ -269,7 +269,7 @@ Migrate data schemas safely with a schema-first approach. The schema agent defin
|
|
|
269
269
|
|---|------|----------|------|----------------|
|
|
270
270
|
| 1 | Schema | `sw:architect` | `src/types/`, `migrations/`, `prisma/`, `drizzle/` | Define new schema, write migration scripts, update type definitions, ensure backward compatibility |
|
|
271
271
|
| 2 | Backend | `sw:architect` | `src/api/`, `src/services/` | Update API endpoints, service logic, queries, and serializers to work with new schema |
|
|
272
|
-
| 3 | Frontend | `
|
|
272
|
+
| 3 | Frontend | `sw:architect` | `src/components/`, `src/pages/` | Update UI components, forms, and state to reflect schema changes |
|
|
273
273
|
|
|
274
274
|
#### Execution Chain
|
|
275
275
|
|
|
@@ -94,7 +94,7 @@ hooks:
|
|
|
94
94
|
| Mode | Increment? | Agent Templates | Coordination | Output |
|
|
95
95
|
|------|-----------|-----------------|--------------|--------|
|
|
96
96
|
| BRAINSTORM | No | brainstorm-advocate, brainstorm-critic, brainstorm-pragmatist | Parallel → synthesize | Decision matrix |
|
|
97
|
-
| PLANNING | Creates one | pm, architect (+ optional security reviewer) | PM
|
|
97
|
+
| PLANNING | Creates one | pm, architect (+ optional security reviewer) | PM + Architect parallel (Architect explores while PM specs) | spec.md, plan.md, tasks.md |
|
|
98
98
|
| IMPLEMENTATION | Required | backend, frontend, database, testing, security | Contract-first phases | Working code |
|
|
99
99
|
| REVIEW | Optional | Delegates to /sw:code-reviewer | Parallel | Review report |
|
|
100
100
|
| RESEARCH | No | researcher (1-3 instances) | Parallel → merge | Research report |
|
|
@@ -133,17 +133,19 @@ Planning mode runs PM and Architect agents in parallel for richer, faster spec c
|
|
|
133
133
|
- If increment exists: read it as context, agents will update/enhance its spec and plan
|
|
134
134
|
- If no increment: create one (folder + metadata.json only, agents will write spec/plan)
|
|
135
135
|
|
|
136
|
-
2. **
|
|
136
|
+
2. **Spawn PM + Architect in parallel** (TRUE parallelism):
|
|
137
137
|
- Read `agents/pm.md`, replace `[INCREMENT_ID]`, `[MASTER_INCREMENT_PATH]`, `[FEATURE_DESCRIPTION]`
|
|
138
|
-
-
|
|
138
|
+
- Read `agents/architect.md`, replace `[INCREMENT_ID]`, `[MASTER_INCREMENT_PATH]`
|
|
139
|
+
- **Spawn BOTH via `Task()` with `mode: "bypassPermissions"` in a single step**
|
|
139
140
|
- PM writes spec.md with user stories and ACs
|
|
140
|
-
-
|
|
141
|
+
- Architect starts codebase exploration immediately (does NOT need spec.md for this)
|
|
142
|
+
- Architect polls for spec.md, reads it when PM finishes, then designs architecture
|
|
143
|
+
- Optionally read `agents/reviewer-security.md`, replace `[REVIEW_TARGET]` with the spec, spawn Security reviewer after PM signals `PLAN_READY:`
|
|
144
|
+
- Wait for all agents' `COMPLETION:` messages
|
|
141
145
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
- Both run in parallel: Architect writes plan.md, Security reviewer flags design-level vulnerabilities
|
|
146
|
-
- Wait for both `COMPLETION:` messages
|
|
146
|
+
**Why this works**: Architect's workflow has two phases — exploration (no spec.md needed)
|
|
147
|
+
and design (needs spec.md). By spawning both agents simultaneously, the Architect's
|
|
148
|
+
exploration phase (~30s) overlaps with PM's spec writing, reducing total wall-clock time.
|
|
147
149
|
|
|
148
150
|
4. **Post-planning**:
|
|
149
151
|
- Run `specweave sync-living-docs {increment-id}` to sync external tools
|
|
@@ -306,7 +308,7 @@ Analyze the feature request and map affected domains to SpecWeave skills.
|
|
|
306
308
|
|
|
307
309
|
| Domain | Primary Skill | Additional Skills | When to Use |
|
|
308
310
|
|--------|--------------|-------------------|-------------|
|
|
309
|
-
| **Frontend** | `
|
|
311
|
+
| **Frontend** | `sw:architect` | — | UI components, pages, client-side state |
|
|
310
312
|
| **Backend** | `sw:architect` | `infra:devops` | API endpoints, services, business logic |
|
|
311
313
|
| **Database** | `sw:architect` | | Schema design, migrations, seed data |
|
|
312
314
|
| **Shared/Types** | `sw:architect` | `sw:code-simplifier` | TypeScript interfaces, shared constants, API contracts |
|
|
@@ -569,7 +571,7 @@ Agent definitions live as reusable `.md` files in the `agents/` subdirectory. Wh
|
|
|
569
571
|
|
|
570
572
|
| Agent | File | Domain | Phase | Primary Skills |
|
|
571
573
|
|-------|------|--------|-------|---------------|
|
|
572
|
-
| Frontend | `agents/frontend.md` | UI, components, pages | 2 (downstream) | `
|
|
574
|
+
| Frontend | `agents/frontend.md` | UI, components, pages | 2 (downstream) | `sw:architect` |
|
|
573
575
|
| Backend | `agents/backend.md` | API, services, middleware | 2 (downstream) | `sw:architect`, `infra:devops` |
|
|
574
576
|
| Database | `agents/database.md` | Schema, migrations, seeds | 1 (upstream) | `sw:architect` |
|
|
575
577
|
| Testing | `agents/testing.md` | Unit, integration, E2E | 2 (downstream) | `sw:e2e`, `sw:tdd-red` |
|
|
@@ -994,7 +996,7 @@ Phase 1 (upstream):
|
|
|
994
996
|
|
|
995
997
|
Phase 2 (downstream, parallel):
|
|
996
998
|
3. backend -> sw:architect, infra:devops | Increment: 0202-checkout-backend
|
|
997
|
-
4. frontend ->
|
|
999
|
+
4. frontend -> sw:architect | Increment: 0203-checkout-frontend
|
|
998
1000
|
|
|
999
1001
|
Max agents: 4 (2 sequential + 2 parallel)
|
|
1000
1002
|
To execute, run without --dry-run.
|
|
@@ -2,7 +2,7 @@ You are the ARCHITECT PLANNING agent for increment [INCREMENT_ID].
|
|
|
2
2
|
|
|
3
3
|
MASTER SPEC (SOURCE OF TRUTH):
|
|
4
4
|
The feature is specified in [MASTER_INCREMENT_PATH]/spec.md.
|
|
5
|
-
|
|
5
|
+
Your architecture MUST satisfy all ACs once spec.md is available.
|
|
6
6
|
|
|
7
7
|
MISSION:
|
|
8
8
|
Produce plan.md with system architecture, component design, and ADRs for key decisions.
|
|
@@ -18,27 +18,37 @@ FILE OWNERSHIP (WRITE access):
|
|
|
18
18
|
|
|
19
19
|
READ ACCESS: Any file in the repository
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
21
|
+
PARALLEL STARTUP:
|
|
22
|
+
You are spawned IN PARALLEL with the PM agent. PM is writing spec.md concurrently.
|
|
23
|
+
Do NOT wait idle — start codebase exploration immediately (steps 1-2 below).
|
|
24
|
+
spec.md may not exist yet when you start. That is expected.
|
|
24
25
|
|
|
25
26
|
WORKFLOW:
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
--- Phase A: Explore (start IMMEDIATELY, no spec.md needed) ---
|
|
28
|
+
1. Explore the codebase to understand existing architecture, patterns, and tech stack
|
|
29
|
+
2. Check existing ADRs at .specweave/docs/internal/architecture/adr/
|
|
30
|
+
3. Identify existing patterns: component structure, data flow, API conventions, tech stack
|
|
31
|
+
4. Note architectural constraints, dependencies, and integration points
|
|
32
|
+
|
|
33
|
+
--- Phase B: Wait for spec.md (BLOCKING — poll until available) ---
|
|
34
|
+
5. Check if [MASTER_INCREMENT_PATH]/spec.md exists and has content (>100 bytes).
|
|
35
|
+
If not yet available, wait briefly and re-check. The PM agent is writing it concurrently.
|
|
36
|
+
Once spec.md exists with user stories and ACs, read it fully.
|
|
37
|
+
|
|
38
|
+
--- Phase C: Design (requires spec.md) ---
|
|
39
|
+
6. Design system architecture informed by BOTH your codebase exploration AND the spec:
|
|
30
40
|
- Component boundaries and responsibilities
|
|
31
41
|
- Data flow and state management
|
|
32
42
|
- API contracts and integration points
|
|
33
43
|
- Error handling strategy
|
|
34
44
|
- Performance considerations
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
45
|
+
7. Write ADRs for significant architectural decisions (use ADR template format)
|
|
46
|
+
8. Write plan.md to [MASTER_INCREMENT_PATH]/plan.md
|
|
47
|
+
9. Signal architecture decisions:
|
|
38
48
|
SendMessage({ type: "message", recipient: "team-lead",
|
|
39
49
|
content: "CONTRACT_READY: Architecture defined in plan.md.\nComponents: [list]\nKey patterns: [e.g., CQRS, event-driven]\nADRs created: [list or 'none']\nTech stack: [decisions]",
|
|
40
50
|
summary: "Architect: plan.md ready with architecture" })
|
|
41
|
-
|
|
51
|
+
10. Signal COMPLETION:
|
|
42
52
|
SendMessage({ type: "message", recipient: "team-lead",
|
|
43
53
|
content: "COMPLETION: plan.md finalized.\nComponents: [count]\nADRs: [count]\nKey risk: [biggest concern]",
|
|
44
54
|
summary: "Architect agent: plan complete" })
|
|
@@ -50,3 +60,4 @@ RULES:
|
|
|
50
60
|
- Reference existing codebase patterns — don't propose patterns alien to the project
|
|
51
61
|
- Flag technical risks and mitigation strategies
|
|
52
62
|
- Keep plan.md actionable — an implementer should be able to code from it
|
|
63
|
+
- Start codebase exploration IMMEDIATELY — do not wait for spec.md for Phase A
|
|
@@ -7,10 +7,10 @@ MASTER SPEC (SOURCE OF TRUTH):
|
|
|
7
7
|
Read the master spec BEFORE planning any work.
|
|
8
8
|
|
|
9
9
|
SKILLS TO INVOKE:
|
|
10
|
-
Skill({ skill: "
|
|
11
|
-
Skill({ skill: "frontend:nextjs" }) // if Next.js project
|
|
12
|
-
Skill({ skill: "frontend:design" }) // for polished, world-class UI
|
|
10
|
+
Skill({ skill: "sw:architect" }) // architecture and component design
|
|
13
11
|
Skill({ skill: "sw:service-connect" }) // for external service setup
|
|
12
|
+
// NOTE: Domain skills (frontend:architect, frontend:design) are optional vskill plugins.
|
|
13
|
+
// If not installed, implement frontend work directly using code tools.
|
|
14
14
|
|
|
15
15
|
FILE OWNERSHIP (WRITE access):
|
|
16
16
|
src/components/**
|
|
@@ -27,7 +27,7 @@ DESIGN QUALITY:
|
|
|
27
27
|
- Default to world-class, sleek, polished, production-ready design
|
|
28
28
|
- All UI must be responsive (mobile-first) and accessible (WCAG 2.1 AA)
|
|
29
29
|
- Use modern design patterns: clean spacing, typography hierarchy, subtle animations
|
|
30
|
-
-
|
|
30
|
+
- Apply high-quality UI polish (clean spacing, modern typography, micro-interactions)
|
|
31
31
|
|
|
32
32
|
WORKFLOW:
|
|
33
33
|
1. Set working directory to your assigned repo: cd repositories/{ORG}/{repo-name}
|
|
@@ -25,11 +25,11 @@
|
|
|
25
25
|
**Invoke**: `/skill-name` | auto-trigger by keywords | `Skill({ skill: "name" })`
|
|
26
26
|
**Parallel work**: Append "use subagents" to requests
|
|
27
27
|
|
|
28
|
-
**Key skills**: `sw:pm`, `sw:architect`, `sw:grill`, `sw:tdd-cycle
|
|
28
|
+
**Key skills**: `sw:pm`, `sw:architect`, `sw:grill`, `sw:tdd-cycle`
|
|
29
29
|
|
|
30
30
|
**Skill chaining** — skills are NOT "one and done":
|
|
31
31
|
1. **Planning**: `sw:pm` (specs) → `sw:architect` (design)
|
|
32
|
-
2. **Implementation**:
|
|
32
|
+
2. **Implementation**: Use `sw:architect` for all domains. Optional domain plugins available via `vskill install` (frontend, backend, testing, etc.)
|
|
33
33
|
3. **Closure**: `sw:grill` runs automatically via `/sw:done`
|
|
34
34
|
|
|
35
35
|
**Complexity gate** — before chaining domain skills:
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**A SpecWeave project** - where specifications drive development.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Quick Start
|
|
6
6
|
|
|
7
7
|
Your project is initialized! Now describe what you want to build.
|
|
8
8
|
|
|
@@ -14,16 +14,16 @@ Your project is initialized! Now describe what you want to build.
|
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
# Plan a new feature
|
|
17
|
-
/
|
|
17
|
+
/sw:increment "user authentication with JWT"
|
|
18
18
|
|
|
19
19
|
# Execute the implementation
|
|
20
|
-
/
|
|
20
|
+
/sw:do
|
|
21
21
|
|
|
22
22
|
# Check progress
|
|
23
|
-
/
|
|
23
|
+
/sw:progress
|
|
24
24
|
|
|
25
25
|
# Close when done
|
|
26
|
-
/
|
|
26
|
+
/sw:done 0001
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
3. **Or describe your project** in natural language (works with slash command workflows):
|
|
@@ -36,127 +36,113 @@ Your project is initialized! Now describe what you want to build.
|
|
|
36
36
|
|
|
37
37
|
4. **SpecWeave will automatically**:
|
|
38
38
|
- Detect your tech stack (or ask you to choose)
|
|
39
|
-
- Use the right agents
|
|
39
|
+
- Use the right agents and skills (all pre-installed)
|
|
40
40
|
- Create strategic documentation
|
|
41
41
|
- Generate specifications (spec.md, plan.md, tasks.md)
|
|
42
42
|
- Guide implementation
|
|
43
43
|
- Generate tests
|
|
44
44
|
|
|
45
|
-
That's it! All components ready - just use `/
|
|
45
|
+
That's it! All components ready - just use `/sw:increment` to start!
|
|
46
46
|
|
|
47
47
|
---
|
|
48
48
|
|
|
49
|
-
##
|
|
49
|
+
## Project Structure
|
|
50
50
|
|
|
51
51
|
```
|
|
52
52
|
{{PROJECT_NAME}}/
|
|
53
53
|
├── .specweave/ # SpecWeave framework
|
|
54
54
|
│ ├── config.json # Project configuration
|
|
55
|
-
│ ├── increments/ # Features (created via /
|
|
55
|
+
│ ├── increments/ # Features (created via /sw:increment)
|
|
56
56
|
│ │ └── 0001-feature/
|
|
57
57
|
│ │ ├── spec.md # WHAT & WHY
|
|
58
58
|
│ │ ├── plan.md # HOW
|
|
59
59
|
│ │ ├── tasks.md # Implementation steps
|
|
60
|
-
│ │ ├── tests.md # Test strategy
|
|
61
|
-
│ │ ├── logs/ # Execution logs
|
|
62
|
-
│ │ ├── scripts/ # Helper scripts
|
|
63
60
|
│ │ └── reports/ # Analysis reports
|
|
64
|
-
│
|
|
65
|
-
│
|
|
66
|
-
│
|
|
67
|
-
│ └── tests/ # Centralized test repository
|
|
68
|
-
├── .claude/ # Claude Code integration (optional)
|
|
69
|
-
│ ├── commands/ # Slash commands (10 installed)
|
|
70
|
-
│ ├── agents/ # AI agents (10 installed)
|
|
71
|
-
│ └── skills/ # AI skills (35+ installed)
|
|
61
|
+
│ └── docs/ # Strategic documentation
|
|
62
|
+
│ ├── internal/ # Internal docs (strategy, architecture)
|
|
63
|
+
│ └── public/ # Published docs
|
|
72
64
|
├── CLAUDE.md # Instructions for AI assistant
|
|
73
65
|
└── README.md # This file
|
|
74
66
|
```
|
|
75
67
|
|
|
76
68
|
---
|
|
77
69
|
|
|
78
|
-
##
|
|
70
|
+
## What is SpecWeave?
|
|
79
71
|
|
|
80
72
|
SpecWeave is a specification-first development framework where:
|
|
81
73
|
- **Specifications are the source of truth** (code follows specs, not reverse)
|
|
82
|
-
- **Slash commands drive workflow** (`/
|
|
74
|
+
- **Slash commands drive workflow** (`/sw:increment` → `/sw:do` → `/sw:done`)
|
|
83
75
|
- **AI agents work autonomously** (PM, Architect, Security, QA, DevOps)
|
|
84
|
-
- **All components pre-installed** (10 agents + 35+ skills ready!)
|
|
85
76
|
- **Works with ANY tech stack** (TypeScript, Python, Go, Rust, Java, .NET, etc.)
|
|
86
77
|
- **Works with multiple AI assistants** (Claude Code, Cursor, Windsurf, etc.)
|
|
87
78
|
|
|
88
79
|
---
|
|
89
80
|
|
|
90
|
-
##
|
|
81
|
+
## Core Workflow
|
|
91
82
|
|
|
92
83
|
```
|
|
93
|
-
/
|
|
84
|
+
/sw:increment "feature" → /sw:do → /sw:progress → /sw:done → repeat
|
|
94
85
|
```
|
|
95
86
|
|
|
96
87
|
| Command | Purpose | When to Use |
|
|
97
88
|
|---------|---------|-------------|
|
|
98
|
-
| `/
|
|
99
|
-
| `/
|
|
100
|
-
| `/
|
|
101
|
-
| `/
|
|
102
|
-
| `/
|
|
103
|
-
| `/
|
|
104
|
-
| `/specweave:sync-jira` | Sync to Jira | Export to Jira |
|
|
89
|
+
| `/sw:increment "feature"` | Plan new increment | Starting new feature |
|
|
90
|
+
| `/sw:do` | Execute tasks | Ready to implement |
|
|
91
|
+
| `/sw:progress` | Check status | Want to see progress |
|
|
92
|
+
| `/sw:validate 0001` | Validate quality | Before completion |
|
|
93
|
+
| `/sw:done 0001` | Close increment | Feature finished |
|
|
94
|
+
| `/sw:progress-sync` | Sync to external tools | Export to GitHub/JIRA/ADO |
|
|
105
95
|
|
|
106
96
|
See `CLAUDE.md` for complete workflow guide.
|
|
107
97
|
|
|
108
98
|
---
|
|
109
99
|
|
|
110
|
-
##
|
|
100
|
+
## File Organization
|
|
111
101
|
|
|
112
102
|
**Keep project root clean!** All AI-generated files go into increment folders:
|
|
113
103
|
|
|
114
104
|
```
|
|
115
|
-
|
|
105
|
+
CORRECT:
|
|
116
106
|
.specweave/increments/0001-auth/
|
|
117
|
-
├──
|
|
118
|
-
|
|
119
|
-
└── reports/analysis.md
|
|
107
|
+
├── reports/analysis.md
|
|
108
|
+
└── logs/execution.log
|
|
120
109
|
|
|
121
|
-
|
|
110
|
+
WRONG:
|
|
122
111
|
project-root/
|
|
123
|
-
├── execution.log
|
|
124
|
-
|
|
125
|
-
└── analysis.md # NO!
|
|
112
|
+
├── execution.log
|
|
113
|
+
└── analysis.md
|
|
126
114
|
```
|
|
127
115
|
|
|
128
116
|
---
|
|
129
117
|
|
|
130
|
-
##
|
|
118
|
+
## AI Assistant Compatibility
|
|
131
119
|
|
|
132
120
|
SpecWeave works with:
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
- ✅ **Any AI IDE** - As long as it supports slash commands or custom prompts
|
|
121
|
+
- **Claude Code** (recommended) - Full slash command support
|
|
122
|
+
- **Cursor** - Slash commands via composer
|
|
123
|
+
- **Windsurf** - Cascade mode compatible
|
|
124
|
+
- **Any AI IDE** - As long as it supports slash commands or custom prompts
|
|
138
125
|
|
|
139
126
|
**Setup**: See `CLAUDE.md` for AI assistant instructions.
|
|
140
127
|
|
|
141
128
|
---
|
|
142
129
|
|
|
143
|
-
##
|
|
130
|
+
## Learn More
|
|
144
131
|
|
|
145
132
|
- **Documentation**: https://verified-skill.com
|
|
146
133
|
- **GitHub**: https://github.com/anton-abyzov/specweave
|
|
147
134
|
- **Quick Reference**: See `CLAUDE.md` in your project
|
|
148
|
-
- **Examples**: Check `.specweave/docs/` after creating your first increment
|
|
149
135
|
|
|
150
136
|
---
|
|
151
137
|
|
|
152
|
-
##
|
|
138
|
+
## Ready to Build?
|
|
153
139
|
|
|
154
140
|
**Start with your first feature**:
|
|
155
141
|
```bash
|
|
156
|
-
/
|
|
142
|
+
/sw:increment "describe your feature here"
|
|
157
143
|
```
|
|
158
144
|
|
|
159
|
-
Or just describe what you want to build, and SpecWeave will guide you through the process!
|
|
145
|
+
Or just describe what you want to build, and SpecWeave will guide you through the process!
|
|
160
146
|
|
|
161
147
|
---
|
|
162
148
|
|
|
@@ -159,10 +159,10 @@ Before closing this increment, the following MUST be true:
|
|
|
159
159
|
**Validation commands**:
|
|
160
160
|
```bash
|
|
161
161
|
# Check AC coverage and task linkage
|
|
162
|
-
/
|
|
162
|
+
/sw:validate {{INCREMENT_ID}}
|
|
163
163
|
|
|
164
164
|
# Close increment (validates automatically)
|
|
165
|
-
/
|
|
165
|
+
/sw:done {{INCREMENT_ID}}
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
---
|