speccrew 0.5.17 → 0.5.19

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

@@ -457,13 +457,13 @@ Invoke speccrew-pm-requirement-simple
 
 **Flow:**
 ```
-Step 3a: Invoke speccrew-pm-requirement-model
+Step 4a: Invoke speccrew-pm-requirement-model
   → Pass: iteration_path, clarification_file
   → Wait for: .module-design.md
   → Validate: .module-design.md exists + module count >= 2
   → IF fails → ABORT (ORCHESTRATOR rule: do NOT do module decomposition yourself)
 
-Step 3b: Invoke speccrew-pm-requirement-analysis
+Step 4b: Invoke speccrew-pm-requirement-analysis
   → Pass: iteration_path, clarification_file, module_design_file
   → Wait for: Master PRD + Dispatch Plan
   → Validate: Master PRD exists + Dispatch Plan has modules array
@@ -471,13 +471,13 @@ Step 3b: Invoke speccrew-pm-requirement-analysis
   → IF succeeds → MANDATORY: Execute Phase 5 (Sub-PRD Worker Dispatch)
 ```
 
-**Step 3a Parameters:**
+**Step 4a Parameters:**
 | Parameter | Value |
 |-----------|-------|
 | `iteration_path` | `speccrew-workspace/iterations/{iteration}` |
 | `clarification_file` | `{iteration_path}/01.product-requirement/.clarification-summary.md` |
 
-**Step 3b Parameters:**
+**Step 4b Parameters:**
 | Parameter | Value |
 |-----------|-------|
 | `iteration_path` | `speccrew-workspace/iterations/{iteration}` |

package/.speccrew/agents/speccrew-system-designer.md

@@ -137,6 +137,7 @@ This agent MUST execute tasks continuously without unnecessary interruptions.
 3. **Missing Intermediate Artifacts**: Feature Spec not found, API Contract missing, or framework-evaluation.md not generated → STOP.
 4. **User Rejection**: User rejects framework evaluation, DESIGN-OVERVIEW, or Joint Confirmation → STOP, ask for specific revision requirements.
 5. **Worker Batch Failure**: If >50% workers in a batch fail → STOP entire batch, report to user with failure details.
+6. **Missing Techs Knowledge Base**: `techs-manifest.json` not found in Phase 2 → STOP. Techs knowledge base must be initialized before system design can proceed.
 
 # Workflow
 
@@ -379,6 +380,25 @@ After user confirmation, load knowledge in the following order:
 
 ### 2.2 Load Techs Knowledge Base
 
+**Gate Check — Techs Knowledge Base Availability:**
+
+1. Check if `speccrew-workspace/knowledges/techs/techs-manifest.json` exists
+2. **IF NOT EXISTS** → STOP and report to user:
+   ```
+   ❌ TECHS KNOWLEDGE BASE NOT FOUND
+   
+   The technology knowledge base has not been initialized.
+   Required file missing: knowledges/techs/techs-manifest.json
+   
+   Please initialize the techs knowledge base first by asking the Team Leader:
+   "Initialize technology knowledge base" or "初始化技术知识库"
+   
+   This is required for system design to understand your project's technology stack,
+   conventions, and architecture patterns.
+   ```
+   → END workflow (do not proceed to Phase 3)
+3. **IF EXISTS** → Continue loading techs knowledge as below
+
 1. Read `speccrew-workspace/knowledges/techs/techs-manifest.json` to discover platforms
 2. For each platform in manifest, load key techs knowledge:
    - `knowledges/techs/{platform_id}/tech-stack.md`

package/.speccrew/agents/speccrew-system-developer.md

@@ -161,6 +161,7 @@ This agent MUST execute tasks continuously without unnecessary interruptions.
 6. **Batch Failure Threshold**: If >50% workers in a batch fail → STOP entire batch, report to user with failure details.
 7. **Code Quality Deadlock**: If review identifies unfixable issues after 3 re-dispatch attempts → STOP and report as technical debt.
 8. **Cross-platform Integration Failure**: Critical API/data inconsistencies detected in Phase 5 that block downstream testing → STOP and report integration risks.
+9. **Missing Techs Knowledge Base**: `techs-manifest.json` not found in Step 2 → STOP. Techs knowledge base must be initialized before development can proceed.
 
 ## TIMESTAMP INTEGRITY
 
@@ -338,6 +339,25 @@ For each platform_id identified:
 
 ## Step 2: Load Techs Knowledge
 
+**Gate Check — Techs Knowledge Base Availability:**
+
+1. Check if `speccrew-workspace/knowledges/techs/techs-manifest.json` exists
+2. **IF NOT EXISTS** → STOP and report to user:
+   ```
+   ❌ TECHS KNOWLEDGE BASE NOT FOUND
+   
+   The technology knowledge base has not been initialized.
+   Required file missing: knowledges/techs/techs-manifest.json
+   
+   Please initialize the techs knowledge base first by asking the Team Leader:
+   "Initialize technology knowledge base" or "初始化技术知识库"
+   
+   This is required for development to understand your project's technology stack,
+   coding conventions, and architecture patterns.
+   ```
+   → END workflow (do not proceed to Step 3)
+3. **IF EXISTS** → Continue loading techs knowledge as below
+
 Load development-focused techs knowledge following the Developer section of agent-knowledge-map:
 
 ### 2.1 Common Knowledge (All Platforms)

package/package.json

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