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.
- package/README.md +179 -332
- package/agents/ms-executor.md +0 -1
- package/agents/ms-roadmapper.md +0 -1
- package/commands/ms/help.md +0 -30
- package/commands/ms/progress.md +16 -2
- package/commands/ms/remove-phase.md +0 -2
- package/mindsystem/templates/state.md +0 -13
- package/mindsystem/workflows/execute-plan.md +0 -1
- package/mindsystem/workflows/transition.md +0 -14
- package/package.json +1 -1
- package/commands/ms/pause-work.md +0 -123
- package/commands/ms/resume-work.md +0 -40
- package/mindsystem/templates/continue-here.md +0 -78
- package/mindsystem/workflows/resume-project.md +0 -311
package/agents/ms-executor.md
CHANGED
package/agents/ms-roadmapper.md
CHANGED
package/commands/ms/help.md
CHANGED
|
@@ -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
|
package/commands/ms/progress.md
CHANGED
|
@@ -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
|
|
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>
|
|
@@ -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,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>
|