mindsystem-cc 3.10.1 → 3.11.0
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.
- package/README.md +1 -1
- package/agents/ms-designer.md +8 -8
- package/agents/ms-executor.md +14 -163
- package/agents/ms-plan-checker.md +2 -3
- package/agents/ms-plan-writer.md +5 -11
- package/agents/ms-verify-fixer.md +1 -1
- package/commands/ms/design-phase.md +12 -10
- package/commands/ms/execute-phase.md +0 -9
- package/commands/ms/help.md +1 -3
- package/commands/ms/review-design.md +9 -5
- package/commands/ms/verify-work.md +1 -1
- package/mindsystem/references/design-directions.md +1 -1
- package/mindsystem/references/mock-patterns.md +48 -0
- package/mindsystem/references/plan-format.md +2 -129
- package/mindsystem/references/scope-estimation.md +3 -3
- package/mindsystem/templates/config.json +0 -2
- package/mindsystem/templates/design.md +1 -1
- package/mindsystem/templates/phase-prompt.md +6 -142
- package/mindsystem/templates/summary.md +24 -0
- package/mindsystem/workflows/execute-phase.md +4 -98
- package/mindsystem/workflows/execute-plan.md +12 -517
- package/mindsystem/workflows/generate-mocks.md +74 -0
- package/mindsystem/workflows/mockup-generation.md +1 -1
- package/mindsystem/workflows/plan-phase.md +7 -24
- package/mindsystem/workflows/verify-work.md +97 -17
- package/package.json +1 -1
- package/scripts/__pycache__/compare_mockups.cpython-314.pyc +0 -0
- package/scripts/compare_mockups.py +219 -0
- package/mindsystem/references/checkpoint-detection.md +0 -50
- package/mindsystem/references/checkpoints.md +0 -788
|
@@ -3,7 +3,7 @@ Execute all plans in a phase using wave-based parallel execution. Orchestrator s
|
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<core_principle>
|
|
6
|
-
The orchestrator's job is coordination, not execution. Each subagent loads the full execute-plan context itself. Orchestrator discovers plans, analyzes dependencies, groups into waves, spawns agents,
|
|
6
|
+
The orchestrator's job is coordination, not execution. Each subagent loads the full execute-plan context itself. Orchestrator discovers plans, analyzes dependencies, groups into waves, spawns agents, collects results.
|
|
7
7
|
</core_principle>
|
|
8
8
|
|
|
9
9
|
<required_reading>
|
|
@@ -68,13 +68,11 @@ ls -1 "$PHASE_DIR"/*-SUMMARY.md 2>/dev/null | sort
|
|
|
68
68
|
|
|
69
69
|
For each plan, read frontmatter to extract:
|
|
70
70
|
- `wave: N` - Execution wave (pre-computed)
|
|
71
|
-
- `autonomous: true/false` - Whether plan has checkpoints
|
|
72
71
|
|
|
73
72
|
Build plan inventory:
|
|
74
73
|
- Plan path
|
|
75
74
|
- Plan ID (e.g., "03-01")
|
|
76
75
|
- Wave number
|
|
77
|
-
- Autonomous flag
|
|
78
76
|
- Completion status (SUMMARY exists = complete)
|
|
79
77
|
|
|
80
78
|
Skip completed plans. If all complete, report "Phase already executed" and exit.
|
|
@@ -87,8 +85,7 @@ Read `wave` from each plan's frontmatter and group by wave number:
|
|
|
87
85
|
# For each plan, extract wave from frontmatter
|
|
88
86
|
for plan in $PHASE_DIR/*-PLAN.md; do
|
|
89
87
|
wave=$(grep "^wave:" "$plan" | cut -d: -f2 | tr -d ' ')
|
|
90
|
-
|
|
91
|
-
echo "$plan:$wave:$autonomous"
|
|
88
|
+
echo "$plan:$wave"
|
|
92
89
|
done
|
|
93
90
|
```
|
|
94
91
|
|
|
@@ -113,7 +110,7 @@ Report wave structure with context:
|
|
|
113
110
|
|------|-------|----------------|
|
|
114
111
|
| 1 | 01-01, 01-02 | {from plan objectives} |
|
|
115
112
|
| 2 | 01-03 | {from plan objectives} |
|
|
116
|
-
| 3 | 01-04
|
|
113
|
+
| 3 | 01-04 | {from plan objectives} |
|
|
117
114
|
|
|
118
115
|
```
|
|
119
116
|
|
|
@@ -167,7 +164,6 @@ Execute each wave in sequence. Autonomous plans within a wave run in parallel.
|
|
|
167
164
|
<execution_context>
|
|
168
165
|
@~/.claude/mindsystem/workflows/execute-plan.md
|
|
169
166
|
@~/.claude/mindsystem/templates/summary.md
|
|
170
|
-
@~/.claude/mindsystem/references/checkpoints.md
|
|
171
167
|
@~/.claude/mindsystem/references/tdd.md
|
|
172
168
|
</execution_context>
|
|
173
169
|
|
|
@@ -228,93 +224,8 @@ Execute each wave in sequence. Autonomous plans within a wave run in parallel.
|
|
|
228
224
|
- If continue: proceed to next wave (dependent plans may also fail)
|
|
229
225
|
- If stop: exit with partial completion report
|
|
230
226
|
|
|
231
|
-
5. **
|
|
227
|
+
5. **Proceed to next wave**
|
|
232
228
|
|
|
233
|
-
See `<checkpoint_handling>` for details.
|
|
234
|
-
|
|
235
|
-
6. **Proceed to next wave**
|
|
236
|
-
|
|
237
|
-
</step>
|
|
238
|
-
|
|
239
|
-
<step name="checkpoint_handling">
|
|
240
|
-
Plans with `autonomous: false` require user interaction.
|
|
241
|
-
|
|
242
|
-
**Detection:** Check `autonomous` field in frontmatter.
|
|
243
|
-
|
|
244
|
-
**Execution flow for checkpoint plans:**
|
|
245
|
-
|
|
246
|
-
1. **Spawn agent for checkpoint plan:**
|
|
247
|
-
```
|
|
248
|
-
Task(prompt="{subagent-task-prompt}", subagent_type="general-purpose")
|
|
249
|
-
```
|
|
250
|
-
|
|
251
|
-
2. **Agent runs until checkpoint:**
|
|
252
|
-
- Executes auto tasks normally
|
|
253
|
-
- Reaches checkpoint task (e.g., `type="checkpoint:human-verify"`) or auth gate
|
|
254
|
-
- Agent returns with structured checkpoint (see checkpoint-return.md template)
|
|
255
|
-
|
|
256
|
-
3. **Agent return includes (structured format):**
|
|
257
|
-
- Completed Tasks table with commit hashes and files
|
|
258
|
-
- Current task name and blocker
|
|
259
|
-
- Checkpoint type and details for user
|
|
260
|
-
- What's awaited from user
|
|
261
|
-
|
|
262
|
-
4. **Orchestrator presents checkpoint to user:**
|
|
263
|
-
|
|
264
|
-
Extract and display the "Checkpoint Details" and "Awaiting" sections from agent return:
|
|
265
|
-
```
|
|
266
|
-
## Checkpoint: [Type]
|
|
267
|
-
|
|
268
|
-
**Plan:** 03-03 Dashboard Layout
|
|
269
|
-
**Progress:** 2/3 tasks complete
|
|
270
|
-
|
|
271
|
-
[Checkpoint Details section from agent return]
|
|
272
|
-
|
|
273
|
-
[Awaiting section from agent return]
|
|
274
|
-
```
|
|
275
|
-
|
|
276
|
-
5. **User responds:**
|
|
277
|
-
- "approved" / "done" → spawn continuation agent
|
|
278
|
-
- Description of issues → spawn continuation agent with feedback
|
|
279
|
-
- Decision selection → spawn continuation agent with choice
|
|
280
|
-
|
|
281
|
-
6. **Spawn continuation agent (NOT resume):**
|
|
282
|
-
|
|
283
|
-
Use the continuation-prompt.md template:
|
|
284
|
-
```
|
|
285
|
-
Task(
|
|
286
|
-
prompt=filled_continuation_template,
|
|
287
|
-
subagent_type="general-purpose"
|
|
288
|
-
)
|
|
289
|
-
```
|
|
290
|
-
|
|
291
|
-
Fill template with:
|
|
292
|
-
- `{completed_tasks_table}`: From agent's checkpoint return
|
|
293
|
-
- `{resume_task_number}`: Current task from checkpoint
|
|
294
|
-
- `{resume_task_name}`: Current task name from checkpoint
|
|
295
|
-
- `{user_response}`: What user provided
|
|
296
|
-
- `{resume_instructions}`: Based on checkpoint type (see continuation-prompt.md)
|
|
297
|
-
|
|
298
|
-
7. **Continuation agent executes:**
|
|
299
|
-
- Verifies previous commits exist
|
|
300
|
-
- Continues from resume point
|
|
301
|
-
- May hit another checkpoint (repeat from step 4)
|
|
302
|
-
- Or completes plan
|
|
303
|
-
|
|
304
|
-
8. **Repeat until plan completes or user stops**
|
|
305
|
-
|
|
306
|
-
**Why fresh agent instead of resume:**
|
|
307
|
-
Resume relies on Claude Code's internal serialization which breaks with parallel tool calls.
|
|
308
|
-
Fresh agents with explicit state are more reliable and maintain full context.
|
|
309
|
-
|
|
310
|
-
**Checkpoint in parallel context:**
|
|
311
|
-
If a plan in a parallel wave has a checkpoint:
|
|
312
|
-
- Spawn as normal
|
|
313
|
-
- Agent pauses at checkpoint and returns with structured state
|
|
314
|
-
- Other parallel agents may complete while waiting
|
|
315
|
-
- Present checkpoint to user
|
|
316
|
-
- Spawn continuation agent with user response
|
|
317
|
-
- Wait for all agents to finish before next wave
|
|
318
229
|
</step>
|
|
319
230
|
|
|
320
231
|
<step name="aggregate_results">
|
|
@@ -617,10 +528,6 @@ Each subagent: Fresh 200k context
|
|
|
617
528
|
- Stop execution
|
|
618
529
|
- Report for manual investigation
|
|
619
530
|
|
|
620
|
-
**Checkpoint fails to resolve:**
|
|
621
|
-
- User can't approve or provides repeated issues
|
|
622
|
-
- Ask: "Skip this plan?" or "Abort phase execution?"
|
|
623
|
-
- Record partial progress in STATE.md
|
|
624
531
|
</failure_handling>
|
|
625
532
|
|
|
626
533
|
<resumption>
|
|
@@ -637,5 +544,4 @@ If phase execution was interrupted (context limit, user exit, error):
|
|
|
637
544
|
**STATE.md tracks:**
|
|
638
545
|
- Last completed plan
|
|
639
546
|
- Current wave
|
|
640
|
-
- Any pending checkpoints
|
|
641
547
|
</resumption>
|