speccrew 0.7.4 → 0.7.6

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+/**
+ * generate-inventory.js
+ * 
+ * Generate features.json inventory for a single platform.
+ * This script is called by speccrew-knowledge-bizs-init-features workflow.
+ * 
+ * Usage:
+ *   node generate-inventory.js --entryDirsFile <path> --outputDir <path>
+ * 
+ * Arguments:
+ *   --entryDirsFile    Path to entry-dirs JSON file
+ *   --outputDir        Output directory for features.json
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Parse command line arguments
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const parsed = {};
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const value = args[i + 1];
+      if (value && !value.startsWith('--')) {
+        parsed[key] = value;
+        i++;
+      } else {
+        parsed[key] = true;
+      }
+    }
+  }
+  
+  return parsed;
+}
+
+// Generate timestamp in format YYYY-MM-DD-HHMMSS
+function generateTimestamp() {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  const hours = String(now.getHours()).padStart(2, '0');
+  const minutes = String(now.getMinutes()).padStart(2, '0');
+  const seconds = String(now.getSeconds()).padStart(2, '0');
+  return `${year}-${month}-${day}-${hours}${minutes}${seconds}`;
+}
+
+// Convert absolute path to project-relative path
+function toRelativePath(absolutePath, projectRoot) {
+  // Normalize paths
+  const normalizedAbs = path.normalize(absolutePath).replace(/\\/g, '/');
+  const normalizedRoot = path.normalize(projectRoot).replace(/\\/g, '/');
+  
+  if (normalizedAbs.startsWith(normalizedRoot)) {
+    const relative = normalizedAbs.slice(normalizedRoot.length).replace(/^\/+/, '');
+    return relative;
+  }
+  return normalizedAbs;
+}
+
+// Generate document path for a feature
+// Format: speccrew-workspace/knowledges/bizs/{platformId}/{module}/{subpath}/{filename}.md
+function generateDocumentPath(platformId, module, sourcePath, projectRoot) {
+  // Extract filename without extension
+  const basename = path.basename(sourcePath, path.extname(sourcePath));
+  
+  // Get directory relative to module root
+  const relativePath = toRelativePath(sourcePath, projectRoot);
+  
+  // Parse the source path to extract module and subpath
+  // Expected format: {platformSourceRoot}/{module}/{subpath}/{file}
+  const pathParts = relativePath.split('/');
+  
+  // Find module index
+  let moduleIndex = -1;
+  for (let i = 0; i < pathParts.length; i++) {
+    if (pathParts[i] === module) {
+      moduleIndex = i;
+      break;
+    }
+  }
+  
+  // Build subpath (everything between module and filename)
+  let subpath = '';
+  if (moduleIndex >= 0 && moduleIndex < pathParts.length - 2) {
+    // There are directories between module and filename
+    subpath = pathParts.slice(moduleIndex + 1, pathParts.length - 1).join('/');
+  }
+  
+  // Construct document path using platformId (which follows {platformType}-{techStack} format)
+  // e.g., backend-fastapi, web-vue3, mobile-uniapp
+  const docPathParts = ['speccrew-workspace', 'knowledges', 'bizs', platformId, module];
+  
+  if (subpath) {
+    docPathParts.push(subpath);
+  }
+  
+  docPathParts.push(`${basename}.md`);
+  
+  return docPathParts.join('/');
+}
+
+// Main function
+function main() {
+  const args = parseArgs();
+  
+  // Validate required arguments
+  if (!args.entryDirsFile) {
+    console.error('Error: --entryDirsFile is required');
+    process.exit(1);
+  }
+  
+  if (!args.outputDir) {
+    console.error('Error: --outputDir is required');
+    process.exit(1);
+  }
+  
+  const entryDirsFile = path.resolve(args.entryDirsFile);
+  const outputDir = path.resolve(args.outputDir);
+  
+  // Check if entry-dirs file exists
+  if (!fs.existsSync(entryDirsFile)) {
+    console.error(`Error: Entry-dirs file not found: ${entryDirsFile}`);
+    process.exit(1);
+  }
+  
+  // Read and parse entry-dirs JSON
+  let entryDirsData;
+  try {
+    const content = fs.readFileSync(entryDirsFile, 'utf-8');
+    entryDirsData = JSON.parse(content);
+  } catch (error) {
+    console.error(`Error: Failed to parse entry-dirs file: ${error.message}`);
+    process.exit(1);
+  }
+  
+  // Validate entry-dirs structure
+  if (!entryDirsData.modules || !Array.isArray(entryDirsData.modules) || entryDirsData.modules.length === 0) {
+    console.error('Error: entry-dirs JSON must have non-empty modules array');
+    process.exit(1);
+  }
+  
+  // Extract platform info from entry-dirs data
+  const platformId = entryDirsData.platformId || 'unknown-platform';
+  const platformName = entryDirsData.platformName || platformId;
+  const platformType = entryDirsData.platformType || 'unknown';
+  const platformSubtype = entryDirsData.platformSubtype || '';
+  const techStack = entryDirsData.techStack || [];
+  const sourceRoot = entryDirsData.sourcePath || '';
+  
+  // Project root is the parent of speccrew-workspace
+  const projectRoot = path.resolve(outputDir, '..', '..', '..');
+  
+  // Generate features for each module
+  const features = [];
+  const modules = [];
+  
+  for (const moduleData of entryDirsData.modules) {
+    const moduleName = moduleData.name;
+    const entryDirs = moduleData.entryDirs || [];
+    
+    let moduleFeatureCount = 0;
+    
+    for (const entryDir of entryDirs) {
+      // Scan files in entry directory
+      const scanDirectory = (dir) => {
+        const files = [];
+        
+        try {
+          const entries = fs.readdirSync(dir, { withFileTypes: true });
+          
+          for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            
+            if (entry.isDirectory()) {
+              // Recursively scan subdirectories
+              files.push(...scanDirectory(fullPath));
+            } else if (entry.isFile()) {
+              // Check if file is a source file based on platform type
+              const ext = path.extname(entry.name).toLowerCase();
+              const isSourceFile = isValidSourceFile(ext, platformType);
+              
+              if (isSourceFile) {
+                files.push(fullPath);
+              }
+            }
+          }
+        } catch (error) {
+          console.warn(`Warning: Failed to scan directory ${dir}: ${error.message}`);
+        }
+        
+        return files;
+      };
+      
+      const sourceFiles = scanDirectory(entryDir);
+      
+      for (const sourceFile of sourceFiles) {
+        const relativeSourcePath = toRelativePath(sourceFile, projectRoot);
+        const fileName = path.basename(sourceFile, path.extname(sourceFile));
+        
+        // Generate document path using platformId
+        const documentPath = generateDocumentPath(platformId, moduleName, sourceFile, projectRoot);
+        
+        features.push({
+          fileName: fileName,
+          sourcePath: relativeSourcePath,
+          documentPath: documentPath,
+          module: moduleName,
+          analyzed: false,
+          startedAt: null,
+          completedAt: null,
+          analysisNotes: null
+        });
+        
+        moduleFeatureCount++;
+      }
+    }
+    
+    modules.push({
+      name: moduleName,
+      featureCount: moduleFeatureCount
+    });
+  }
+  
+  // Build output JSON
+  const outputData = {
+    platformName: platformName,
+    platformType: platformType,
+    platformSubtype: platformSubtype,
+    platformId: platformId,
+    sourcePath: sourceRoot,
+    techStack: techStack,
+    modules: modules,
+    totalFiles: features.length,
+    analyzedCount: 0,
+    pendingCount: features.length,
+    generatedAt: generateTimestamp(),
+    features: features
+  };
+  
+  // Ensure output directory exists
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  
+  // Write output file
+  const outputFile = path.join(outputDir, `features-${platformId}.json`);
+  try {
+    fs.writeFileSync(outputFile, JSON.stringify(outputData, null, 2), 'utf-8');
+    console.log(`Generated: ${outputFile}`);
+    console.log(`  Platform: ${platformName} (${platformId})`);
+    console.log(`  Type: ${platformType}${platformSubtype ? '/' + platformSubtype : ''}`);
+    console.log(`  Features: ${features.length}`);
+    console.log(`  Modules: ${modules.map(m => m.name).join(', ')}`);
+  } catch (error) {
+    console.error(`Error: Failed to write output file: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+// Check if file extension is valid for the platform type
+function isValidSourceFile(ext, platformType) {
+  const backendExts = ['.java', '.kt', '.py', '.go', '.rs', '.cs', '.php', '.rb'];
+  const webExts = ['.vue', '.tsx', '.jsx', '.ts', '.js', '.svelte'];
+  const mobileExts = ['.vue', '.tsx', '.jsx', '.ts', '.js', '.dart', '.swift', '.kt', '.java'];
+  const desktopExts = ['.vue', '.tsx', '.jsx', '.ts', '.js', '.cs', '.xaml'];
+  
+  switch (platformType) {
+    case 'backend':
+      return backendExts.includes(ext);
+    case 'web':
+      return webExts.includes(ext);
+    case 'mobile':
+      return mobileExts.includes(ext);
+    case 'desktop':
+      return desktopExts.includes(ext);
+    default:
+      // Accept all common source file extensions
+      return [...backendExts, ...webExts, ...mobileExts, ...desktopExts].includes(ext);
+  }
+}
+
+// Run main function
+main();

package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/scripts/reindex-modules.js

@@ -3,7 +3,7 @@
  * reindex-modules.js - Deterministic script to re-extract module names from existing features JSON with updated exclude_dirs
  * 
  * Usage:
- *   node reindex-modules.js --featuresFile "path/to/features-backend-system.json" --projectRoot "d:\dev\ruoyi-vue-pro"
+ *   node reindex-modules.js --featuresFile "path/to/features-backend-fastapi.json" --projectRoot "d:\dev\ruoyi-vue-pro"
  * 
  * Optional parameters:
  *   --platformType "backend" - If not provided, read from features JSON's platformType field

package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/workflow.agentflow.xml

@@ -376,12 +376,179 @@
   <block type="checkpoint" id="CP7" name="marker-written" desc="Marker file written">
     <field name="verify" value="file.exists(${completed_dir}/${markerName}.done.json)"/>
   </block>
-  
+
+  <!-- Step 7b: Construct and Append Graph Data -->
+  <!-- Construct Graph Nodes from UI Analysis -->
+  <block type="task" id="B32a" action="analyze" desc="Construct page node">
+    <field name="type" value="page"/>
+    <field name="id" value="page-${module}-${fileName}"/>
+    <field name="name" value="${fileName}"/>
+    <field name="module" value="${module}"/>
+    <field name="sourcePath" value="${sourcePath}"/>
+    <field name="documentPath" value="${documentPath}"/>
+    <field name="platform" value="${platform_type}-${platform_subtype}"/>
+    <field name="output" var="pageNode"/>
+  </block>
+
+  <block type="task" id="B32b" action="analyze" desc="Construct component nodes">
+    <field name="components" value="${analysisResult.components}"/>
+    <field name="module" value="${module}"/>
+    <field name="documentPath" value="${documentPath}"/>
+    <field name="output" var="componentNodes"/>
+  </block>
+
+  <block type="task" id="B32c" action="analyze" desc="Construct route nodes">
+    <field name="routes" value="${analysisResult.routes}"/>
+    <field name="module" value="${module}"/>
+    <field name="sourcePath" value="${sourcePath}"/>
+    <field name="output" var="routeNodes"/>
+  </block>
+
+  <!-- Construct Graph Edges -->
+  <block type="task" id="B32d" action="analyze" desc="Construct navigates edges">
+    <field name="pageId" value="page-${module}-${fileName}"/>
+    <field name="navigations" value="${analysisResult.navigations}"/>
+    <field name="module" value="${module}"/>
+    <field name="output" var="navigatesEdges"/>
+  </block>
+
+  <block type="task" id="B32e" action="analyze" desc="Construct contains edges">
+    <field name="pageId" value="page-${module}-${fileName}"/>
+    <field name="components" value="${analysisResult.components}"/>
+    <field name="module" value="${module}"/>
+    <field name="output" var="containsEdges"/>
+  </block>
+
+  <block type="task" id="B32f" action="analyze" desc="Construct calls-api edges">
+    <field name="pageId" value="page-${module}-${fileName}"/>
+    <field name="apiCalls" value="${analysisResult.apis}"/>
+    <field name="module" value="${module}"/>
+    <field name="output" var="callsApiEdges"/>
+  </block>
+
+  <!-- Append Graph Data to nodes.json and edges.json -->
+  <block type="task" id="B32g" action="run-script" desc="Append graph nodes to nodes.json">
+    <field name="command">node -e "
+const fs = require('fs');
+const path = require('path');
+const graphDir = path.join('${workspace_path}', 'speccrew-workspace', 'knowledges', 'bizs', 'graph');
+const nodesFile = path.join(graphDir, 'nodes.json');
+
+// Ensure directory exists
+if (!fs.existsSync(graphDir)) {
+  fs.mkdirSync(graphDir, { recursive: true });
+}
+
+// Read existing nodes or initialize empty array
+let existingNodes = [];
+if (fs.existsSync(nodesFile)) {
+  try {
+    existingNodes = JSON.parse(fs.readFileSync(nodesFile, 'utf8'));
+    if (!Array.isArray(existingNodes)) existingNodes = [];
+  } catch (e) {
+    existingNodes = [];
+  }
+}
+
+// Parse new nodes from input
+const newNodes = [];
+if ('${pageNode}') {
+  try {
+    const page = JSON.parse('${pageNode}');
+    if (page && page.id) newNodes.push(page);
+  } catch (e) {}
+}
+if ('${componentNodes}') {
+  try {
+    const comps = JSON.parse('${componentNodes}');
+    if (Array.isArray(comps)) newNodes.push(...comps);
+  } catch (e) {}
+}
+if ('${routeNodes}') {
+  try {
+    const routes = JSON.parse('${routeNodes}');
+    if (Array.isArray(routes)) newNodes.push(...routes);
+  } catch (e) {}
+}
+
+// Deduplicate by id
+const nodeMap = new Map();
+existingNodes.forEach(n => nodeMap.set(n.id, n));
+newNodes.forEach(n => nodeMap.set(n.id, n));
+
+// Write back
+fs.writeFileSync(nodesFile, JSON.stringify(Array.from(nodeMap.values()), null, 2));
+console.log('Nodes appended:', newNodes.length);
+"
+    </field>
+  </block>
+
+  <block type="task" id="B32h" action="run-script" desc="Append graph edges to edges.json">
+    <field name="command">node -e "
+const fs = require('fs');
+const path = require('path');
+const graphDir = path.join('${workspace_path}', 'speccrew-workspace', 'knowledges', 'bizs', 'graph');
+const edgesFile = path.join(graphDir, 'edges.json');
+
+// Read existing edges or initialize empty array
+let existingEdges = [];
+if (fs.existsSync(edgesFile)) {
+  try {
+    existingEdges = JSON.parse(fs.readFileSync(edgesFile, 'utf8'));
+    if (!Array.isArray(existingEdges)) existingEdges = [];
+  } catch (e) {
+    existingEdges = [];
+  }
+}
+
+// Parse new edges from input
+const newEdges = [];
+if ('${navigatesEdges}') {
+  try {
+    const edges = JSON.parse('${navigatesEdges}');
+    if (Array.isArray(edges)) newEdges.push(...edges);
+  } catch (e) {}
+}
+if ('${containsEdges}') {
+  try {
+    const edges = JSON.parse('${containsEdges}');
+    if (Array.isArray(edges)) newEdges.push(...edges);
+  } catch (e) {}
+}
+if ('${callsApiEdges}') {
+  try {
+    const edges = JSON.parse('${callsApiEdges}');
+    if (Array.isArray(edges)) newEdges.push(...edges);
+  } catch (e) {}
+}
+
+// Deduplicate by composite key (source+target+type)
+const edgeMap = new Map();
+existingEdges.forEach(e => {
+  const key = (e.source || '') + '|' + (e.target || '') + '|' + (e.type || '');
+  edgeMap.set(key, e);
+});
+newEdges.forEach(e => {
+  const key = (e.source || '') + '|' + (e.target || '') + '|' + (e.type || '');
+  edgeMap.set(key, e);
+});
+
+// Write back
+fs.writeFileSync(edgesFile, JSON.stringify(Array.from(edgeMap.values()), null, 2));
+console.log('Edges appended:', newEdges.length);
+"
+    </field>
+  </block>
+
+  <block type="checkpoint" id="CP-graph" name="graph-written" desc="Graph data written">
+    <field name="verify" value="true"/>
+  </block>
+
   <block type="event" id="E10" action="log" level="info" desc="Log marker status">
-    <field name="message" value="Step 7 Status: COMPLETED - Done marker file written to ${completed_dir}/${markerName}.done.json"/>
+    <field name="message" value="Step 7 Status: COMPLETED - Done marker and graph data written to ${completed_dir}/${markerName}.done.json"/>
   </block>
 
-  <!-- ==================== FINAL OUTPUT ==================== -->
+  <!-- ==================== FINAL OUTPUT ================= === -->
   <block type="output" id="O1" desc="UI feature analysis output results">
     <field name="status" value="success"/>
     <field name="feature_name" from="${fileName}"/>

package/.speccrew/skills/speccrew-knowledge-graph-write/SKILL.md

@@ -25,7 +25,7 @@ Dispatch Agent (speccrew-knowledge-dispatch)
 | Variable | Type | Description | Example |
 |----------|------|-------------|---------|
 | `{{action}}` | string | Write action to perform | `"batch-write"`, `"init-module"`, `"update-node"`, `"remove-node"` |
-| `{{platformId}}` | string | Platform identifier for directory segregation | `"backend-system"`, `"backend-ai"`, `"web-vue"`, `"mobile-uniapp"` |
+| `{{platformId}}` | string | Platform identifier for directory segregation | `"backend-fastapi"`, `"backend-spring"`, `"web-vue"`, `"mobile-uniapp"` |
 | `{{module}}` | string | Target business module | `"system"`, `"trade"`, `"infra"` |
 | `{{graphData}}` | object | Graph data from skill output (for batch-write) | `{ "nodes": [...], "edges": [...] }` |
 | `{{nodeId}}` | string | Node ID (for update-node / remove-node) | `"api-system-user-list"` |

package/.speccrew/skills/speccrew-pm-module-initializer/SKILL.md

@@ -39,7 +39,7 @@ Generate analyze task plan for a single business module. Reads features-*.json,
 | `features_file` | string | Yes | Path to the platform's features-{platform}.json file |
 | `output_path` | string | Yes | Knowledge base output root path (e.g., speccrew-workspace/knowledges) |
 | `completed_dir` | string | Yes | Marker file output directory for api-analyze .done.json markers. Value from PM Agent: `{sync_state_bizs_dir}/completed` |
-| `sourceFile` | string | Yes | Features JSON filename (e.g., "features-backend-system.json"), used for api-analyze marking |
+| `sourceFile` | string | Yes | Features JSON filename (e.g., "features-backend-fastapi.json"), used for api-analyze marking |
 | `language` | string | Yes | Output language (zh / en) |
 | `workspace_path` | string | Yes | Workspace root path for constructing absolute paths |
 

package/.speccrew/skills/speccrew-pm-module-initializer/workflow.agentflow.xml

@@ -14,7 +14,7 @@
     <field name="features_file" required="true" type="string" desc="Path to the platform's features-{platform}.json file"/>
     <field name="output_path" required="true" type="string" desc="Knowledge base output root path"/>
     <field name="completed_dir" required="true" type="string" desc="Marker file output directory for api-analyze .done.json markers"/>
-    <field name="sourceFile" required="true" type="string" desc="Features JSON filename (e.g., features-backend-system.json)"/>
+    <field name="sourceFile" required="true" type="string" desc="Features JSON filename (e.g., features-backend-fastapi.json)"/>
     <field name="language" required="true" type="string" desc="Output language (zh / en)"/>
     <field name="workspace_path" required="true" type="string" desc="Workspace root path for constructing absolute paths"/>
   </block>

package/.speccrew/skills/speccrew-product-manager-orchestration/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: speccrew-product-manager-orchestration
+version: 1.0.0
+description: Product Manager 的核心编排技能，负责需求澄清、复杂度评估、PRD 生成协调与验证。处理简单需求（单 PRD）和复杂需求（Master-Sub PRD）两种工作流路径。
+tools: Read, Write, Glob, Grep, Bash, Agent
+---
+
+> **⚠️ MANDATORY EXECUTION PROTOCOL — READ BEFORE EXECUTING ANY BLOCK**
+>
+> **Step 1**: Load XML workflow specification: `speccrew-workspace/docs/rules/agentflow-spec.md` — this defines all block types and action-to-tool mappings
+>
+> **Step 2**: Execute this SKILL.md's XML workflow **block by block in document order**. For EVERY block, you MUST follow this 3-step cycle:
+>
+> ```
+> 📋 Block [ID] (action=[action]) — [desc]
+> 🔧 Tool: [which IDE tool to call]
+> ✅ Result: [output or status]
+> ```
+>
+> Action-to-tool mapping:
+> - `action="run-skill"` → Invoke via **Skill tool** (pass the `<field name="skill">` value EXACTLY)
+> - `action="run-script"` → Execute via **Terminal tool** (pass the `<field name="command">` value EXACTLY)
+> - `action="dispatch-to-worker"` → Create **Task** via **Task tool** for `speccrew-task-worker`
+> - `action="read-file"` → Read via **Read tool**
+> - `action="log"` → Output message directly
+> - `action="confirm"` → Present to user and wait for response
+>
+> **Step 3**: Execute ALL blocks sequentially without pausing (only stop at explicit `<event action="confirm">` blocks)
+
+# Product Manager Orchestration
+
+Product Manager 的核心编排技能，负责：
+
+1. **Pipeline Progress Management** - 创建/定位迭代目录，管理工作流进度
+2. **Knowledge Base Detection** - 检测知识库状态并按需初始化
+3. **Complexity Assessment** - 评估需求复杂度，决定简单/复杂路径
+4. **Requirement Clarification** - 调用澄清技能，收集需求细节
+5. **PRD Generation Orchestration** - 协调 PRD 生成（简单路径直接调用，复杂路径分发 Worker）
+6. **Verification & Confirmation** - 验证 PRD 完整性，等待用户确认
+
+## Invocation Method
+
+**CRITICAL**: This skill is loaded directly by Product Manager Agent — do NOT invoke via Worker Agent.
+
+```xml
+<block type="task" action="run-skill" desc="Product Manager orchestration workflow">
+  <field name="skill">speccrew-product-manager-orchestration</field>
+</block>
+```
+
+## Input Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `user_requirement` | string | Yes | 用户需求描述或需求文档路径 |
+| `workspace_root` | string | Yes | speccrew-workspace 根目录路径 |
+| `source_path` | string | No | 项目源代码根目录（从 .speccrewrc 读取） |
+| `language` | string | No | 用户语言（默认自动检测） |
+
+## Output
+
+- `status` - 执行状态 (success / partial / failed)
+- `prd_files` - 生成的 PRD 文件列表
+- `feature_list` - 功能清单文件路径
+- `workflow_stage` - 当前工作流阶段状态
+- `next_agent` - 下一步建议的 Agent
+
+---
+
+## AgentFlow Definition
+
+<!-- @agentflow: workflow.agentflow.xml -->
+
+---
+
+## CONTINUOUS EXECUTION RULES
+
+This skill MUST execute tasks continuously without unnecessary interruptions.
+
+### FORBIDDEN Interruptions
+
+1. DO NOT ask user "Should I continue?" after completing a subtask
+2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
+3. DO NOT pause to list what you plan to do next — just do it
+4. DO NOT ask for confirmation before generating output files
+5. DO NOT warn about "large number of files" — proceed with generation
+6. DO NOT offer "Should I proceed with the remaining items?"
+
+### When to Pause (ONLY these cases)
+
+1. CHECKPOINT gates defined in workflow (user confirmation required by design)
+2. Ambiguous requirements that genuinely need clarification
+3. Unrecoverable errors that prevent further progress
+4. Security-sensitive operations (e.g., deleting existing files)
+
+### Orchestrator Principle
+
+This agent is an **orchestrator/dispatcher**. Key constraints:
+
+| Phase | Skill | ORCHESTRATOR Rule |
+|-------|-------|-------------------|
+| Phase 3 | `speccrew-pm-requirement-clarify` | DO NOT clarify requirements yourself — Skill handles all clarification rounds |
+| Phase 4a | `speccrew-pm-requirement-model` | DO NOT perform ISA-95 analysis or module decomposition yourself |
+| Phase 4b | `speccrew-pm-requirement-analysis` | DO NOT generate Master PRD or Dispatch Plan yourself |
+| Phase 5 | `speccrew-pm-sub-prd-generate` (via workers) | DO NOT generate Sub-PRD content yourself |
+| Phase 6 | PM Agent verification | DO NOT modify PRD content — only verify and present |
+
+**UNIVERSAL ABORT RULE:**
+- IF ANY skill fails → STOP and report to user
+- DO NOT generate content as fallback
+- DO NOT proceed to next phase