speccrew 0.6.9 → 0.6.11

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

@@ -93,33 +93,14 @@ Use Glob to search `{iterations_dir}/*/WORKFLOW-PROGRESS.json`
    - If `01_prd.status` is `confirmed`, check resume state (Step 0.2)
 3. **If WORKFLOW-PROGRESS.json does not exist**:
    - **MUST use script to initialize:**
+
+     > 🛑 **FORBIDDEN**: DO NOT manually create WORKFLOW-PROGRESS.json via Write/Edit tools. ALL initialization MUST be done via `update-progress.js` script.
+
      ```bash
      node "{update_progress_script}" update-workflow \
-       --file {iterations_dir}/{iteration}/WORKFLOW-PROGRESS.json \
+       --file "{iterations_dir}/{iteration_name}/WORKFLOW-PROGRESS.json" \
        --stage 01_prd --status in_progress
      ```
-   - **Fallback** (ONLY if script file does not exist):
-     Create manually with the following structure:
-     ```json
-     {
-       "iteration": "{iteration-name}",
-       "current_stage": "01_prd",
-       "stages": {
-         "01_prd": {
-           "status": "in_progress",
-           "started_at": "<current-timestamp>",
-           "completed_at": null,
-           "confirmed_at": null,
-           "outputs": []
-         },
-         "02_feature_design": { "status": "pending" },
-         "03_system_design": { "status": "pending" },
-         "04_development": { "status": "pending" },
-         "05_deployment": { "status": "pending" },
-         "06_system_test": { "status": "pending" }
-       }
-     }
-     ```
 
 ## Phase 0.2: Check Resume State (Checkpoint Recovery)
 
@@ -424,11 +405,42 @@ No knowledge base exists. A lightweight feature inventory scan is triggered to d
 
 3. **After Worker completes**: Re-run Step 1.1 (dispatch detector again)
    - **Verify** status changed from "none" to "lite"
-   - If status is now "lite" → **Continue with Path B flow**
-     - Path B will use **matcher** to identify modules relevant to the user's requirement
-     - Only those matched modules will be offered for deep initialization (module-initializer)
+   - If status is now "lite" → **Execute Path B immediately** (see MANDATORY instruction below)
    - If status is still "none" → Initialization failed, proceed to Step 4
 
+> 🛑 **MANDATORY — Path C → Path B Sequence**:
+> After init-features completes (features-*.json generated), you MUST immediately execute Path B:
+> 1. Dispatch Worker with `speccrew-pm-module-matcher` skill to match requirement features against the generated features inventory
+> 2. Based on matcher results, dispatch Worker with `speccrew-pm-module-initializer` skill to deep-initialize matched modules' knowledge base
+> 3. Only after module initialization completes, proceed to Phase 2 (Requirement Clarification)
+>
+> DO NOT skip Path B. DO NOT proceed directly to Phase 2 after Path C.
+> The features-*.json files are INPUT for Path B's matcher, not the final output of Phase 1.
+
+   **Agent Tool Invocation for Path B Step 1 (Matcher)**:
+   ```
+   Use the Agent tool to invoke speccrew-task-worker:
+   - agent: speccrew-task-worker
+   - task: Execute speccrew-pm-module-matcher skill
+   - context:
+       skill: speccrew-pm-module-matcher
+       sync_state_bizs_dir: {sync_state_bizs_dir}
+       requirement_summary: <brief summary of user's requirement>
+   ```
+
+   **Agent Tool Invocation for Path B Step 2 (Module Initializer)**:
+   ```
+   Use the Agent tool to invoke speccrew-task-worker:
+   - agent: speccrew-task-worker
+   - task: Execute speccrew-pm-module-initializer skill
+   - context:
+       skill: speccrew-pm-module-initializer
+       workspace_path: {workspace_path}
+       matched_modules: <modules from matcher result>
+       sync_state_bizs_dir: {sync_state_bizs_dir}
+       ide_skills_dir: {ide_skills_dir}
+   ```
+
 4. **IF feature inventory fails**:
    - Report to user: "Project structure scan encountered issues: [specific error]. Continuing without knowledge base context."
    - Log the error details for debugging
