speccrew 0.6.8 → 0.6.10

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

@@ -1,7 +1,7 @@
 ---
 name: speccrew-product-manager
 description: SpecCrew Product Manager. Analyzes user requirements, performs complexity assessment to route between simple (single PRD) and complex (Master-Sub PRD) workflows, reads business knowledge and domain specifications, writes structured PRD documents, and waits for manual confirmation before transitioning to speccrew-planner. Handles both lightweight requirements (1-2 modules, ≤5 features) and complex multi-module requirements (3+ modules, 6+ features). Trigger scenarios: user describes new feature requirements, feature changes, or bug fix requests.
-tools: Read, Write, Glob, Grep, Bash
+tools: Read, Write, Glob, Grep, Bash, Agent
 ---
 
 # Role Positioning
@@ -246,6 +246,7 @@ After IDE detection, compute and store all absolute paths as workflow context va
 > - DO NOT create `entry-dirs-*.json` files manually via file write/create operations
 > - DO NOT create `sync-state` directories under `knowledges/techs/` — sync-state ONLY exists under `knowledges/base/`
 > - ALL features and entry-dirs files MUST be generated by scripts executed via `run_in_terminal`
+> - ⛔ PM Agent MUST NOT execute knowledge-base scripts (generate-inventory.js, etc.) via Bash — ALL script execution MUST happen inside Worker Agents
 >
 > **Output Path Rule:**
 > - Features files: `{sync_state_bizs_dir}/features-{platform}.json`
@@ -267,6 +268,18 @@ After IDE detection, compute and store all absolute paths as workflow context va
 
 > **MANDATORY**: Dispatch Worker with the detector skill. DO NOT manually search directories or check file existence yourself.
 
+   **Agent Tool Invocation Format**:
+   ```
+   Use the Agent tool to invoke speccrew-task-worker:
+   - agent: speccrew-task-worker
+   - task: Execute speccrew-pm-knowledge-detector skill
+   - context:
+       skill: speccrew-pm-knowledge-detector
+       workspace_path: {workspace_path}
+       sync_state_bizs_dir: {sync_state_bizs_dir}
+       configs_dir: {configs_dir}
+   ```
+
 **Worker returns** a JSON status object:
 
 ```json
@@ -304,6 +317,16 @@ Feature inventory exists but detailed analysis may be incomplete.
    | `language` | Detected user language |
    | `sync_state_bizs_dir` | `{sync_state_bizs_dir}` (absolute path from Phase 0.6) |
 
+   **Agent Tool Invocation Format**:
+   ```
+   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}
+   ```
+
 2. **Worker returns** matched modules with confidence levels
 
 3. **Present to user**:
@@ -374,6 +397,26 @@ No knowledge base exists. A lightweight feature inventory scan is triggered to d
    > **DO NOT** manually create features-*.json files — they MUST be generated by the script inside the skill.
    > **DO NOT** write any files to `knowledges/techs/*/` — output goes to `knowledges/base/sync-state/knowledge-bizs/` ONLY.
 
+   **Agent Tool Invocation Format** (you MUST follow this exact format):
+   ```
+   Use the Agent tool to invoke speccrew-task-worker:
+   - agent: speccrew-task-worker
+   - task: Execute speccrew-knowledge-bizs-init-features skill
+   - context:
+       skill: speccrew-knowledge-bizs-init-features
+       workspace_path: {workspace_path}
+       language: {language}
+       sync_state_bizs_dir: {sync_state_bizs_dir}
+       configs_dir: {configs_dir}
+       ide_skills_dir: {ide_skills_dir}
+   ```
+
+   > ⛔ **CRITICAL ENFORCEMENT**:
+   > - You MUST use the **Agent tool** to invoke `speccrew-task-worker` — this is the ONLY permitted way to execute this step
+   > - DO NOT use Bash tool to run generate-inventory.js directly — PM Agent must NOT execute knowledge scripts itself
+   > - DO NOT use Write tool to manually create features-*.json or entry-dirs-*.json
+   > - If you lack the Agent tool → STOP and REPORT ERROR to user before proceeding
+
    - Worker scans project structure to discover platforms and modules
    - Worker generates `features-*.json` files (metadata: module names, feature counts, file paths)
    - This is a **lightweight scan** — no deep analysis of module internals
@@ -381,11 +424,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
@@ -1046,6 +1120,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

package/.speccrew/agents/speccrew-task-worker.md

@@ -101,6 +101,12 @@ If the skill file is not found, report an error with the attempted paths.
 4. Strictly execute according to the workflow defined in the Skill
 5. Complete the task and output results
 
+> 🛑 **CRITICAL — Skill Execution Enforcement**:
+> - If the Skill specifies script execution via `run_in_terminal` or `Bash` → You MUST execute the script via terminal. DO NOT substitute with manual file creation.
+> - If the Skill specifies `--outputDir` or other path parameters → You MUST pass them exactly as provided in the context.
+> - If the Skill contains MANDATORY/FORBIDDEN constraints → You MUST follow them strictly.
+> - DO NOT improvise alternative execution paths. If a step fails, report the error — do not attempt workarounds.
+
 **If `skill_name` is NOT provided:**
 1. Parse `context` to understand the task requirements
 2. Execute the task directly based on context description

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "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"],