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.
@@ -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, handles checkpoints, collects results.
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
- autonomous=$(grep "^autonomous:" "$plan" | cut -d: -f2 | tr -d ' ')
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 [checkpoint] | {from plan objectives} |
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. **Execute checkpoint plans between waves:**
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>