specweave 1.0.199 → 1.0.200
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/CLAUDE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- SW:META template="claude" version="1.0.
|
|
1
|
+
<!-- SW:META template="claude" version="1.0.199" 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
|
## ⛔ ABSOLUTE PRIORITY: Hook Instructions Are Mandatory
|
|
@@ -53,7 +53,7 @@ Hooks exist to enforce workflow discipline. If you ignore them:
|
|
|
53
53
|
**This is non-negotiable. No exceptions. No "just this once".**
|
|
54
54
|
<!-- SW:END:hook-priority -->
|
|
55
55
|
|
|
56
|
-
<!-- SW:SECTION:header version="1.0.
|
|
56
|
+
<!-- SW:SECTION:header version="1.0.199" -->
|
|
57
57
|
**Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
|
|
58
58
|
<!-- SW:END:header -->
|
|
59
59
|
|
|
@@ -277,7 +277,7 @@ SpecWeave's `user-prompt-submit.sh` hook auto-installs LSP plugins with **projec
|
|
|
277
277
|
|
|
278
278
|
**Reference**: [Official Docs](https://code.claude.com/docs/en/discover-plugins#install-plugins) | [Settings Scopes](https://code.claude.com/docs/en/settings#configuration-scopes)
|
|
279
279
|
|
|
280
|
-
<!-- SW:SECTION:start version="1.0.
|
|
280
|
+
<!-- SW:SECTION:start version="1.0.199" -->
|
|
281
281
|
## Getting Started
|
|
282
282
|
|
|
283
283
|
**Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
|
|
@@ -287,7 +287,7 @@ SpecWeave's `user-prompt-submit.sh` hook auto-installs LSP plugins with **projec
|
|
|
287
287
|
2. **Customize**: Edit spec.md and use for setup tasks
|
|
288
288
|
<!-- SW:END:start -->
|
|
289
289
|
|
|
290
|
-
<!-- SW:SECTION:autodetect version="1.0.
|
|
290
|
+
<!-- SW:SECTION:autodetect version="1.0.199" -->
|
|
291
291
|
## Auto-Detection
|
|
292
292
|
|
|
293
293
|
SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
@@ -297,7 +297,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
297
297
|
**Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
|
|
298
298
|
<!-- SW:END:autodetect -->
|
|
299
299
|
|
|
300
|
-
<!-- SW:SECTION:metarule version="1.0.
|
|
300
|
+
<!-- SW:SECTION:metarule version="1.0.199" -->
|
|
301
301
|
## Meta-Rule: Think-Before-Act
|
|
302
302
|
|
|
303
303
|
**Satisfy dependencies BEFORE dependent operations.**
|
|
@@ -308,7 +308,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
308
308
|
```
|
|
309
309
|
<!-- SW:END:metarule -->
|
|
310
310
|
|
|
311
|
-
<!-- SW:SECTION:rules version="1.0.
|
|
311
|
+
<!-- SW:SECTION:rules version="1.0.199" -->
|
|
312
312
|
## Rules
|
|
313
313
|
|
|
314
314
|
1. **Files** → `.specweave/increments/####-name/` (see Structure section for details)
|
|
@@ -324,7 +324,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
|
|
|
324
324
|
Use next available number. **NEVER create duplicate prefixes.**
|
|
325
325
|
<!-- SW:END:rules -->
|
|
326
326
|
|
|
327
|
-
<!-- SW:SECTION:workflow version="1.0.
|
|
327
|
+
<!-- SW:SECTION:workflow version="1.0.199" -->
|
|
328
328
|
## Workflow
|
|
329
329
|
|
|
330
330
|
`/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
|
|
@@ -370,7 +370,7 @@ project/
|
|
|
370
370
|
**NEVER assume single-repo mode without scanning first!**
|
|
371
371
|
<!-- SW:END:save-nested-repos -->
|
|
372
372
|
|
|
373
|
-
<!-- SW:SECTION:reflect version="1.0.
|
|
373
|
+
<!-- SW:SECTION:reflect version="1.0.199" -->
|
|
374
374
|
## Skill Memories
|
|
375
375
|
|
|
376
376
|
SpecWeave learns from corrections. Learnings saved here automatically. Edit or delete as needed.
|
|
@@ -385,7 +385,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
385
385
|
### Pm
|
|
386
386
|
- **2026-02-01**: Enable interview process during increment creation for SpecWeave projects
|
|
387
387
|
|
|
388
|
-
<!-- SW:SECTION:context version="1.0.
|
|
388
|
+
<!-- SW:SECTION:context version="1.0.199" -->
|
|
389
389
|
## Context
|
|
390
390
|
|
|
391
391
|
**Before implementing**: Check ADRs at `.specweave/docs/internal/architecture/adr/`
|
|
@@ -393,7 +393,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
393
393
|
**Load context**: `/sw:context <topic>` loads relevant living docs into conversation
|
|
394
394
|
<!-- SW:END:context -->
|
|
395
395
|
|
|
396
|
-
<!-- SW:SECTION:structure version="1.0.
|
|
396
|
+
<!-- SW:SECTION:structure version="1.0.199" -->
|
|
397
397
|
## Structure
|
|
398
398
|
|
|
399
399
|
```
|
|
@@ -408,7 +408,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
408
408
|
**Everything else → subfolders**: `reports/` | `logs/` | `scripts/` | `backups/`
|
|
409
409
|
<!-- SW:END:structure -->
|
|
410
410
|
|
|
411
|
-
<!-- SW:SECTION:taskformat version="1.0.
|
|
411
|
+
<!-- SW:SECTION:taskformat version="1.0.199" -->
|
|
412
412
|
## Task Format
|
|
413
413
|
|
|
414
414
|
```markdown
|
|
@@ -418,7 +418,7 @@ SpecWeave learns from corrections. Learnings saved here automatically. Edit or d
|
|
|
418
418
|
```
|
|
419
419
|
<!-- SW:END:taskformat -->
|
|
420
420
|
|
|
421
|
-
<!-- SW:SECTION:secrets version="1.0.
|
|
421
|
+
<!-- SW:SECTION:secrets version="1.0.199" -->
|
|
422
422
|
## Secrets Check
|
|
423
423
|
|
|
424
424
|
**BEFORE CLI tools**: Check existing config first!
|
|
@@ -432,7 +432,7 @@ gh auth status
|
|
|
432
432
|
**SECURITY**: NEVER use `grep TOKEN .env` without `-q` flag - it exposes credentials in terminal!
|
|
433
433
|
<!-- SW:END:secrets -->
|
|
434
434
|
|
|
435
|
-
<!-- SW:SECTION:syncing version="1.0.
|
|
435
|
+
<!-- SW:SECTION:syncing version="1.0.199" -->
|
|
436
436
|
## External Sync (GitHub/JIRA/ADO)
|
|
437
437
|
|
|
438
438
|
**Commands**: `/sw-github:sync {id}` (issues) | `/sw:sync-specs` (living docs only)
|
|
@@ -442,7 +442,7 @@ gh auth status
|
|
|
442
442
|
**Config**: Set `sync.github.enabled: true` + `canUpdateExternalItems: true` in config.json
|
|
443
443
|
<!-- SW:END:syncing -->
|
|
444
444
|
|
|
445
|
-
<!-- SW:SECTION:testing version="1.0.
|
|
445
|
+
<!-- SW:SECTION:testing version="1.0.199" -->
|
|
446
446
|
## Testing
|
|
447
447
|
|
|
448
448
|
BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
|
|
@@ -454,7 +454,7 @@ vi.mock('./module', () => ({ func: mockFn }));
|
|
|
454
454
|
```
|
|
455
455
|
<!-- SW:END:testing -->
|
|
456
456
|
|
|
457
|
-
<!-- SW:SECTION:tdd version="1.0.
|
|
457
|
+
<!-- SW:SECTION:tdd version="1.0.199" -->
|
|
458
458
|
## TDD Mode (Test-Driven Development)
|
|
459
459
|
|
|
460
460
|
**When `testing.defaultTestMode: "TDD"` is configured**, follow RED-GREEN-REFACTOR discipline:
|
|
@@ -515,7 +515,7 @@ When TDD is enabled, tasks include phase markers:
|
|
|
515
515
|
**Rule**: Complete dependencies BEFORE dependent tasks (RED before GREEN).
|
|
516
516
|
<!-- SW:END:tdd -->
|
|
517
517
|
|
|
518
|
-
<!-- SW:SECTION:api version="1.0.
|
|
518
|
+
<!-- SW:SECTION:api version="1.0.199" -->
|
|
519
519
|
## API Development (OpenAPI-First)
|
|
520
520
|
|
|
521
521
|
**For API projects only.** Commands: `/sw:api-docs --all` | `--openapi` | `--postman` | `--validate`
|
|
@@ -523,13 +523,13 @@ When TDD is enabled, tasks include phase markers:
|
|
|
523
523
|
Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
|
|
524
524
|
<!-- SW:END:api -->
|
|
525
525
|
|
|
526
|
-
<!-- SW:SECTION:limits version="1.0.
|
|
526
|
+
<!-- SW:SECTION:limits version="1.0.199" -->
|
|
527
527
|
## Limits
|
|
528
528
|
|
|
529
529
|
**Max 1500 lines/file** — extract before adding
|
|
530
530
|
<!-- SW:END:limits -->
|
|
531
531
|
|
|
532
|
-
<!-- SW:SECTION:troubleshooting version="1.0.
|
|
532
|
+
<!-- SW:SECTION:troubleshooting version="1.0.199" -->
|
|
533
533
|
## Troubleshooting
|
|
534
534
|
|
|
535
535
|
| Issue | Fix |
|
|
@@ -546,7 +546,7 @@ Enable in config: `{"apiDocs":{"enabled":true,"openApiPath":"openapi.yaml"}}`
|
|
|
546
546
|
| Docs folder collisions | Check: `ls docs/ \| grep -E '^[0-9]{2}-' \| cut -d'-' -f1 \| sort \| uniq -d` |
|
|
547
547
|
<!-- SW:END:troubleshooting -->
|
|
548
548
|
|
|
549
|
-
<!-- SW:SECTION:lazyloading version="1.0.
|
|
549
|
+
<!-- SW:SECTION:lazyloading version="1.0.199" -->
|
|
550
550
|
## Plugin Auto-Loading
|
|
551
551
|
|
|
552
552
|
Plugins load automatically based on project type and keywords. Manual install if needed:
|
|
@@ -560,7 +560,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1 # Disable auto-load
|
|
|
560
560
|
**Token savings**: Core ~3-5K tokens vs all plugins ~60K+
|
|
561
561
|
<!-- SW:END:lazyloading -->
|
|
562
562
|
|
|
563
|
-
<!-- SW:SECTION:principles version="1.0.
|
|
563
|
+
<!-- SW:SECTION:principles version="1.0.199" -->
|
|
564
564
|
## Principles
|
|
565
565
|
|
|
566
566
|
1. **Spec-first**: `/sw:increment` before coding
|
|
@@ -569,7 +569,7 @@ export SPECWEAVE_DISABLE_AUTO_LOAD=1 # Disable auto-load
|
|
|
569
569
|
4. **Traceable**: All work → specs → ACs
|
|
570
570
|
<!-- SW:END:principles -->
|
|
571
571
|
|
|
572
|
-
<!-- SW:SECTION:linking version="1.0.
|
|
572
|
+
<!-- SW:SECTION:linking version="1.0.199" -->
|
|
573
573
|
## Bidirectional Linking
|
|
574
574
|
|
|
575
575
|
Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
|
|
@@ -577,7 +577,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
|
|
|
577
577
|
Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
|
|
578
578
|
<!-- SW:END:linking -->
|
|
579
579
|
|
|
580
|
-
<!-- SW:SECTION:mcp version="1.0.
|
|
580
|
+
<!-- SW:SECTION:mcp version="1.0.199" -->
|
|
581
581
|
## External Services
|
|
582
582
|
|
|
583
583
|
**Priority**: CLI tools first (simpler) → MCP for complex integrations
|
|
@@ -599,7 +599,7 @@ claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server
|
|
|
599
599
|
MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
|
|
600
600
|
<!-- SW:END:mcp -->
|
|
601
601
|
|
|
602
|
-
<!-- SW:SECTION:auto version="1.0.
|
|
602
|
+
<!-- SW:SECTION:auto version="1.0.199" -->
|
|
603
603
|
## Auto Mode
|
|
604
604
|
|
|
605
605
|
**Commands**: `/sw:auto` (start) | `/sw:auto-status` (check) | `/sw:cancel-auto` (emergency only)
|
|
@@ -616,7 +616,7 @@ MCP supports lazy-loading (auto mode) - tools load on-demand when >10% context.
|
|
|
616
616
|
**STOP & ASK** if: Spec conflicts | Task unnecessary | Requirement ambiguous
|
|
617
617
|
<!-- SW:END:auto -->
|
|
618
618
|
|
|
619
|
-
<!-- SW:SECTION:docs version="1.0.
|
|
619
|
+
<!-- SW:SECTION:docs version="1.0.199" -->
|
|
620
620
|
## Docs
|
|
621
621
|
|
|
622
622
|
[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.200",
|
|
4
4
|
"description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|