mindsystem-cc 3.17.0 → 3.18.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/agents/ms-debugger.md +3 -3
- package/agents/ms-researcher.md +13 -13
- package/agents/ms-roadmapper.md +22 -22
- package/commands/ms/audit-milestone.md +1 -3
- package/commands/ms/complete-milestone.md +47 -54
- package/commands/ms/new-milestone.md +2 -4
- package/commands/ms/plan-milestone-gaps.md +1 -3
- package/commands/ms/research-project.md +3 -3
- package/mindsystem/references/continuation-format.md +17 -12
- package/mindsystem/references/routing/audit-result-routing.md +4 -13
- package/mindsystem/references/routing/between-milestones-routing.md +1 -3
- package/mindsystem/references/routing/gap-closure-routing.md +1 -3
- package/mindsystem/references/routing/milestone-complete-routing.md +1 -3
- package/mindsystem/references/routing/next-phase-routing.md +1 -1
- package/mindsystem/templates/milestone-archive.md +3 -3
- package/mindsystem/templates/research-subagent-prompt.md +2 -2
- package/mindsystem/templates/research.md +7 -7
- package/mindsystem/templates/roadmap.md +7 -7
- package/mindsystem/workflows/complete-milestone.md +53 -230
- package/mindsystem/workflows/define-requirements.md +1 -3
- package/mindsystem/workflows/diagnose-issues.md +1 -3
- package/mindsystem/workflows/execute-phase.md +1 -3
- package/mindsystem/workflows/map-codebase.md +1 -3
- package/mindsystem/workflows/plan-phase.md +1 -3
- package/package.json +1 -1
- package/scripts/archive-milestone-files.sh +68 -0
- package/scripts/archive-milestone-phases.sh +138 -0
- package/scripts/gather-milestone-stats.sh +179 -0
- package/scripts/ms-lookup/ms_lookup/backends/context7.py +17 -5
- package/scripts/ms-lookup/ms_lookup/backends/perplexity.py +17 -3
- package/scripts/ms-lookup-wrapper.sh +1 -1
- package/scripts/validate-execution-order.sh +4 -5
- package/scripts/cleanup-phase-artifacts.sh +0 -68
package/agents/ms-debugger.md
CHANGED
|
@@ -615,7 +615,7 @@ The cost of insufficient verification: bug returns, user frustration, emergency
|
|
|
615
615
|
**2. Library/framework behavior doesn't match expectations**
|
|
616
616
|
- Using library correctly but it's not working
|
|
617
617
|
- Documentation contradicts behavior
|
|
618
|
-
- **Action:** Check official docs (
|
|
618
|
+
- **Action:** Check official docs (`ms-lookup docs`), GitHub issues
|
|
619
619
|
|
|
620
620
|
**3. Domain knowledge gaps**
|
|
621
621
|
- Debugging auth: need to understand OAuth flow
|
|
@@ -657,7 +657,7 @@ The cost of insufficient verification: bug returns, user frustration, emergency
|
|
|
657
657
|
- Include version: `"react 18 useEffect behavior"`
|
|
658
658
|
- Add "github issue" for known bugs
|
|
659
659
|
|
|
660
|
-
|
|
660
|
+
**`ms-lookup docs`:**
|
|
661
661
|
- For API reference, library concepts, function signatures
|
|
662
662
|
|
|
663
663
|
**GitHub Issues:**
|
|
@@ -687,7 +687,7 @@ Is this an error message I don't recognize?
|
|
|
687
687
|
└─ NO ↓
|
|
688
688
|
|
|
689
689
|
Is this library/framework behavior I don't understand?
|
|
690
|
-
├─ YES → Check docs (
|
|
690
|
+
├─ YES → Check docs (`ms-lookup docs` or official docs)
|
|
691
691
|
└─ NO ↓
|
|
692
692
|
|
|
693
693
|
Is this code I/my team wrote?
|
package/agents/ms-researcher.md
CHANGED
|
@@ -59,9 +59,9 @@ Claude's training data is 6-18 months stale. Treat pre-existing knowledge as hyp
|
|
|
59
59
|
- Wrong (Claude misremembered or hallucinated)
|
|
60
60
|
|
|
61
61
|
**The discipline:**
|
|
62
|
-
1. **Verify before asserting** - Don't state library capabilities without checking
|
|
62
|
+
1. **Verify before asserting** - Don't state library capabilities without checking `ms-lookup docs` or official docs
|
|
63
63
|
2. **Date your knowledge** - "As of my training" is a warning flag, not a confidence marker
|
|
64
|
-
3. **Prefer current sources** -
|
|
64
|
+
3. **Prefer current sources** - `ms-lookup docs` and official docs trump training data
|
|
65
65
|
4. **Flag uncertainty** - LOW confidence when only training data supports a claim
|
|
66
66
|
|
|
67
67
|
## Honest Reporting
|
|
@@ -197,7 +197,7 @@ When researching "best library for X":
|
|
|
197
197
|
|
|
198
198
|
The CLI is at `~/.claude/mindsystem/scripts/ms-lookup-wrapper.sh`.
|
|
199
199
|
|
|
200
|
-
### Library Documentation
|
|
200
|
+
### Library Documentation
|
|
201
201
|
|
|
202
202
|
```bash
|
|
203
203
|
~/.claude/mindsystem/scripts/ms-lookup-wrapper.sh docs <library> "<query>"
|
|
@@ -213,7 +213,7 @@ Example:
|
|
|
213
213
|
|
|
214
214
|
**Response format:** JSON with results array containing title, content, source_url, tokens.
|
|
215
215
|
|
|
216
|
-
### Deep Research
|
|
216
|
+
### Deep Research
|
|
217
217
|
|
|
218
218
|
```bash
|
|
219
219
|
~/.claude/mindsystem/scripts/ms-lookup-wrapper.sh deep "<query>"
|
|
@@ -255,7 +255,7 @@ WebSearch("[technology] vs [alternative] {current_year}")
|
|
|
255
255
|
|
|
256
256
|
**Always include current year** in queries for freshness.
|
|
257
257
|
|
|
258
|
-
**Why WebSearch over
|
|
258
|
+
**Why WebSearch over `ms-lookup deep`:** WebSearch is free. `ms-lookup deep` costs money per query — reserve it for high-value questions, not discovery.
|
|
259
259
|
|
|
260
260
|
## Token Limit Strategy (for ms-lookup)
|
|
261
261
|
|
|
@@ -264,7 +264,7 @@ WebSearch("[technology] vs [alternative] {current_year}")
|
|
|
264
264
|
**Rationale:**
|
|
265
265
|
- The 50% rule: Research must complete before hitting 100k tokens
|
|
266
266
|
- At 2000 tokens/query, you can make ~50 queries
|
|
267
|
-
-
|
|
267
|
+
- `ms-lookup docs` returns results ranked by relevance — first 3-4 snippets are most important
|
|
268
268
|
- Query flexibility > per-query comprehensiveness
|
|
269
269
|
|
|
270
270
|
**When to increase (`--max-tokens 4000-6000`):**
|
|
@@ -296,15 +296,15 @@ WebSearch("[technology] vs [alternative] {current_year}")
|
|
|
296
296
|
|
|
297
297
|
| Level | Sources | Use |
|
|
298
298
|
|-------|---------|-----|
|
|
299
|
-
| HIGH |
|
|
299
|
+
| HIGH | `ms-lookup docs`, official documentation, official releases | State as fact |
|
|
300
300
|
| MEDIUM | WebSearch verified with official source, multiple credible sources agree | State with attribution |
|
|
301
301
|
| LOW | WebSearch only, single source, unverified | Flag as needing validation |
|
|
302
302
|
|
|
303
303
|
## Source Prioritization
|
|
304
304
|
|
|
305
|
-
**1.
|
|
306
|
-
- Current, authoritative documentation
|
|
307
|
-
-
|
|
305
|
+
**1. `ms-lookup docs` (highest priority)**
|
|
306
|
+
- Current, authoritative library documentation
|
|
307
|
+
- Version-aware, sourced from official docs
|
|
308
308
|
- Trust completely for API/feature questions
|
|
309
309
|
|
|
310
310
|
**2. Official Documentation**
|
|
@@ -526,7 +526,7 @@ Based on research question, identify what needs investigating:
|
|
|
526
526
|
|
|
527
527
|
For each domain, follow tool strategy in order:
|
|
528
528
|
|
|
529
|
-
1.
|
|
529
|
+
1. **`ms-lookup docs` First** - Query library documentation
|
|
530
530
|
2. **Official Docs** - WebFetch for gaps
|
|
531
531
|
3. **WebSearch** - Ecosystem discovery with year
|
|
532
532
|
4. **Verification** - Cross-reference all findings
|
|
@@ -626,7 +626,7 @@ When research cannot proceed:
|
|
|
626
626
|
Research is complete when:
|
|
627
627
|
|
|
628
628
|
- [ ] Research question answered with actionable findings
|
|
629
|
-
- [ ] Source hierarchy followed (
|
|
629
|
+
- [ ] Source hierarchy followed (`ms-lookup docs` → Official → WebSearch)
|
|
630
630
|
- [ ] All findings have confidence levels
|
|
631
631
|
- [ ] Verification protocol checklist passed
|
|
632
632
|
- [ ] Output file(s) created in correct format
|
|
@@ -636,7 +636,7 @@ Research is complete when:
|
|
|
636
636
|
Research quality indicators:
|
|
637
637
|
|
|
638
638
|
- **Specific, not vague:** "Three.js r160 with @react-three/fiber 8.15" not "use Three.js"
|
|
639
|
-
- **Verified, not assumed:** Findings cite
|
|
639
|
+
- **Verified, not assumed:** Findings cite `ms-lookup docs` or official docs
|
|
640
640
|
- **Honest about gaps:** LOW confidence items flagged, unknowns admitted
|
|
641
641
|
- **Actionable:** Developer could start work based on this research
|
|
642
642
|
- **Current:** Year included in searches, publication dates checked
|
package/agents/ms-roadmapper.md
CHANGED
|
@@ -214,25 +214,12 @@ For each phase, analyze whether pre-work would reduce risk before planning. Thre
|
|
|
214
214
|
|
|
215
215
|
| Pre-Work | Question It Answers | Command |
|
|
216
216
|
|----------|---------------------|---------|
|
|
217
|
-
| **Research** | "Do I know HOW to build this?" | `/ms:research-phase` |
|
|
218
217
|
| **Discussion** | "Do I understand WHAT the user wants?" | `/ms:discuss-phase` |
|
|
219
218
|
| **Design** | "Do I know what this should LOOK like?" | `/ms:design-phase` |
|
|
219
|
+
| **Research** | "Do I know HOW to build this?" | `/ms:research-phase` |
|
|
220
220
|
|
|
221
221
|
All use binary Likely/Unlikely with parenthetical reason. These are hints to users, not mandates.
|
|
222
222
|
|
|
223
|
-
### Research Indicators
|
|
224
|
-
|
|
225
|
-
**Likely when ANY of:**
|
|
226
|
-
- External APIs or services involved
|
|
227
|
-
- New libraries/frameworks to learn
|
|
228
|
-
- Architectural decisions not yet made
|
|
229
|
-
- Technical approach unclear
|
|
230
|
-
|
|
231
|
-
**Unlikely when ALL of:**
|
|
232
|
-
- Using established internal patterns
|
|
233
|
-
- CRUD operations with known stack
|
|
234
|
-
- Well-documented conventions exist
|
|
235
|
-
|
|
236
223
|
### Discussion Indicators
|
|
237
224
|
|
|
238
225
|
**Problem it solves:** User's mental model isn't documented. Planning happens without understanding what's essential vs nice-to-have.
|
|
@@ -266,6 +253,19 @@ All use binary Likely/Unlikely with parenthetical reason. These are hints to use
|
|
|
266
253
|
- Infrastructure, testing, deployment phases
|
|
267
254
|
- Uses established UI patterns exclusively
|
|
268
255
|
|
|
256
|
+
### Research Indicators
|
|
257
|
+
|
|
258
|
+
**Likely when ANY of:**
|
|
259
|
+
- External APIs or services involved
|
|
260
|
+
- New libraries/frameworks to learn
|
|
261
|
+
- Architectural decisions not yet made
|
|
262
|
+
- Technical approach unclear
|
|
263
|
+
|
|
264
|
+
**Unlikely when ALL of:**
|
|
265
|
+
- Using established internal patterns
|
|
266
|
+
- CRUD operations with known stack
|
|
267
|
+
- Well-documented conventions exist
|
|
268
|
+
|
|
269
269
|
**Note:** Discussion and Design often overlap for UI-facing phases. This is intentional — they serve different purposes (vision vs specification) and a phase may benefit from both.
|
|
270
270
|
|
|
271
271
|
### Output Format
|
|
@@ -273,12 +273,12 @@ All use binary Likely/Unlikely with parenthetical reason. These are hints to use
|
|
|
273
273
|
For each phase in ROADMAP.md:
|
|
274
274
|
|
|
275
275
|
```markdown
|
|
276
|
-
**Research**: Likely (external API) | Unlikely (established patterns)
|
|
277
|
-
**Research topics**: [What needs investigating] (only if Likely)
|
|
278
276
|
**Discuss**: Likely (ambiguous user flow) | Unlikely (clear requirements)
|
|
279
277
|
**Discuss topics**: [What to clarify] (only if Likely)
|
|
280
278
|
**Design**: Likely (significant new UI) | Unlikely (backend only)
|
|
281
279
|
**Design focus**: [What to design] (only if Likely)
|
|
280
|
+
**Research**: Likely (external API) | Unlikely (established patterns)
|
|
281
|
+
**Research topics**: [What needs investigating] (only if Likely)
|
|
282
282
|
```
|
|
283
283
|
|
|
284
284
|
</pre_work_analysis>
|
|
@@ -461,11 +461,11 @@ When presenting to user for approval:
|
|
|
461
461
|
|
|
462
462
|
### Pre-Work Recommendations
|
|
463
463
|
|
|
464
|
-
| Phase |
|
|
465
|
-
|
|
464
|
+
| Phase | Discuss | Design | Research |
|
|
465
|
+
|-------|---------|--------|----------|
|
|
466
466
|
| 1 - Setup | Unlikely | Unlikely | Unlikely |
|
|
467
|
-
| 2 - Auth | Likely |
|
|
468
|
-
| 3 - Content |
|
|
467
|
+
| 2 - Auth | Likely | Unlikely | Likely |
|
|
468
|
+
| 3 - Content | Likely | Likely | Unlikely |
|
|
469
469
|
|
|
470
470
|
**Phase 2 topics:**
|
|
471
471
|
- Research: [external auth providers]
|
|
@@ -601,8 +601,8 @@ When files are written and returning to orchestrator:
|
|
|
601
601
|
|
|
602
602
|
### Pre-Work Recommendations
|
|
603
603
|
|
|
604
|
-
| Phase |
|
|
605
|
-
|
|
604
|
+
| Phase | Discuss | Design | Research |
|
|
605
|
+
|-------|---------|--------|----------|
|
|
606
606
|
| 1 - {name} | {Likely/Unlikely} | {Likely/Unlikely} | {Likely/Unlikely} |
|
|
607
607
|
| 2 - {name} | {Likely/Unlikely} | {Likely/Unlikely} | {Likely/Unlikely} |
|
|
608
608
|
|
|
@@ -62,96 +62,89 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
|
|
62
62
|
✓ Milestone audit passed. Proceeding with completion.
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
1. **Verify readiness:**
|
|
66
|
-
|
|
67
|
-
- Check all phases in milestone have completed plans (SUMMARY.md exists)
|
|
68
|
-
- Present milestone scope and stats
|
|
69
|
-
- Wait for confirmation
|
|
70
|
-
|
|
71
|
-
1.5. **Clean up raw artifacts:**
|
|
72
|
-
|
|
73
|
-
Delete remaining raw artifacts from phase directories. Knowledge files are already current from phase-level consolidation in execute-phase.
|
|
65
|
+
1. **Verify readiness and gather stats:**
|
|
74
66
|
|
|
75
67
|
```bash
|
|
76
|
-
~/.claude/mindsystem/scripts/
|
|
68
|
+
~/.claude/mindsystem/scripts/gather-milestone-stats.sh $PHASE_START $PHASE_END
|
|
77
69
|
```
|
|
78
70
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
- Count phases, plans, tasks
|
|
82
|
-
- Calculate git range, file changes, LOC
|
|
83
|
-
- Extract timeline from git log
|
|
84
|
-
- Present summary, confirm
|
|
71
|
+
- If NOT READY: stop and report incomplete plans
|
|
72
|
+
- If READY: present readiness + stats summary, proceed
|
|
85
73
|
|
|
86
|
-
|
|
74
|
+
2. **Extract accomplishments:**
|
|
87
75
|
|
|
88
76
|
- Read all phase SUMMARY.md files in milestone range
|
|
89
77
|
- Extract 4-6 key accomplishments
|
|
90
|
-
- Present for approval
|
|
91
78
|
|
|
92
|
-
|
|
79
|
+
3. **Create MILESTONES.md entry:**
|
|
80
|
+
|
|
81
|
+
- Create or update `.planning/MILESTONES.md` using `templates/milestone.md`
|
|
82
|
+
- Prepend new entry (reverse chronological order)
|
|
83
|
+
|
|
84
|
+
4. **Update PROJECT.md:**
|
|
85
|
+
|
|
86
|
+
- Full evolution review (What This Is, Core Value, Requirements audit, Key Decisions, Context)
|
|
87
|
+
- Move all shipped requirements to Validated
|
|
88
|
+
- Update "Last updated" footer
|
|
89
|
+
|
|
90
|
+
5. **Archive milestone:**
|
|
93
91
|
|
|
94
92
|
- Create `.planning/milestones/v{{version}}/` directory
|
|
95
|
-
- Create `.planning/milestones/v{{version}}/ROADMAP.md`
|
|
96
|
-
-
|
|
97
|
-
- Fill milestone-archive.md template
|
|
98
|
-
- Update ROADMAP.md to one-line summary with link
|
|
93
|
+
- Create `.planning/milestones/v{{version}}/ROADMAP.md` from template
|
|
94
|
+
- Delete ROADMAP.md
|
|
99
95
|
|
|
100
|
-
|
|
96
|
+
6. **Archive requirements:**
|
|
101
97
|
|
|
102
98
|
- Create `.planning/milestones/v{{version}}/REQUIREMENTS.md`
|
|
103
|
-
- Mark all
|
|
104
|
-
-
|
|
105
|
-
|
|
99
|
+
- Mark all requirements as complete with outcomes
|
|
100
|
+
- Delete `.planning/REQUIREMENTS.md`
|
|
101
|
+
|
|
102
|
+
7. **Archive milestone files:**
|
|
106
103
|
|
|
107
|
-
|
|
104
|
+
```bash
|
|
105
|
+
~/.claude/mindsystem/scripts/archive-milestone-files.sh v{{version}}
|
|
106
|
+
```
|
|
108
107
|
|
|
109
|
-
|
|
110
|
-
|
|
108
|
+
8. **Archive and cleanup phases:**
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
~/.claude/mindsystem/scripts/archive-milestone-phases.sh $PHASE_START $PHASE_END v{{version}}
|
|
112
|
+
```
|
|
111
113
|
|
|
112
|
-
|
|
114
|
+
9. **Update STATE.md:**
|
|
113
115
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
- Archive previous content in `<details>` (if v1.1+)
|
|
116
|
+
- Update project reference with current core value and next focus
|
|
117
|
+
- Reset current position for next milestone
|
|
117
118
|
|
|
118
|
-
|
|
119
|
+
10. **Commit and tag:**
|
|
119
120
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
121
|
+
- Stage: MILESTONES.md, PROJECT.md, STATE.md, archive files, deletions
|
|
122
|
+
- Commit: `chore: archive v{{version}} milestone`
|
|
123
|
+
- Tag: `git tag -a v{{version}} -m "[milestone summary]"`
|
|
124
|
+
- Ask about pushing tag
|
|
124
125
|
|
|
125
|
-
|
|
126
|
-
|
|
126
|
+
11. **Offer next steps:**
|
|
127
|
+
- `/ms:new-milestone` — discover goals and update PROJECT.md
|
|
127
128
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
- Format: `Last Command: ms:complete-milestone $ARGUMENTS | YYYY-MM-DD HH:MM`
|
|
129
|
+
12. **Update last command:**
|
|
130
|
+
- Format: `Last Command: ms:complete-milestone $ARGUMENTS | YYYY-MM-DD HH:MM`
|
|
131
131
|
|
|
132
132
|
</process>
|
|
133
133
|
|
|
134
134
|
<success_criteria>
|
|
135
135
|
|
|
136
|
-
-
|
|
136
|
+
- PROJECT.md full evolution review completed (What This Is, Core Value, Requirements, Key Decisions, Context)
|
|
137
|
+
- All shipped requirements moved to Validated in PROJECT.md
|
|
138
|
+
- Key Decisions updated with outcomes
|
|
137
139
|
- Milestone archived to `.planning/milestones/v{{version}}/ROADMAP.md`
|
|
138
140
|
- Requirements archived to `.planning/milestones/v{{version}}/REQUIREMENTS.md`
|
|
139
|
-
- Research archived to `.planning/milestones/v{{version}}/research/` (if existed)
|
|
140
141
|
- `.planning/REQUIREMENTS.md` deleted (fresh for next milestone)
|
|
141
|
-
- ROADMAP.md collapsed to one-line entry
|
|
142
|
-
- PROJECT.md updated with current state
|
|
143
142
|
- Git tag v{{version}} created
|
|
144
|
-
- Commit successful
|
|
145
|
-
- User knows next steps (/ms:new-milestone)
|
|
146
143
|
</success_criteria>
|
|
147
144
|
|
|
148
145
|
<critical_rules>
|
|
149
146
|
|
|
150
|
-
- **Load workflow first:** Read complete-milestone.md before executing
|
|
151
147
|
- **Verify completion:** All phases must have SUMMARY.md files
|
|
152
|
-
- **User confirmation:** Wait for approval at verification gates
|
|
153
148
|
- **Archive before deleting:** Always create archive files (ROADMAP, REQUIREMENTS) before updating/deleting originals
|
|
154
149
|
- **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
|
|
155
|
-
- **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
|
|
156
|
-
- **Fresh requirements:** Next milestone starts with `/ms:create-roadmap`, not reusing old file
|
|
157
150
|
</critical_rules>
|
|
@@ -266,15 +266,13 @@ Milestone name: $ARGUMENTS (optional — will emerge during discovery if not pro
|
|
|
266
266
|
|
|
267
267
|
## ▶ Next Up
|
|
268
268
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
`/ms:[recommended-command]`
|
|
269
|
+
`/ms:[recommended-command]` — [one-line reason from conversation]
|
|
272
270
|
|
|
273
271
|
<sub>`/clear` first → fresh context window</sub>
|
|
274
272
|
|
|
275
273
|
---
|
|
276
274
|
|
|
277
|
-
**Also available:** `/ms:[alternative-command]`
|
|
275
|
+
**Also available:** `/ms:[alternative-command]` — [brief reason]
|
|
278
276
|
|
|
279
277
|
---
|
|
280
278
|
```
|
|
@@ -176,9 +176,7 @@ git commit -m "docs(roadmap): add gap closure phases {N}-{M}"
|
|
|
176
176
|
|
|
177
177
|
## ▶ Next Up
|
|
178
178
|
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
`/ms:plan-phase {N}`
|
|
179
|
+
`/ms:plan-phase {N}` — plan first gap closure phase
|
|
182
180
|
|
|
183
181
|
<sub>`/clear` first → fresh context window</sub>
|
|
184
182
|
|
|
@@ -335,9 +335,9 @@ Key findings:
|
|
|
335
335
|
- Critical pitfall: [one-liner]
|
|
336
336
|
|
|
337
337
|
---
|
|
338
|
-
##
|
|
339
|
-
|
|
340
|
-
<sub>`/clear` first</sub>
|
|
338
|
+
## ▶ Next Up
|
|
339
|
+
`/ms:create-roadmap` — define requirements and create roadmap
|
|
340
|
+
<sub>`/clear` first → fresh context window</sub>
|
|
341
341
|
---
|
|
342
342
|
```
|
|
343
343
|
|
|
@@ -9,9 +9,7 @@ Standard format for presenting next steps after completing a command or workflow
|
|
|
9
9
|
|
|
10
10
|
## ▶ Next Up
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
`{command to copy-paste}`
|
|
12
|
+
`{command to copy-paste}` — {one-line description}
|
|
15
13
|
|
|
16
14
|
<sub>`/clear` first → fresh context window</sub>
|
|
17
15
|
|
|
@@ -24,14 +22,23 @@ Standard format for presenting next steps after completing a command or workflow
|
|
|
24
22
|
---
|
|
25
23
|
```
|
|
26
24
|
|
|
25
|
+
When there's meaningful additional context (like a phase identifier), add it as a header line:
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
**Phase {N}: {Name}** — {Goal}
|
|
29
|
+
|
|
30
|
+
`/ms:plan-phase {N}`
|
|
31
|
+
```
|
|
32
|
+
|
|
27
33
|
## Format Rules
|
|
28
34
|
|
|
29
|
-
1. **
|
|
30
|
-
2. **
|
|
31
|
-
3. **
|
|
32
|
-
4.
|
|
33
|
-
5. **
|
|
34
|
-
6. **
|
|
35
|
+
1. **Command is the anchor** — backtick command + description on one line, no separate bold label restating the command name
|
|
36
|
+
2. **Phase identifiers are additive context** — `**Phase 2: Auth**` carries info the command doesn't; bold labels like `**Plan gap closure**` just restate `/ms:plan-phase --gaps` and should be omitted
|
|
37
|
+
3. **Pull context from source** — ROADMAP.md for phases, PLAN.md `<objective>` for plans
|
|
38
|
+
4. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
|
|
39
|
+
5. **`/clear` explanation** — always include, keeps it concise but explains why
|
|
40
|
+
6. **"Also available" not "Other options"** — sounds more app-like
|
|
41
|
+
7. **Visual separators** — `---` above and below to make it stand out
|
|
35
42
|
|
|
36
43
|
## Variants
|
|
37
44
|
|
|
@@ -167,9 +174,7 @@ All 4 phases shipped
|
|
|
167
174
|
|
|
168
175
|
## ▶ Next Up
|
|
169
176
|
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
`/ms:new-milestone`
|
|
177
|
+
`/ms:new-milestone` — discover what to build next
|
|
173
178
|
|
|
174
179
|
<sub>`/clear` first → fresh context window</sub>
|
|
175
180
|
|
|
@@ -38,9 +38,7 @@ See full list in MILESTONE-AUDIT.md. Consider addressing in next milestone.
|
|
|
38
38
|
|
|
39
39
|
## ▶ Next Up
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
`/ms:complete-milestone {version}`
|
|
41
|
+
`/ms:complete-milestone {version}` — archive and tag
|
|
44
42
|
|
|
45
43
|
<sub>`/clear` first → fresh context window</sub>
|
|
46
44
|
```
|
|
@@ -73,9 +71,7 @@ See full list in MILESTONE-AUDIT.md. Consider addressing in next milestone.
|
|
|
73
71
|
|
|
74
72
|
## ▶ Next Up
|
|
75
73
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
`/ms:plan-milestone-gaps`
|
|
74
|
+
`/ms:plan-milestone-gaps` — create phases to complete milestone
|
|
79
75
|
|
|
80
76
|
<sub>`/clear` first → fresh context window</sub>
|
|
81
77
|
|
|
@@ -112,13 +108,8 @@ See full list in MILESTONE-AUDIT.md. Consider addressing in next milestone.
|
|
|
112
108
|
|
|
113
109
|
## ▶ Options
|
|
114
110
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
`/ms:complete-milestone {version}`
|
|
118
|
-
|
|
119
|
-
**B. Plan cleanup phase** — address debt before completing
|
|
120
|
-
|
|
121
|
-
`/ms:plan-milestone-gaps`
|
|
111
|
+
- `/ms:complete-milestone {version}` — accept debt, track in backlog
|
|
112
|
+
- `/ms:plan-milestone-gaps` — address debt before completing
|
|
122
113
|
|
|
123
114
|
<sub>`/clear` first → fresh context window</sub>
|
|
124
115
|
```
|
|
@@ -28,9 +28,7 @@ Ready to plan the next milestone.
|
|
|
28
28
|
|
|
29
29
|
## ▶ Next Up
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
`/ms:new-milestone`
|
|
31
|
+
`/ms:new-milestone` — discover what to build, update PROJECT.md
|
|
34
32
|
|
|
35
33
|
<sub>`/clear` first → fresh context window</sub>
|
|
36
34
|
|
|
@@ -46,9 +46,7 @@ Extract:
|
|
|
46
46
|
|
|
47
47
|
## ▶ Next Up
|
|
48
48
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
`/ms:plan-phase {Z} --gaps`
|
|
49
|
+
`/ms:plan-phase {Z} --gaps` — create additional plans to complete the phase
|
|
52
50
|
|
|
53
51
|
<sub>`/clear` first → fresh context window</sub>
|
|
54
52
|
|
|
@@ -23,9 +23,7 @@ All {N} phases finished!
|
|
|
23
23
|
|
|
24
24
|
## ▶ Next Up
|
|
25
25
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
`/ms:audit-milestone`
|
|
26
|
+
`/ms:audit-milestone` — verify requirements, cross-phase integration, E2E flows
|
|
29
27
|
|
|
30
28
|
<sub>`/clear` first → fresh context window</sub>
|
|
31
29
|
|
|
@@ -66,9 +66,9 @@ ELSE:
|
|
|
66
66
|
|
|
67
67
|
| Pre-work | Status | Topics/Focus |
|
|
68
68
|
|----------|--------|--------------|
|
|
69
|
-
| Research | Likely | {research topics} |
|
|
70
69
|
| Discuss | Likely | {discuss topics} |
|
|
71
70
|
| Design | Likely | {design focus} |
|
|
71
|
+
| Research | Likely | {research topics} |
|
|
72
72
|
|
|
73
73
|
{If all Unlikely: "No pre-work flagged — ready to plan directly."}
|
|
74
74
|
|
|
@@ -89,7 +89,7 @@ Plans:
|
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
92
|
-
_For current project status, see .planning/
|
|
92
|
+
_For current project status, see .planning/PROJECT.md_
|
|
93
93
|
|
|
94
94
|
---
|
|
95
95
|
|
|
@@ -117,7 +117,7 @@ _For current project status, see .planning/ROADMAP.md_
|
|
|
117
117
|
|
|
118
118
|
**After archiving:**
|
|
119
119
|
|
|
120
|
-
-
|
|
121
|
-
- Update PROJECT.md
|
|
120
|
+
- Delete ROADMAP.md (fresh one created for next milestone via `/ms:create-roadmap`)
|
|
121
|
+
- Update PROJECT.md with full evolution review
|
|
122
122
|
- Continue phase numbering in next milestone (never restart at 01)
|
|
123
123
|
</guidelines>
|
|
@@ -22,7 +22,7 @@ Templates for the 3 parallel agents spawned by `/ms:research-phase`. The orchest
|
|
|
22
22
|
## Template 1: External Docs (ms-researcher)
|
|
23
23
|
|
|
24
24
|
**Focus:** Library documentation, APIs, verified code examples
|
|
25
|
-
**Tools emphasized:** ms-lookup docs
|
|
25
|
+
**Tools emphasized:** ms-lookup docs, ms-lookup deep, WebSearch, WebFetch
|
|
26
26
|
**Returns:** Structured findings (not files)
|
|
27
27
|
|
|
28
28
|
```markdown
|
|
@@ -118,7 +118,7 @@ The agent's built-in `<what_to_scan>` section handles the systematic scan checkl
|
|
|
118
118
|
## Template 3: Best Practices (ms-researcher)
|
|
119
119
|
|
|
120
120
|
**Focus:** Community consensus, pitfalls, SOTA
|
|
121
|
-
**Tools emphasized:** ms-lookup deep
|
|
121
|
+
**Tools emphasized:** ms-lookup deep, WebSearch
|
|
122
122
|
**Returns:** Structured findings (not files)
|
|
123
123
|
|
|
124
124
|
```markdown
|
|
@@ -72,7 +72,7 @@ src/
|
|
|
72
72
|
**When to use:** [conditions]
|
|
73
73
|
**Example:**
|
|
74
74
|
```typescript
|
|
75
|
-
// [code example from
|
|
75
|
+
// [code example from official docs]
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
### Pattern 2: [Pattern Name]
|
|
@@ -131,19 +131,19 @@ Verified patterns from official sources:
|
|
|
131
131
|
|
|
132
132
|
### [Common Operation 1]
|
|
133
133
|
```typescript
|
|
134
|
-
// Source: [
|
|
134
|
+
// Source: [official docs URL]
|
|
135
135
|
[code]
|
|
136
136
|
```
|
|
137
137
|
|
|
138
138
|
### [Common Operation 2]
|
|
139
139
|
```typescript
|
|
140
|
-
// Source: [
|
|
140
|
+
// Source: [official docs URL]
|
|
141
141
|
[code]
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
### [Common Operation 3]
|
|
145
145
|
```typescript
|
|
146
|
-
// Source: [
|
|
146
|
+
// Source: [official docs URL]
|
|
147
147
|
[code]
|
|
148
148
|
```
|
|
149
149
|
</code_examples>
|
|
@@ -185,7 +185,7 @@ Things that couldn't be fully resolved:
|
|
|
185
185
|
## Sources
|
|
186
186
|
|
|
187
187
|
### Primary (HIGH confidence)
|
|
188
|
-
- [
|
|
188
|
+
- [ms-lookup docs library] - [topics fetched]
|
|
189
189
|
- [Official docs URL] - [what was checked]
|
|
190
190
|
|
|
191
191
|
### Secondary (MEDIUM confidence)
|
|
@@ -479,10 +479,10 @@ function useVehicleControls(rigidBodyRef) {
|
|
|
479
479
|
- Pitfalls: Performance, physics, feel
|
|
480
480
|
|
|
481
481
|
**Confidence breakdown:**
|
|
482
|
-
- Standard stack: HIGH - verified with
|
|
482
|
+
- Standard stack: HIGH - verified with ms-lookup docs, widely used
|
|
483
483
|
- Architecture: HIGH - from official examples
|
|
484
484
|
- Pitfalls: HIGH - documented in discourse, verified in docs
|
|
485
|
-
- Code examples: HIGH - from
|
|
485
|
+
- Code examples: HIGH - from ms-lookup docs/official sources
|
|
486
486
|
|
|
487
487
|
**Research date:** 2026-01-20
|
|
488
488
|
**Valid until:** 2026-02-20 (30 days - R3F ecosystem stable)
|