speccrew 0.7.71 → 0.7.72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -110,22 +110,22 @@ PM continues to next orchestration block
110
110
  Before executing EVERY block in the orchestration workflow, you MUST announce it in this format:
111
111
 
112
112
  ```
113
- 📋 Block [{ID}] (type={type}, action={action}) — {desc}
113
+ 🏷️ Block [{ID}] (type={type}, action={action}) — {desc}
114
114
  ```
115
115
 
116
116
  **This is NOT optional.** If you dispatch Workers without announcing each Phase block first, you are violating the execution protocol.
117
117
 
118
118
  **Correct example:**
119
119
  ```
120
- 📋 Block [P0] (type=task, action=dispatch-to-worker) — Phase 0: Initialize workflow
120
+ 🏷️ Block [P0] (type=task, action=dispatch-to-worker) — Phase 0: Initialize workflow
121
121
  🔧 Tool: Agent tool → create speccrew-task-worker
122
122
  ✅ Result: Iteration directory created
123
123
 
124
- 📋 Block [P0-RESUME] (type=gateway, mode=exclusive) — Check resume point
124
+ 🏷️ Block [P0-RESUME] (type=gateway, mode=exclusive) — Check resume point
125
125
  🔧 Evaluating: resume_target variable
126
126
  ✅ Result: No resume needed, proceeding from P1
127
127
 
128
- 📋 Block [P1] (type=task, action=dispatch-to-worker) — Phase 1: Knowledge base check
128
+ 🏷️ Block [P1] (type=task, action=dispatch-to-worker) — Phase 1: Knowledge base check
129
129
  🔧 Tool: Agent tool → create speccrew-task-worker
130
130
  ✅ Result: Knowledge status = full
131
131
  ```
@@ -24,7 +24,7 @@ Your core task is: based on the Feature Spec (WHAT to build), design HOW to buil
24
24
  - If SKILL.xml read fails, report error and ABORT — do NOT attempt to proceed without it
25
25
  2. **Announce Workflow**: Log the workflow phases/steps overview from XML structure
26
26
  3. **Execute Blocks Sequentially**: Follow SKILL.xml block order strictly — do NOT improvise or skip blocks
27
- 4. **Report Progress**: Before each Phase/Step, announce: "📍 Phase X: {name}" or "⏳ Step X.X: {description}"
27
+ 4. **Announce Every Block**: Before executing EVERY block, announce using `[Block ID]` format (see Block Execution Announcement Protocol below)
28
28
  5. **Only Pause at HARD STOP**: Only wait for user confirmation at explicitly defined checkpoints (P3.5 Framework Eval, P4.5 Design Overview, P6.1 Joint Confirmation)
29
29
 
30
30
  ### ACTION EXECUTION RULES
@@ -42,6 +42,43 @@ When executing XML workflow blocks, map actions to IDE tools as follows:
42
42
 
43
43
  **VIOLATION**: Skipping XML loading, improvising steps, or proceeding without step announcements = workflow ABORT.
44
44
 
45
+ ## MANDATORY: Block Execution Announcement Protocol
46
+
47
+ Before executing EVERY block in the orchestration workflow, you MUST announce it in this format:
48
+
49
+ ```
50
+ 🏷️ Block [{ID}] (type={type}, action={action}) — {desc}
51
+ ```
52
+
53
+ **This is NOT optional.** If you dispatch Workers without announcing each Phase block first, you are violating the execution protocol.
54
+
55
+ **Correct example:**
56
+ ```
57
+ 🏷️ Block [P3] (type=task, action=dispatch-to-worker) — Phase 3: Framework Evaluation
58
+ 🔧 Tool: Agent tool → create speccrew-task-worker
59
+ ✅ Result: framework-evaluation.md generated
60
+
61
+ 🏷️ Block [P4] (type=task, action=dispatch-to-worker) — Phase 4: Generate DESIGN-OVERVIEW.md
62
+ 🔧 Tool: Agent tool → create speccrew-task-worker
63
+ ✅ Result: DESIGN-OVERVIEW.md generated
64
+
65
+ 🏷️ Block [P5-B3] (type=task, action=dispatch-to-worker) — Dispatch platform design worker
66
+ 🔧 Tool: Agent tool → create speccrew-task-worker (batch)
67
+ ✅ Result: 6 workers dispatched
68
+ ```
69
+
70
+ **Incorrect example (❌ FORBIDDEN):**
71
+ ```
72
+ Now let me dispatch Phase 3...
73
+ Phase 3 done. Moving to Phase 4...
74
+ ```
75
+
76
+ **Rules:**
77
+ - Announce BEFORE execution begins, not after
78
+ - Use exact block IDs from workflow XML (P0, P1, P2, P3, P3.5, P4, P4.5, P5-B1, P5-B2, P5-B3, P5-B4, P5.5, P6, etc.)
79
+ - For gateway blocks, announce which branch is taken
80
+ - For rule blocks, confirm the rule is acknowledged
81
+
45
82
  # 🛑 CRITICAL: dispatch-to-worker Protocol
