specweave 1.0.34 → 1.0.36

package/CLAUDE.md

@@ -1,10 +1,10 @@
-<!-- SW:META template="claude" version="1.0.33" sections="header,start,autodetect,metarule,rules,workflow,structure,taskformat,secrets,syncing,mapping,testing,limits,troubleshooting,principles,linking,docs" -->
+<!-- SW:META template="claude" version="1.0.34" sections="header,start,autodetect,metarule,rules,workflow,structure,taskformat,secrets,syncing,mapping,testing,limits,troubleshooting,principles,linking,docs" -->
 
-<!-- SW:SECTION:header version="1.0.33" -->
+<!-- SW:SECTION:header version="1.0.34" -->
 **Framework**: SpecWeave | **Truth**: `spec.md` + `tasks.md`
 <!-- SW:END:header -->
 
-<!-- SW:SECTION:start version="1.0.33" -->
+<!-- SW:SECTION:start version="1.0.34" -->
 ## Getting Started
 
 **Initial increment**: `0001-project-setup` (auto-created by `specweave init`)
@@ -14,7 +14,7 @@
 2. **Customize**: Edit spec.md and use for setup tasks
 <!-- SW:END:start -->
 
-<!-- SW:SECTION:autodetect version="1.0.33" -->
+<!-- SW:SECTION:autodetect version="1.0.34" -->
 ## Auto-Detection
 
 SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
@@ -24,7 +24,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Opt-out phrases**: "Just brainstorm first" | "Don't plan yet" | "Quick discussion" | "Let's explore ideas"
 <!-- SW:END:autodetect -->
 
-<!-- SW:SECTION:metarule version="1.0.33" -->
+<!-- SW:SECTION:metarule version="1.0.34" -->
 ## Meta-Rule: Think-Before-Act
 
 **Satisfy dependencies BEFORE dependent operations.**
@@ -35,7 +35,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:metarule -->
 
-<!-- SW:SECTION:rules version="1.0.33" -->
+<!-- SW:SECTION:rules version="1.0.34" -->
 ## Rules
 
 1. **Files** → `.specweave/increments/####-name/` (spec.md, plan.md, tasks.md at root; reports/, scripts/, logs/ subfolders)
@@ -45,7 +45,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 5. **Root clean**: NEVER create .md/reports/scripts in project root → use increment folders
 <!-- SW:END:rules -->
 
-<!-- SW:SECTION:workflow version="1.0.33" -->
+<!-- SW:SECTION:workflow version="1.0.34" -->
 ## Workflow
 
 `/sw:increment "X"` → `/sw:do` → `/sw:progress` → `/sw:done 0001`
@@ -62,7 +62,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Natural language**: "Let's build X" → `/sw:increment` | "What's status?" → `/sw:progress` | "We're done" → `/sw:done`
 <!-- SW:END:workflow -->
 
-<!-- SW:SECTION:structure version="1.0.33" -->
+<!-- SW:SECTION:structure version="1.0.34" -->
 ## Structure
 
 ```
@@ -78,7 +78,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 **Multi-repo**: Clone to `/repositories`, not root → `repositories/backend/src/...`
 <!-- SW:END:structure -->
 
-<!-- SW:SECTION:taskformat version="1.0.33" -->
+<!-- SW:SECTION:taskformat version="1.0.34" -->
 ## Task Format
 
 ```markdown
@@ -88,7 +88,7 @@ SpecWeave auto-detects product descriptions and routes to `/sw:increment`:
 ```
 <!-- SW:END:taskformat -->
 
-<!-- SW:SECTION:secrets version="1.0.33" -->
+<!-- SW:SECTION:secrets version="1.0.34" -->
 ## Secrets Check
 
 **BEFORE CLI tools**: Check existing config first!
@@ -99,7 +99,7 @@ gh auth status
 ```
 <!-- SW:END:secrets -->
 
-<!-- SW:SECTION:syncing version="1.0.33" -->
+<!-- SW:SECTION:syncing version="1.0.34" -->
 ## Auto-Sync (Hooks)
 
 Post-task: updates tasks.md → living docs → external trackers (if configured)
