mindsystem-cc 3.0.0 → 3.1.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.
@@ -691,7 +691,6 @@ Progress: [progress bar]
691
691
  ```markdown
692
692
  Last session: [current date and time]
693
693
  Stopped at: Completed {phase}-{plan}-PLAN.md
694
- Resume file: [path to .continue-here if exists, else "None"]
695
694
  ```
696
695
 
697
696
  </state_updates>
@@ -303,7 +303,6 @@ Key sections:
303
303
  - Current Position (phase, plan, status, progress bar)
304
304
  - Performance Metrics
305
305
  - Accumulated Context (decisions, todos, blockers)
306
- - Session Continuity
307
306
 
308
307
  ## Draft Presentation Format
309
308
 
@@ -337,28 +337,6 @@ Check project status and intelligently route to next action.
337
337
 
338
338
  Usage: `/ms:progress`
339
339
 
340
- ### Session Management
341
-
342
- **`/ms:resume-work`**
343
- Resume work from previous session with full context restoration.
344
-
345
- - Use when: you paused mid-phase and want to restore context and continue.
346
- - Reads STATE.md for project context
347
- - Shows current position and recent progress
348
- - Offers next actions based on project state
349
-
350
- Usage: `/ms:resume-work`
351
-
352
- **`/ms:pause-work`**
353
- Create context handoff when pausing work mid-phase.
354
-
355
- - Use when: you need to stop mid-stream and want a reliable handoff pointer for next time.
356
- - Creates `.continue-here` file with current state
357
- - Updates STATE.md session continuity section
358
- - Captures in-progress work context
359
-
360
- Usage: `/ms:pause-work`
361
-
362
340
  ### Debugging
363
341
 
364
342
  **`/ms:debug [issue description]`**
@@ -606,14 +584,6 @@ Common options:
606
584
  /ms:check-todos api # Filter by area
607
585
  ```
608
586
 
609
- **Pausing and resuming mid-phase:**
610
-
611
- ```
612
- /ms:pause-work # Creates a handoff pointer
613
- # later...
614
- /ms:resume-work # Restore context and continue
615
- ```
616
-
617
587
  ## Getting Help
618
588
 
619
589
  - Read `.planning/PROJECT.md` for project vision
@@ -31,7 +31,22 @@ Run /ms:new-project to start a new project.
31
31
 
32
32
  Exit.
33
33
 
34
- If missing STATE.md: suggest `/ms:new-project`.
34
+ **If missing STATE.md but PROJECT.md or ROADMAP.md exist:**
35
+
36
+ Reconstruct STATE.md from artifacts:
37
+
38
+ 1. Read PROJECT.md → Extract "What This Is" and Core Value
39
+ 2. Read ROADMAP.md → Determine phases, find current position
40
+ 3. Scan *-SUMMARY.md files → Extract recent decisions, concerns
41
+ 4. Count pending todos in .planning/todos/pending/
42
+
43
+ Write reconstructed STATE.md, then proceed to "load" step.
44
+
45
+ ```
46
+ "STATE.md missing. Reconstructing from artifacts..."
47
+ ```
48
+
49
+ If missing both STATE.md and PROJECT.md/ROADMAP.md: suggest `/ms:new-project`.
35
50
 
36
51
  **If ROADMAP.md missing but PROJECT.md exists:**
37
52
 
@@ -354,7 +369,6 @@ Ready to plan the next milestone.
354
369
  - Phase complete but next phase not planned → offer `/ms:plan-phase [next]`
355
370
  - All work complete → offer milestone completion
356
371
  - Blockers present → highlight before offering to continue
357
- - Handoff file exists → mention it, offer `/ms:resume-work`
358
372
  </step>
359
373
 
360
374
  </process>
@@ -79,8 +79,6 @@ ERROR: Cannot remove Phase {target}
79
79
  Only future phases can be removed:
80
80
  - Current phase: {current}
81
81
  - Phase {target} is current or completed
82
-
83
- To abandon current work, use /ms:pause-work instead.
84
82
  ```
85
83
 
86
84
  Exit.
@@ -73,12 +73,6 @@ None yet.
73
73
  [Issues that affect future work]
74
74
 
75
75
  None yet.
76
-
77
- ## Session Continuity
78
-
79
- Last session: [YYYY-MM-DD HH:MM]
80
- Stopped at: [Description of last completed action]
81
- Resume file: [Path to .continue-here*.md if exists, otherwise "None"]
82
76
  ```
83
77
 
84
78
  <purpose>
@@ -172,12 +166,6 @@ Updated after each plan completion.
172
166
  - Prefix with originating phase
173
167
  - Cleared when addressed
174
168
 
175
- ### Session Continuity
176
- Enables instant resumption:
177
- - When was last session
178
- - What was last completed
179
- - Is there a .continue-here file to resume from
180
-
181
169
  </sections>
182
170
 
183
171
  <size_constraint>
@@ -219,6 +207,5 @@ The goal is "read once, know where we are" — if it's too long, that fails.
219
207
  - Current Position: Where we are now (phase, plan, status)
220
208
  - Performance Metrics: Velocity tracking
221
209
  - Accumulated Context: Recent decisions, pending todos, adhoc work, blockers
222
- - Session Continuity: Resume information
223
210
 
224
211
  </guidelines>
@@ -1455,7 +1455,6 @@ Update Session Continuity section in STATE.md to enable resumption in future ses
1455
1455
  ```markdown
