specweave 1.0.244 → 1.0.245
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/CLAUDE.md +24 -24
- package/package.json +1 -1
- package/plugins/specweave/skills/npm/SKILL.md +0 -1
package/CLAUDE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- SW:META template="claude" version="1.0.
|
|
1
|
+
<!-- SW:META template="claude" version="1.0.244" sections="header,start,autodetect,metarule,rules,workflow,reflect,context,structure,taskformat,secrets,syncing,testing,tdd,api,limits,troubleshooting,lazyloading,principles,linking,mcp,auto,docs" -->
|
|
2
2
|
|
|
3
3
|
<!-- SW:SECTION:hook-priority version="1.0.171" -->
|
|
4
4
|
## ⛔ Hook Instructions Override Everything
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
| **"SKILL FIRST"** | Call shown skill FIRST → chain domain skills → implement |
|
|
12
12
|
<!-- SW:END:hook-priority -->
|
|
13
13
|
|
|
14
|
-
<!-- SW:SECTION:header version="1.0.
|
|
14
|
+
<!-- SW:SECTION:header version="1.0.244" -->
|
|
15
15
|
**Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
|
|
16
16
|
<!-- SW:END:header -->
|
|
17
17
|
|
|
@@ -48,7 +48,7 @@ If auto-activation fails, invoke explicitly: `Skill({ skill: "name" })`
|
|
|
48
48
|
|
|
49
49
|
**Native LSP broken in v2.1.0+.** Use: `specweave lsp refs|def|hover src/file.ts SymbolName`
|
|
50
50
|
|
|
51
|
-
<!-- SW:SECTION:start version="1.0.
|
|
51
|
+
<!-- SW:SECTION:start version="1.0.244" -->
|
|
52
52
|
## Getting Started
|
|
53
53
|
|
|
54
54
|
**Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
|
|
@@ -58,7 +58,7 @@ If auto-activation fails, invoke explicitly: `Skill({ skill: "name" })`
|
|
|
58
58
|
2. **Customize**: Edit spec.md and use for setup tasks
|
|
59
59
|
<!-- SW:END:start -->
|
|
60
60
|
|
|
61
|
-
<!-- SW:SECTION:autodetect version="1.0.
|
|
61
|
+
<!-- SW:SECTION:autodetect version="1.0.244" -->
|
|
62
62
|
## Auto-Detection
|
|
63
63
|
|
|
64
64
|
SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
@@ -68,7 +68,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
68
68
|
**Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
|
|
69
69
|
<!-- SW:END:autodetect -->
|
|
70
70
|
|
|
71
|
-
<!-- SW:SECTION:metarule version="1.0.
|
|
71
|
+
<!-- SW:SECTION:metarule version="1.0.244" -->
|
|
72
72
|
## Workflow Orchestration
|
|
73
73
|
|
|
74
74
|
### 1. Plan Mode Default
|
|
@@ -95,7 +95,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
95
95
|
```
|
|
96
96
|
<!-- SW:END:metarule -->
|
|
97
97
|
|
|
98
|
-
<!-- SW:SECTION:rules version="1.0.
|
|
98
|
+
<!-- SW:SECTION:rules version="1.0.244" -->
|
|
99
99
|
## Rules
|
|
100
100
|
|
|
101
101
|
1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
|
|
@@ -114,7 +114,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
114
114
|
Use next available number. **NEVER create duplicate prefixes.**
|
|
115
115
|
<!-- SW:END:rules -->
|
|
116
116
|
|
|
117
|
-
<!-- SW:SECTION:workflow version="1.0.
|
|
117
|
+
<!-- SW:SECTION:workflow version="1.0.244" -->
|
|
118
118
|
## Workflow
|
|
119
119
|
|
|
120
120
|
`/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
|
|
@@ -140,7 +140,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
140
140
|
Before git operations, scan: `for d in repositories packages services apps libs workspace; do [ -d "$d" ] && find "$d" -maxdepth 2 -name ".git" -type d; done`
|
|
141
141
|
<!-- SW:END:save-nested-repos -->
|
|
142
142
|
|
|
143
|
-
<!-- SW:SECTION:reflect version="1.0.
|
|
143
|
+
<!-- SW:SECTION:reflect version="1.0.244" -->
|
|
144
144
|
## Skill Memories
|
|
145
145
|
|
|
146
146
|
SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
|
|
@@ -159,7 +159,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
159
159
|
- Auto command: explicit stop conditions, visible output
|
|
160
160
|
- Prefer leaderboard-style reporting for analysis
|
|
161
161
|
|
|
162
|
-
<!-- SW:SECTION:context version="1.0.
|
|
162
|
+
<!-- SW:SECTION:context version="1.0.244" -->
|
|
163
163
|
## Context
|
|
164
164
|
|
|
165
165
|
**Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
|
|
@@ -167,7 +167,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
167
167
|
**Load context**: `/sw:context <topic>` loads relevant living docs into conversation
|
|
168
168
|
<!-- SW:END:context -->
|
|
169
169
|
|
|
170
|
-
<!-- SW:SECTION:structure version="1.0.
|
|
170
|
+
<!-- SW:SECTION:structure version="1.0.244" -->
|
|
171
171
|
## Structure
|
|
172
172
|
|
|
173
173
|
```
|
|
@@ -182,7 +182,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
182
182
|
**Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
|
|
183
183
|
<!-- SW:END:structure -->
|
|
184
184
|
|
|
185
|
-
<!-- SW:SECTION:taskformat version="1.0.
|
|
185
|
+
<!-- SW:SECTION:taskformat version="1.0.244" -->
|
|
186
186
|
## Task Format
|
|
187
187
|
|
|
188
188
|
```markdown
|
|
@@ -192,7 +192,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
192
192
|
```
|
|
193
193
|
<!-- SW:END:taskformat -->
|
|
194
194
|
|
|
195
|
-
<!-- SW:SECTION:secrets version="1.0.
|
|
195
|
+
<!-- SW:SECTION:secrets version="1.0.244" -->
|
|
196
196
|
## Secrets Check
|
|
197
197
|
|
|
198
198
|
**BEFORE CLI tools**: Check existing config first!
|
|
@@ -206,7 +206,7 @@ gh auth status
|
|
|
206
206
|
**SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
|
|
207
207
|
<!-- SW:END:secrets -->
|
|
208
208
|
|
|
209
|
-
<!-- SW:SECTION:syncing version="1.0.
|
|
209
|
+
<!-- SW:SECTION:syncing version="1.0.244" -->
|
|
210
210
|
## External Sync (GitHub/JIRA/ADO)
|
|
211
211
|
|
|
212
212
|
**Commands**: `/sw-github:sync {id}` (issues) | `/sw:sync-specs` (living docs only)
|
|
@@ -216,7 +216,7 @@ gh auth status
|
|
|
216
216
|
**Config**: Set `sync.github.enabled: true` + `canUpdateExternalItems: true` in config.json
|
|
217
217
|
<!-- SW:END:syncing -->
|
|
218
218
|
|
|
219
|
-
<!-- SW:SECTION:testing version="1.0.
|
|
219
|
+
<!-- SW:SECTION:testing version="1.0.244" -->
|
|
220
220
|
## Testing
|
|
221
221
|
|
|
222
222
|
BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
|
|
@@ -235,7 +235,7 @@ vi.mock('./module', () => ({ func: mockFn }));
|
|
|
235
235
|
**Install CLI**: `npm install -g @playwright/cli@latest`
|
|
236
236
|
<!-- SW:END:testing -->
|
|
237
237
|
|
|
238
|
-
<!-- SW:SECTION:tdd version="1.0.
|
|
238
|
+
<!-- SW:SECTION:tdd version="1.0.244" -->
|
|
239
239
|
## TDD Mode (Test-Driven Development)
|
|
240
240
|
|
|
241
241
|
**When `testing.defaultTestMode: "TDD"` is configured**, follow RED-GREEN-REFACTOR discipline:
|
|
@@ -296,7 +296,7 @@ When TDD is enabled, tasks include phase markers:
|
|
|
296
296
|
**Rule**: Complete dependencies BEFORE dependent tasks (RED before GREEN).
|
|
297
297
|
<!-- SW:END:tdd -->
|
|
298
298
|
|
|
299
|
-
<!-- SW:SECTION:api version="1.0.
|
|
299
|
+
<!-- SW:SECTION:api version="1.0.244" -->
|
|
300
300
|
## API Development (OpenAPI-First)
|
|
301
301
|
|
|
302
302
|
**For API projects only.** Commands: `/sw:api-docs --all` | `--openapi` | `--postman` | `--validate`
|
|
@@ -304,13 +304,13 @@ When TDD is enabled, tasks include phase markers:
|
|
|
304
304
|
Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
|
|
305
305
|
<!-- SW:END:api -->
|
|
306
306
|
|
|
307
|
-
<!-- SW:SECTION:limits version="1.0.
|
|
307
|
+
<!-- SW:SECTION:limits version="1.0.244" -->
|
|
308
308
|
## Limits
|
|
309
309
|
|
|
310
310
|
**Max 1500 lines/file** — extract before adding
|
|
311
311
|
<!-- SW:END:limits -->
|
|
312
312
|
|
|
313
|
-
<!-- SW:SECTION:troubleshooting version="1.0.
|
|
313
|
+
<!-- SW:SECTION:troubleshooting version="1.0.244" -->
|
|
314
314
|
## Troubleshooting
|
|
315
315
|
|
|
316
316
|
| Issue | Fix |
|
|
@@ -323,7 +323,7 @@ Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
|
|
|
323
323
|
| Session stuck | Kill + `rm -f .specweave/state/*.lock` + restart |
|
|
324
324
|
<!-- SW:END:troubleshooting -->
|
|
325
325
|
|
|
326
|
-
<!-- SW:SECTION:lazyloading version="1.0.
|
|
326
|
+
<!-- SW:SECTION:lazyloading version="1.0.244" -->
|
|
327
327
|
## Plugin Auto-Loading
|
|
328
328
|
|
|
329
329
|
Plugins load automatically based on project type and keywords. Manual install if needed:
|
|
@@ -337,7 +337,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1 # Disable auto-load
|
|
|
337
337
|
**Token savings**: Core ~3-5K tokens vs all plugins ~60K+
|
|
338
338
|
<!-- SW:END:lazyloading -->
|
|
339
339
|
|
|
340
|
-
<!-- SW:SECTION:principles version="1.0.
|
|
340
|
+
<!-- SW:SECTION:principles version="1.0.244" -->
|
|
341
341
|
## Principles
|
|
342
342
|
|
|
343
343
|
### SpecWeave Principles
|
|
@@ -353,7 +353,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1 # Disable auto-load
|
|
|
353
353
|
- **Demand Elegance**: For non-trivial changes, pause and ask "is there a more elegant way?" - but skip this for simple, obvious fixes (don't over-engineer).
|
|
354
354
|
<!-- SW:END:principles -->
|
|
355
355
|
|
|
356
|
-
<!-- SW:SECTION:linking version="1.0.
|
|
356
|
+
<!-- SW:SECTION:linking version="1.0.244" -->
|
|
357
357
|
## Bidirectional Linking
|
|
358
358
|
|
|
359
359
|
Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
|
|
@@ -361,7 +361,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
|
|
|
361
361
|
Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
|
|
362
362
|
<!-- SW:END:linking -->
|
|
363
363
|
|
|
364
|
-
<!-- SW:SECTION:mcp version="1.0.
|
|
364
|
+
<!-- SW:SECTION:mcp version="1.0.244" -->
|
|
365
365
|
## External Services
|
|
366
366
|
|
|
367
367
|
**Priority**: CLI tools first (simpler) → MCP for complex integrations
|
|
@@ -383,7 +383,7 @@ claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server
|
|
|
383
383
|
MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
|
|
384
384
|
<!-- SW:END:mcp -->
|
|
385
385
|
|
|
386
|
-
<!-- SW:SECTION:auto version="1.0.
|
|
386
|
+
<!-- SW:SECTION:auto version="1.0.244" -->
|
|
387
387
|
## Auto Mode
|
|
388
388
|
|
|
389
389
|
**Commands**: `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency only)
|
|
@@ -400,7 +400,7 @@ MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
|
|
|
400
400
|
**STOP & ASK** if: Spec conflicts | Task unnecessary | Requirement ambiguous
|
|
401
401
|
<!-- SW:END:auto -->
|
|
402
402
|
|
|
403
|
-
<!-- SW:SECTION:docs version="1.0.
|
|
403
|
+
<!-- SW:SECTION:docs version="1.0.244" -->
|
|
404
404
|
## Docs
|
|
405
405
|
|
|
406
406
|
[spec-weave.com](https://spec-weave.com)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specweave",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.245",
|
|
4
4
|
"description": "Spec-driven development framework for AI coding agents. First-class support for Claude Code — compatible with any LLM-powered coding tool. Living documentation, autonomous execution, quality gates, and multilingual support (9 languages).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|