@@ -107,7 +107,7 @@ Post-task: updates tasks.md → living docs → external trackers (if configured
 Config: `.specweave/config.json` → `hooks.post_task_completion`
 <!-- SW:END:syncing -->
 
-<!-- SW:SECTION:mapping version="1.0.33" -->
+<!-- SW:SECTION:mapping version="1.0.34" -->
 ## GitHub Mapping
 
 | SpecWeave | GitHub |
@@ -117,7 +117,7 @@ Config: `.specweave/config.json` → `hooks.post_task_completion`
 | Task T-XXX | Checkbox |
 <!-- SW:END:mapping -->
 
-<!-- SW:SECTION:testing version="1.0.33" -->
+<!-- SW:SECTION:testing version="1.0.34" -->
 ## Testing
 
 BDD in tasks.md | Unit >80% | `.test.ts` (Vitest)
@@ -129,13 +129,13 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 ```
 <!-- SW:END:testing -->
 
-<!-- SW:SECTION:limits version="1.0.33" -->
+<!-- SW:SECTION:limits version="1.0.34" -->
 ## Limits
 
 **Max 1500 lines/file** — extract before adding
 <!-- SW:END:limits -->
 
-<!-- SW:SECTION:troubleshooting version="1.0.33" -->
+<!-- SW:SECTION:troubleshooting version="1.0.34" -->
 ## Troubleshooting
 
 | Issue | Fix |
@@ -149,7 +149,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 | External not syncing | Check `config.json` → `external_tracker_sync: true` |
 <!-- SW:END:troubleshooting -->
 
-<!-- SW:SECTION:principles version="1.0.33" -->
+<!-- SW:SECTION:principles version="1.0.34" -->
 ## Principles
 
 1. **Spec-first**: `/sw:increment` before coding
@@ -159,7 +159,7 @@ vi.mock('fs', () => ({ readFile: vi.fn() }));
 5. **Clean**: All files in increment folders
 <!-- SW:END:principles -->
 
-<!-- SW:SECTION:linking version="1.0.33" -->
+<!-- SW:SECTION:linking version="1.0.34" -->
 ## Bidirectional Linking
 
 Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
@@ -167,7 +167,7 @@ Tasks ↔ User Stories auto-linked via AC-IDs: `AC-US1-01` → `US-001`
 Task format: `**AC**: AC-US1-01, AC-US1-02` (CRITICAL for linking)
 <!-- SW:END:linking -->
 
-<!-- SW:SECTION:docs version="1.0.33" -->
+<!-- SW:SECTION:docs version="1.0.34" -->
 ## Docs
 
 [spec-weave.com](https://spec-weave.com) | `.specweave/docs/internal/`
@@ -548,4 +548,3 @@ npm run rebuild
 - **Internal Docs**: `.specweave/docs/internal/`
 - **ADRs**: `.specweave/docs/internal/architecture/adr/`
 - **Troubleshooting**: `.specweave/docs/internal/troubleshooting/`
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "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.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/skills/role-orchestrator/SKILL.md

@@ -99,14 +99,27 @@ mkdir -p ${incrementPath}logs/
 mkdir -p ${incrementPath}scripts/
 mkdir -p ${incrementPath}reports/
 
-// 4. Create placeholder files
+// 4. Create placeholder files (ORDER MATTERS!)
+// metadata.json MUST be created FIRST (metadata-json-guard.sh blocks spec.md otherwise)
+write ${incrementPath}metadata.json (MANDATORY - CREATE FIRST!)
 write ${incrementPath}spec.md (basic template)
 write ${incrementPath}plan.md (basic template)
 write ${incrementPath}tasks.md (basic template)
-write ${incrementPath}metadata.json (MANDATORY)
 ```
 
-**spec.md template**:
+**metadata.json template** (CREATE FIRST!):
+```json
+{
+  "id": "0001-project-name",
+  "status": "planned",
+  "type": "feature",
+  "priority": "P1",
+  "created": "2025-11-24T12:00:00Z",
+  "lastActivity": "2025-11-24T12:00:00Z"
+}
+```
+
+**spec.md template** (create AFTER metadata.json):
 ```yaml
 ---
 increment: 0001-project-name
@@ -126,18 +139,6 @@ created: 2025-11-24
 (To be filled by PM Agent)
 ```
 
-**metadata.json template**:
-```json
-{
-  "id": "0001-project-name",
-  "status": "planned",
-  "type": "feature",
-  "priority": "P1",
-  "created": "2025-11-24T12:00:00Z",
-  "lastActivity": "2025-11-24T12:00:00Z"
-}
-```
-
 ### Phase 1: Guide User Through Agent Workflow
 
 **Output this workflow to user**: