speccrew 0.7.51 → 0.7.53

package/.speccrew/skills/speccrew-system-designer-orchestration/SKILL.md

@@ -20,7 +20,7 @@ tools: Read, Write, Glob, Grep, Bash, Agent
 > 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="dispatch-to-worker"` → Use **Agent tool** to create a new `speccrew-task-worker` agent, passing skill_path and context
 > - `action="read-file"` → Read via **Read tool**
 > - `action="log"` → Output message directly
 > - `action="confirm"` → Present to user and wait for response
@@ -93,13 +93,17 @@ This skill MUST execute tasks continuously without unnecessary interruptions.
 3. Unrecoverable errors that prevent further progress
 4. Security-sensitive operations (e.g., deleting existing files)
 
-### Phase 3 FORBIDDEN Actions
+### Phase 3 Execution Method — Worker Agent Dispatch
 
-- DO NOT inline-call speccrew-sd-framework-evaluate skill
-- DO NOT read feature spec files yourself for framework evaluation
-- DO NOT create temporary scripts for batch file analysis
-- DO NOT generate framework-evaluation.md as fallback if worker fails
-- Worker dispatch failure = ABORT (report error, do NOT retry with inline execution)
+**HOW TO DISPATCH**: When executing Phase 3 block P3-B1 (action="dispatch-to-worker"):
+1. Use the **Agent tool** to create a new `speccrew-task-worker` agent
+2. Pass `skill_path` to the worker: `${workspace_path}/.speccrew/skills/speccrew-sd-framework-evaluate/SKILL.md`
+3. Pass context parameters: workspace_path, iteration_path, feature_spec_paths, api_contract_paths, techs_knowledge_paths, output_path
+4. **Wait** for the worker agent to complete and return results
+5. After worker completes, verify framework-evaluation.md exists at output_path
+6. Then proceed to Phase 3.5 HARD STOP for user confirmation
+
+**CRITICAL**: The `Agent tool` creates a NEW agent session — this is completely different from the `Skill tool` which executes inline.
 
 ### HARD STOP Checkpoints
 
@@ -108,3 +112,21 @@ This workflow has **mandatory HARD STOP** checkpoints at:
 - **Phase 6.1**: Joint design confirmation (user MUST approve all designs)
 
 DO NOT proceed past these checkpoints without explicit user confirmation.
+
+## Must Do
+
+- **READ workflow.agentflow.xml FIRST** — Execute blocks in document order
+- **Use Agent tool for dispatch-to-worker blocks** — Agent tool creates a new speccrew-task-worker agent session
+- **Pass skill_path explicitly to worker** — Worker cannot find skills via glob on first run
+- **Wait for worker completion before verifying output** — Do not proceed until worker returns
+- **Update progress via update-progress.js script** — Use run-script commands exactly as defined in XML
+
+## Must Not Do
+
+- **DO NOT use Skill tool for Phase 3 framework evaluation** — Skill tool executes inline, Agent tool creates a worker
+- **DO NOT read feature spec files yourself** — Workers read them
+- **DO NOT read tech knowledge files yourself** — Workers read them
+- **DO NOT generate framework-evaluation.md yourself** — Only workers generate it
+- **DO NOT create scripts for batch analysis** — Workers handle this via their own skill
+- **DO NOT fallback to inline execution if worker fails** — ABORT instead
+- **DO NOT skip reading workflow.agentflow.xml** — XML is the execution authority

package/.speccrew/skills/speccrew-system-designer-orchestration/workflow.agentflow.xml

@@ -168,6 +168,7 @@
       <field name="text">FORBIDDEN: Do NOT create scripts or read feature files yourself for framework evaluation</field>
       <field name="text">MANDATORY: Framework evaluation MUST be delegated to worker agent via block P3-B1</field>
       <field name="text">If worker dispatch fails, ABORT — do NOT fallback to inline execution</field>
+      <field name="text">TOOL MAPPING: action="dispatch-to-worker" → Use Agent tool (NOT Skill tool) to create speccrew-task-worker agent</field>
     </block>
 
     <block type="rule" id="P3-R1" level="mandatory" desc="Worker Dispatch Rule">
@@ -178,7 +179,7 @@
 
     <!-- Step 3.1: Dispatch Worker Agent for Framework Evaluation -->
     <block type="task" id="P3-B1" action="dispatch-to-worker" status="pending"
-           desc="Dispatch single worker agent for framework evaluation">
+           desc="Dispatch single worker agent for framework evaluation. Use /speccrew-task-worker agent, NOT Skill tool">
       <field name="agent">speccrew-task-worker</field>
       <field name="skill">speccrew-sd-framework-evaluate</field>
       <field name="max_concurrent">1</field>

package/package.json

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