@@ -626,6 +638,9 @@ Clarification File: {iteration_path}/01.product-requirement/.clarification-summa
 
 - **IF user confirms** (explicit "确认" or "OK"):
   1. Update checkpoint to record user confirmation:
+
+     > 🛑 **FORBIDDEN**: DO NOT manually edit .checkpoints.json via Write/Edit tools. ALL checkpoint updates MUST be done via `update-progress.js` script.
+
      ```bash
      node "{update_progress_script}" write-checkpoint \
        --file {iteration_path}/01.product-requirement/.checkpoints.json \
@@ -1089,6 +1104,8 @@ After all workers complete, report dispatch summary:
 
 Update `.checkpoints.json` → `sub_prd_dispatch.passed = true` (only if all succeeded or user skips failures).
 
+> 🛑 **MANDATORY**: After all Sub-PRDs are generated and checkpoint is recorded, you MUST immediately proceed to Phase 6 (Verification & User Review). DO NOT skip Phase 6. DO NOT directly ask the user if they want to continue to Feature Design. Phase 6 handles the formal verification, user review, and status update.
+
 ---
 
 ## Phase 6: Verification & Confirmation
@@ -1256,10 +1273,14 @@ After presenting the documents above, you MUST stop and ask:
 > - If NO → Return to Phase 6.2 and wait for confirmation
 > - If YES → Proceed with the steps below
 
+> 🛑 **FORBIDDEN**: DO NOT manually edit WORKFLOW-PROGRESS.json via Write/Edit tools. ALL updates to this file MUST be done via `update-progress.js` script through `run_in_terminal`.
+
 **5.3.1 Update Checkpoints**
 
 Now update all checkpoints (user has confirmed):
 
+> 🛑 **FORBIDDEN**: DO NOT manually edit .checkpoints.json via Write/Edit tools. ALL checkpoint updates MUST be done via `update-progress.js` script.
+
 ```bash
 # Update verification_checklist checkpoint
 node "{update_progress_script}" write-checkpoint \
@@ -1276,10 +1297,14 @@ node "{update_progress_script}" write-checkpoint \
 
 **5.3.2 Update WORKFLOW-PROGRESS.json**
 
+**Update workflow status to completed:**
+```bash
+node "{update_progress_script}" update-workflow --file "{iterations_dir}/{iteration_name}/WORKFLOW-PROGRESS.json" --stage 01_prd --status completed
+```
+
+**Update workflow status to confirmed (after user confirms):**
 ```bash
-node "{update_progress_script}" update-workflow \
-  --file {iterations_dir}/{iteration}/WORKFLOW-PROGRESS.json \
-  --stage 01_prd --status completed
+node "{update_progress_script}" update-workflow --file "{iterations_dir}/{iteration_name}/WORKFLOW-PROGRESS.json" --stage 01_prd --status confirmed
 ```
 
 **5.3.3 Update PRD Status**

package/package.json

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

package/workspace-template/docs/configs/tech-stack-mappings.json

