speccrew 0.4.1 → 0.4.3

package/.speccrew/agents/speccrew-product-manager.md

@@ -503,6 +503,27 @@ Step 3b: Invoke speccrew-pm-requirement-analysis
 
 After the Skill generates the Master PRD and outputs the dispatch plan, the PM Agent takes over to generate Sub-PRDs in parallel using worker agents.
 
+> **Phase 4 Execution Flow:**
+> ```
+> Generate Skill outputs Dispatch Plan
+>     ↓
+> PM reads Dispatch Plan (module list + contexts)
+>     ↓
+> PM initializes DISPATCH-PROGRESS.json (via script)
+>     ↓
+> PM invokes speccrew-task-worker × N (one per module)
+>   └─ Each worker internally calls speccrew-pm-sub-prd-generate
+>     ↓
+> Workers complete → PM updates progress (via script)
+>     ↓
+> ALL workers done → Phase 5
+> ```
+> 
+> **NOT this flow:**
+> ```
+> PM reads Dispatch Plan → PM generates Sub-PRDs directly ← VIOLATION
+> ```
+
 ### 4.1 Read Dispatch Plan
 
 From the Skill's Step 12c output, collect:
@@ -531,8 +552,11 @@ node speccrew-workspace/scripts/update-progress.js init \
 > 2. Read file content in the command: `node scripts/update-progress.js init --stage sub_prd_dispatch --tasks (Get-Content tasks-temp.json -Raw)`
 > 3. Or use: `Get-Content tasks-temp.json | node scripts/update-progress.js init --stage sub_prd_dispatch --tasks -`
 
-> ⚠️ DO NOT create DISPATCH-PROGRESS.json manually with PowerShell or any other method.
-> If the script fails, STOP and report the error to the user.
+> 🛑 **HARD STOP: DISPATCH-PROGRESS.json MUST be created by script ONLY**
+> - MUST use: `node speccrew-workspace/scripts/update-progress.js init --stage sub_prd_dispatch --tasks '<JSON_ARRAY>'`
+> - DO NOT create DISPATCH-PROGRESS.json manually (PowerShell, create_file, or any other method)
+> - IF script fails → STOP workflow immediately, report error to user, ask "Retry or Abort?"
+> - DO NOT proceed to Worker dispatch without successful script execution
 
 After each worker completes:
 ```bash
@@ -550,13 +574,22 @@ node speccrew-workspace/scripts/update-progress.js update-task \
 
 ### 4.3 Dispatch Workers
 
-**PM Agent Role: ORCHESTRATOR ONLY**
-
-You are the dispatcher, NOT the writer. Your job is to:
-1. Invoke `speccrew-task-worker` for EACH module
-2. Pass the correct skill_path and context
-3. Wait for all workers to complete
-4. Collect results
+**PM Agent Role: ORCHESTRATOR ONLY — Phase 4 EXPLICIT RULES**
+
+**MANDATORY — PM MUST:**
+1. Read the Dispatch Plan from generate skill output
+2. Initialize DISPATCH-PROGRESS.json via update-progress.js script
+3. For EACH module in dispatch plan: invoke `speccrew-task-worker` with `skill_path: speccrew-pm-sub-prd-generate/SKILL.md`
+4. Pass ALL required context parameters to each worker
+5. Wait for ALL workers to complete
+6. Update DISPATCH-PROGRESS.json via script after each worker completes
+
+🛑 **FORBIDDEN — PM MUST NOT:**
+- Generate Sub-PRD files directly (via create_file, write, or any file creation)
+- Invoke speccrew-pm-sub-prd-generate skill directly (ONLY speccrew-task-worker invokes it)
+- Create or edit any Sub-PRD content as fallback if worker fails
+- Skip worker dispatch and generate Sub-PRDs inline
+- IF PM attempts ANY of above → WORKFLOW VIOLATION → STOP immediately
 
 **Implementation:**
 

package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md

@@ -312,6 +312,18 @@ ELSE:
 → After ALL workers complete → PM Agent executes Phase 5 Verification
 ```
 
+🛑 **CRITICAL HANDOFF — PM Agent MUST NOT:**
+- Generate Sub-PRD files directly
+- Invoke speccrew-pm-sub-prd-generate as its own operation
+- Create Sub-PRD content using create_file or any file write
+- Skip speccrew-task-worker and directly produce Sub-PRD documents
+
+**PM Agent MUST:**
+1. Use Dispatch Plan above to invoke speccrew-task-worker for EACH module
+2. Each worker uses skill_path: speccrew-pm-sub-prd-generate/SKILL.md
+3. Initialize DISPATCH-PROGRESS.json via update-progress.js script (NOT manually)
+4. After ALL workers complete → Execute Phase 5 Verification
+
 **IF Single PRD Structure:** Skip dispatch plan (no Sub-PRDs needed).
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {

package/workspace-template/scripts/update-progress.js

@@ -73,10 +73,29 @@ const path = require('path');
 // ============================================================================
 
 /**
- * 生成 ISO 8601 格式时间戳
+ * 生成本地时区的 ISO 8601 格式时间戳
+ * 例如：2026-04-10T20:38:21.978+08:00
+ */
+function getLocalISOString() {
+    const now = new Date();
+    const off = -now.getTimezoneOffset();
+    const sign = off >= 0 ? '+' : '-';
+    const pad2 = n => String(Math.abs(n)).padStart(2, '0');
+    const tz = sign + pad2(Math.floor(off / 60)) + ':' + pad2(off % 60);
+    return now.getFullYear() + '-' +
+        pad2(now.getMonth() + 1) + '-' +
+        pad2(now.getDate()) + 'T' +
+        pad2(now.getHours()) + ':' +
+        pad2(now.getMinutes()) + ':' +
+        pad2(now.getSeconds()) + '.' +
+        String(now.getMilliseconds()).padStart(3, '0') + tz;
+}
+
+/**
+ * 生成 ISO 8601 格式时间戳（本地时区）
  */
 function getTimestamp() {
-    return new Date().toISOString();
+    return getLocalISOString();
 }
 
 /**