46
83
 
47
84
  ### Definition
@@ -223,7 +223,7 @@ When executing a Skill that uses XML workflow format (`<workflow>` root element)
223
223
 
224
224
  1. **Before executing each `<block>`**, announce it using this exact format:
225
225
  ```
226
- 📋 Block [{block-id}] (type={block-type}, action={action}) — {block-desc}
226
+ 🏷️ Block [{block-id}] (type={block-type}, action={action}) — {block-desc}
227
227
  ```
228
228
 
229
229
  2. **ALL block types require announcement**: `task`, `loop`, `checkpoint`, `rule`, `gateway`, `input`, `output`.
@@ -86,7 +86,7 @@ You understand the complete AI engineering closed loop: **speccrew-pm → speccr
86
86
  > After reading the specification, parse the XML workflow below and **strictly execute each `<block>` in document order**. For EVERY block, you MUST announce it before execution:
87
87
  >
88
88
  > ```
89
- > 📋 Block [ID] (action=[action]) — [desc]
89
+ > 🏷️ Block [ID] (action=[action]) — [desc]
90
90
  > 🔧 Tool: [which IDE tool to call]
91
91
  > ✅ Result: [output or status]
92
92
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Task, Bash
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep, Bash, Agent
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -11,7 +11,7 @@ tools: Read, Write, Task, Bash
11
11
  > **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:
12
12
  >
13
13
  > ```
14
- > 📋 Block [ID] (action=[action]) — [desc]
14
+ > 🏷️ Block [ID] (action=[action]) — [desc]
15
15
  > 🔧 Tool: [which IDE tool to call]
16
16
  > ✅ Result: [output or status]
17
17
  > ```
@@ -11,7 +11,7 @@ tools: Read, Write, Task, Bash
11
11
  > **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:
12
12
  >
13
13
  > ```
14
- > 📋 Block [ID] (action=[action]) — [desc]
14
+ > 🏷️ Block [ID] (action=[action]) — [desc]
15
15
  > 🔧 Tool: [which IDE tool to call]
16
16
  > ✅ Result: [output or status]
17
17
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep, Bash, Agent
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep, Bash
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep, Bash
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Grep, Glob, Write, Bash, Edit, WebFetch, WebSearch
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (type=[type], action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (type=[type], action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Bash, Skill, Task
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
@@ -12,7 +12,7 @@ tools: Read, Write, Glob, Grep, Bash, Agent
12
12
  > **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:
13
13
  >
14
14
  > ```
15
- > 📋 Block [ID] (action=[action]) — [desc]
15
+ > 🏷️ Block [ID] (action=[action]) — [desc]
16
16
  > 🔧 Tool: [which IDE tool to call]
17
17
  > ✅ Result: [output or status]
18
18
  > ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "speccrew",
3
- "version": "0.7.71",
3
+ "version": "0.7.72",
4
4
  "description": "Spec-Driven Development toolkit for AI-powered IDEs",
5
5
  "author": "charlesmu99",
6
6
  "repository": {
@@ -512,7 +512,7 @@ When executing an AgentFlow XML workflow, the Agent MUST strictly follow the blo
512
512
  Before executing each `<block>`, the agent MUST announce the block being executed. The announcement format is:
513
513
 
514
514
  ```
515
- 📋 Block [{block-id}] (type={block-type}, action={action}) — {block-desc}
515
+ 🏷️ Block [{block-id}] (type={block-type}, action={action}) — {block-desc}
516
516
  ```
517
517
 
518
518
  **Rules:**