@@ -16,7 +16,7 @@
     "web": {
       "react": {
         "extensions": [".tsx", ".ts", ".jsx", ".js"],
-        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "hocs", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "hocs", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["src/pages/**/*.{tsx,jsx}", "src/components/**/*.{tsx,jsx}"],
         "api_call_patterns": ["fetch(", "axios.", "apiClient.", "useQuery", "useMutation"],
         "state_management": ["useState", "useReducer", "Redux", "Zustand", "MobX"],
@@ -25,7 +25,7 @@
       },
       "vue": {
         "extensions": [".vue", ".ts", ".js"],
-        "exclude_dirs": ["components", "composables", "hooks", "utils", "mixins", "directives", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "composables", "hooks", "utils", "mixins", "directives", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["src/views/**/*.vue", "src/components/**/*.vue", "pages/**/*.vue"],
         "api_call_patterns": ["axios.", "fetch(", "$http", "useFetch"],
         "state_management": ["Pinia", "Vuex", "ref", "reactive", "computed"],
@@ -34,7 +34,7 @@
       },
       "angular": {
         "extensions": [".ts", ".html", ".scss", ".css"],
-        "exclude_dirs": ["components", "directives", "pipes", "guards", "interceptors", "services", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "directives", "pipes", "guards", "interceptors", "services", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["src/app/components/**/*.ts", "src/app/pages/**/*.ts"],
         "api_call_patterns": ["HttpClient", "http.get", "http.post"],
         "state_management": ["RxJS", "NgRx", "BehaviorSubject", "Observable"],
@@ -43,7 +43,7 @@
       },
       "nextjs": {
         "extensions": [".tsx", ".ts", ".jsx", ".js"],
-        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "api", "src", "views", "pages", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "api", "views", "pages", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["app/**/*.{tsx,jsx}", "pages/**/*.{tsx,jsx}"],
         "api_call_patterns": ["fetch(", "axios.", "useSWR", "React Query"],
         "state_management": ["useState", "Zustand", "Redux", "Context API"],
@@ -52,7 +52,7 @@
       },
       "nuxt": {
         "extensions": [".vue", ".ts", ".js"],
-        "exclude_dirs": ["components", "composables", "utils", "plugins", "middleware", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "composables", "utils", "plugins", "middleware", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["pages/**/*.vue", "components/**/*.vue"],
         "api_call_patterns": ["$fetch", "useFetch", "axios."],
         "state_management": ["Pinia", "useState", "composables"],
@@ -61,7 +61,7 @@
       },
       "svelte": {
         "extensions": [".svelte", ".ts", ".js"],
-        "exclude_dirs": ["components", "lib", "utils", "stores", "actions", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "lib", "utils", "stores", "actions", "views", "pages", "api", "layout", "layouts", "assets", "store", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["src/**/*.svelte", "routes/**/*.svelte"],
         "api_call_patterns": ["fetch(", "axios."],
         "state_management": ["writable", "readable", "derived", "Svelte Store"],
@@ -81,7 +81,7 @@
       },
       "react-native": {
         "extensions": [".tsx", ".ts", ".jsx", ".js"],
-        "exclude_dirs": ["components", "hooks", "utils", "contexts", "navigations", "src", "views", "pages", "api", "screens", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "exclude_dirs": ["components", "hooks", "utils", "contexts", "navigations", "views", "pages", "api", "screens", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
         "entry_patterns": ["src/screens/**/*.{tsx,jsx}", "src/components/**/*.{tsx,jsx}"],
         "api_call_patterns": ["fetch(", "axios.", "apiClient."],
         "state_management": ["useState", "Redux", "MobX", "Zustand", "Recoil"],
@@ -90,7 +90,7 @@
       },
       "uniapp": {
         "extensions": [".vue", ".ts", ".js"],
-        "exclude_dirs": ["components", "composables", "utils", "mixins", "directives", "src", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
+        "exclude_dirs": ["components", "composables", "utils", "mixins", "directives", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
         "exclude_file_suffixes": [],
         "strip_module_prefixes": ["pages-"],
         "entry_patterns": ["pages/**/*.vue", "components/**/*.vue"],
@@ -117,7 +117,7 @@
       },
       "miniprogram": {
         "extensions": [".js", ".ts", ".wxml", ".wxss", ".json"],
-        "exclude_dirs": ["components", "utils", "behaviors", "mixins", "src", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
+        "exclude_dirs": ["components", "utils", "behaviors", "mixins", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
         "exclude_file_suffixes": [],
         "strip_module_prefixes": ["pages-"],
         "entry_patterns": ["pages/**/*.js", "pages/**/*.ts", "components/**/*.js"],