1456
1456
  Last session: [current date and time]
1457
1457
  Stopped at: Completed {phase}-{plan}-PLAN.md
1458
- Resume file: [path to .continue-here if exists, else "None"]
1459
1458
  ```
1460
1459
 
1461
1460
  **Size constraint note:** Keep STATE.md under 150 lines total.
@@ -106,18 +106,6 @@ Wait for user decision.
106
106
 
107
107
  </step>
108
108
 
109
- <step name="cleanup_handoff">
110
-
111
- Check for lingering handoffs:
112
-
113
- ```bash
114
- ls .planning/phases/XX-current/.continue-here*.md 2>/dev/null
115
- ```
116
-
117
- If found, delete them — phase is complete, handoffs are stale.
118
-
119
- </step>
120
-
121
109
  <step name="update_roadmap">
122
110
 
123
111
  Update the roadmap file:
@@ -379,14 +367,12 @@ Update Session Continuity section in STATE.md to reflect transition completion.
379
367
  ```markdown
380
368
  Last session: [today]
381
369
  Stopped at: Phase [X] complete, ready to plan Phase [X+1]
382
- Resume file: None
383
370
  ```
384
371
 
385
372
  **Step complete when:**
386
373
 
387
374
  - [ ] Last session timestamp updated to current date and time
388
375
  - [ ] Stopped at describes phase completion and next phase
389
- - [ ] Resume file confirmed as None (transitions don't use resume files)
390
376
 
391
377
  </step>
392
378
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mindsystem-cc",
3
- "version": "3.0.0",
3
+ "version": "3.1.0",
4
4
  "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.",
5
5
  "bin": {
6
6
  "mindsystem-cc": "bin/install.js"
@@ -1,123 +0,0 @@
1
- ---
2
- name: ms:pause-work
3
- description: Create context handoff when pausing work mid-phase
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Bash
8
- ---
9
-
10
- <objective>
11
- Create `.continue-here.md` handoff file to preserve complete work state across sessions.
12
-
13
- Enables seamless resumption in fresh session with full context restoration.
14
- </objective>
15
-
16
- <context>
17
- @.planning/STATE.md
18
- </context>
19
-
20
- <process>
21
-
22
- <step name="detect">
23
- Find current phase directory from most recently modified files.
24
- </step>
25
-
26
- <step name="gather">
27
- **Collect complete state for handoff:**
28
-
29
- 1. **Current position**: Which phase, which plan, which task
30
- 2. **Work completed**: What got done this session
31
- 3. **Work remaining**: What's left in current plan/phase
32
- 4. **Decisions made**: Key decisions and rationale
33
- 5. **Blockers/issues**: Anything stuck
34
- 6. **Mental context**: The approach, next steps, "vibe"
35
- 7. **Files modified**: What's changed but not committed
36
-
37
- Ask user for clarifications if needed.
38
- </step>
39
-
40
- <step name="write">
41
- **Write handoff to `.planning/phases/XX-name/.continue-here.md`:**
42
-
43
- ```markdown
44
- ---
45
- phase: XX-name
46
- task: 3
47
- total_tasks: 7
48
- status: in_progress
49
- last_updated: [timestamp]
50
- ---
51
-
52
- <current_state>
53
- [Where exactly are we? Immediate context]
54
- </current_state>
55
-
56
- <completed_work>
57
-
58
- - Task 1: [name] - Done
59
- - Task 2: [name] - Done
60
- - Task 3: [name] - In progress, [what's done]
61
- </completed_work>
62
-
63
- <remaining_work>
64
-
65
- - Task 3: [what's left]
66
- - Task 4: Not started
67
- - Task 5: Not started
68
- </remaining_work>
69
-
70
- <decisions_made>
71
-
72
- - Decided to use [X] because [reason]
73
- - Chose [approach] over [alternative] because [reason]
74
- </decisions_made>
75
-
76
- <blockers>
77
- - [Blocker 1]: [status/workaround]
78
- </blockers>
79
-
80
- <context>
81
- [Mental state, what were you thinking, the plan]
82
- </context>
83
-
84
- <next_action>
85
- Start with: [specific first action when resuming]
86
- </next_action>
87
- ```
88
-
89
- Be specific enough for a fresh Claude to understand immediately.
90
- </step>
91
-
92
- <step name="commit">
93
- ```bash
94
- git add .planning/phases/*/.continue-here.md
95
- git commit -m "wip: [phase-name] paused at task [X]/[Y]"
96
- ```
97
- </step>
98
-
99
- <step name="confirm">
100
- ```
101
- ✓ Handoff created: .planning/phases/[XX-name]/.continue-here.md
102
-
103
- Current state:
104
-
105
- - Phase: [XX-name]
106
- - Task: [X] of [Y]
107
- - Status: [in_progress/blocked]
108
- - Committed as WIP
109
-
110
- To resume: /ms:resume-work
111
-
112
- ```
113
- </step>
114
-
115
- </process>
116
-
117
- <success_criteria>
118
- - [ ] .continue-here.md created in correct phase directory
119
- - [ ] All sections filled with specific content
120
- - [ ] Committed as WIP
121
- - [ ] User knows location and how to resume
122
- </success_criteria>
123
- ```
@@ -1,40 +0,0 @@
1
- ---
2
- name: ms:resume-work
3
- description: Resume work from previous session with full context restoration
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- - Write
8
- - AskUserQuestion
9
- - SlashCommand
10
- ---
11
-
12
- <objective>
13
- Restore complete project context and resume work seamlessly from previous session.
14
-
15
- Routes to the resume-project workflow which handles:
16
-
17
- - STATE.md loading (or reconstruction if missing)
18
- - Checkpoint detection (.continue-here files)
19
- - Incomplete work detection (PLAN without SUMMARY)
20
- - Status presentation
21
- - Context-aware next action routing
22
- </objective>
23
-
24
- <execution_context>
25
- @~/.claude/mindsystem/workflows/resume-project.md
26
- </execution_context>
27
-
28
- <process>
29
- **Follow the resume-project workflow** from `@~/.claude/mindsystem/workflows/resume-project.md`.
30
-
31
- The workflow handles all resumption logic including:
32
-
33
- 1. Project existence verification
34
- 2. STATE.md loading or reconstruction
35
- 3. Checkpoint and incomplete work detection
36
- 4. Visual status presentation
37
- 5. Context-aware option offering (checks CONTEXT.md before suggesting plan vs discuss)
38
- 6. Routing to appropriate next command
39
- 7. Session continuity updates
40
- </process>
@@ -1,78 +0,0 @@
1
- # Continue-Here Template
2
-
3
- Copy and fill this structure for `.planning/phases/XX-name/.continue-here.md`:
4
-
5
- ```yaml
6
- ---
7
- phase: XX-name
8
- task: 3
9
- total_tasks: 7
10
- status: in_progress
11
- last_updated: 2025-01-15T14:30:00Z
12
- ---
13
- ```
14
-
15
- ```markdown
16
- <current_state>
17
- [Where exactly are we? What's the immediate context?]
18
- </current_state>
19
-
20
- <completed_work>
21
- [What got done this session - be specific]
22
-
23
- - Task 1: [name] - Done
24
- - Task 2: [name] - Done
25
- - Task 3: [name] - In progress, [what's done on it]
26
- </completed_work>
27
-
28
- <remaining_work>
29
- [What's left in this phase]
30
-
31
- - Task 3: [name] - [what's left to do]
32
- - Task 4: [name] - Not started
33
- - Task 5: [name] - Not started
34
- </remaining_work>
35
-
36
- <decisions_made>
37
- [Key decisions and why - so next session doesn't re-debate]
38
-
39
- - Decided to use [X] because [reason]
40
- - Chose [approach] over [alternative] because [reason]
41
- </decisions_made>
42
-
43
- <blockers>
44
- [Anything stuck or waiting on external factors]
45
-
46
- - [Blocker 1]: [status/workaround]
47
- </blockers>
48
-
49
- <context>
50
- [Mental state, "vibe", anything that helps resume smoothly]
51
-
52
- [What were you thinking about? What was the plan?
53
- This is the "pick up exactly where you left off" context.]
54
- </context>
55
-
56
- <next_action>
57
- [The very first thing to do when resuming]
58
-
59
- Start with: [specific action]
60
- </next_action>
61
- ```
62
-
63
- <yaml_fields>
64
- Required YAML frontmatter:
65
-
66
- - `phase`: Directory name (e.g., `02-authentication`)
67
- - `task`: Current task number
68
- - `total_tasks`: How many tasks in phase
69
- - `status`: `in_progress`, `blocked`, `almost_done`
70
- - `last_updated`: ISO timestamp
71
- </yaml_fields>
72
-
73
- <guidelines>
74
- - Be specific enough that a fresh Claude instance understands immediately
75
- - Include WHY decisions were made, not just what
76
- - The `<next_action>` should be actionable without reading anything else
77
- - This file gets DELETED after resume - it's not permanent storage
78
- </guidelines>