speccrew 0.7.69 → 0.7.70
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.
|
@@ -10,6 +10,40 @@ tools: Read, Write, Glob, Grep, Bash, Agent
|
|
|
10
10
|
- Feature Spec and API Contract have been confirmed (02_feature_design stage = confirmed)
|
|
11
11
|
- User requests system design execution for confirmed features
|
|
12
12
|
|
|
13
|
+
## EXECUTION PROTOCOL
|
|
14
|
+
|
|
15
|
+
### Action-to-Tool Mapping
|
|
16
|
+
|
|
17
|
+
| XML Block Action | IDE Tool | How to Execute |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| `action="run-script"` | **Terminal tool** | Execute command in terminal |
|
|
20
|
+
| `action="dispatch-to-worker"` | **Agent tool** | Create new `speccrew-task-worker` agent session (NOT Skill tool) |
|
|
21
|
+
| `action="read-file"` | **Read tool** | Read file at specified path |
|
|
22
|
+
| `action="log"` | **Output** | Log message directly to conversation |
|
|
23
|
+
| `action="confirm"` | **Output + Wait** | Present message and wait for user response |
|
|
24
|
+
|
|
25
|
+
### Worker Dispatch Protocol
|
|
26
|
+
|
|
27
|
+
When executing any block with `action="dispatch-to-worker"`:
|
|
28
|
+
|
|
29
|
+
1. **Use Agent tool** to create a new `speccrew-task-worker` agent
|
|
30
|
+
2. Pass `skill_path` from the XML `<field name="skill_path">` to worker
|
|
31
|
+
3. Pass all context parameters from XML `<field name="context">` block
|
|
32
|
+
4. **Wait** for worker agent to complete before proceeding to next block
|
|
33
|
+
5. Verify worker's output file exists at expected path
|
|
34
|
+
|
|
35
|
+
**CRITICAL DISTINCTION**:
|
|
36
|
+
- **Agent tool** = creates a NEW autonomous worker session (for dispatch-to-worker)
|
|
37
|
+
- **Skill tool** = executes skill inline in current session (for run-skill)
|
|
38
|
+
- Using the WRONG tool will cause dispatch failure
|
|
39
|
+
|
|
40
|
+
### Phase 5 Batch Dispatch
|
|
41
|
+
|
|
42
|
+
- Dispatch ONE worker per Feature×Platform combination via Agent tool
|
|
43
|
+
- Max concurrent workers per batch: defined in XML
|
|
44
|
+
- Pass `skip_confirmation: true` and `skip_index_generation: true` in batch context
|
|
45
|
+
- Wait for all workers in current batch to complete before dispatching next batch
|
|
46
|
+
|
|
13
47
|
## AgentFlow Definition
|
|
14
48
|
|
|
15
49
|
<!-- @agentflow: SKILL.xml -->
|