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.
Files changed (33) hide show
  1. package/agents/ms-debugger.md +3 -3
  2. package/agents/ms-researcher.md +13 -13
  3. package/agents/ms-roadmapper.md +22 -22
  4. package/commands/ms/audit-milestone.md +1 -3
  5. package/commands/ms/complete-milestone.md +47 -54
  6. package/commands/ms/new-milestone.md +2 -4
  7. package/commands/ms/plan-milestone-gaps.md +1 -3
  8. package/commands/ms/research-project.md +3 -3
  9. package/mindsystem/references/continuation-format.md +17 -12
  10. package/mindsystem/references/routing/audit-result-routing.md +4 -13
  11. package/mindsystem/references/routing/between-milestones-routing.md +1 -3
  12. package/mindsystem/references/routing/gap-closure-routing.md +1 -3
  13. package/mindsystem/references/routing/milestone-complete-routing.md +1 -3
  14. package/mindsystem/references/routing/next-phase-routing.md +1 -1
  15. package/mindsystem/templates/milestone-archive.md +3 -3
  16. package/mindsystem/templates/research-subagent-prompt.md +2 -2
  17. package/mindsystem/templates/research.md +7 -7
  18. package/mindsystem/templates/roadmap.md +7 -7
  19. package/mindsystem/workflows/complete-milestone.md +53 -230
  20. package/mindsystem/workflows/define-requirements.md +1 -3
  21. package/mindsystem/workflows/diagnose-issues.md +1 -3
  22. package/mindsystem/workflows/execute-phase.md +1 -3
  23. package/mindsystem/workflows/map-codebase.md +1 -3
  24. package/mindsystem/workflows/plan-phase.md +1 -3
  25. package/package.json +1 -1
  26. package/scripts/archive-milestone-files.sh +68 -0
  27. package/scripts/archive-milestone-phases.sh +138 -0
  28. package/scripts/gather-milestone-stats.sh +179 -0
  29. package/scripts/ms-lookup/ms_lookup/backends/context7.py +17 -5
  30. package/scripts/ms-lookup/ms_lookup/backends/perplexity.py +17 -3
  31. package/scripts/ms-lookup-wrapper.sh +1 -1
  32. package/scripts/validate-execution-order.sh +4 -5
  33. package/scripts/cleanup-phase-artifacts.sh +0 -68
@@ -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 (Context7), GitHub issues
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
- **Context7 MCP:**
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 (Context7 or official 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?
@@ -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 Context7 or official docs
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** - Context7 and official docs trump training data
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 (Context7)
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 (Perplexity)
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 Perplexity search:** Free with Max subscription. Perplexity search costs $5/1k queries with marginal quality improvement for discovery tasks.
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
- - Context7 returns results ranked by relevance — first 3-4 snippets are most important
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 | Context7, official documentation, official releases | State as fact |
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. Context7 (highest priority)**
306
- - Current, authoritative documentation
307
- - Library-specific, version-aware
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. **Context7 First** - Resolve library, query topics
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 (Context7 → Official → WebSearch)
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 Context7 or official docs
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
@@ -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 | Research | Discuss | Design |
465
- |-------|----------|---------|--------|
464
+ | Phase | Discuss | Design | Research |
465
+ |-------|---------|--------|----------|
466
466
  | 1 - Setup | Unlikely | Unlikely | Unlikely |
467
- | 2 - Auth | Likely | Likely | Unlikely |
468
- | 3 - Content | Unlikely | Likely | Likely |
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 | Research | Discuss | Design |
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
 
@@ -328,9 +328,7 @@ Plans:
328
328
 
329
329
  ## ▶ Next Up
330
330
 
331
- **Plan the quality phase**
332
-
333
- `/ms:plan-phase {N}`
331
+ `/ms:plan-phase {N}` — plan the quality phase
334
332
 
335
333
  <sub>`/clear` first → fresh context window</sub>
336
334
  ```
@@ -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/cleanup-phase-artifacts.sh $PHASE_START $PHASE_END
68
+ ~/.claude/mindsystem/scripts/gather-milestone-stats.sh $PHASE_START $PHASE_END
77
69
  ```
78
70
 
79
- 2. **Gather stats:**
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
- 3. **Extract accomplishments:**
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
- 4. **Archive milestone:**
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
- - Extract full phase details from ROADMAP.md
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
- 5. **Archive requirements:**
96
+ 6. **Archive requirements:**
101
97
 
102
98
  - Create `.planning/milestones/v{{version}}/REQUIREMENTS.md`
103
- - Mark all v1 requirements as complete (checkboxes checked)
104
- - Note requirement outcomes (validated, adjusted, dropped)
105
- - Delete `.planning/REQUIREMENTS.md` (fresh one created for next milestone)
99
+ - Mark all requirements as complete with outcomes
100
+ - Delete `.planning/REQUIREMENTS.md`
101
+
102
+ 7. **Archive milestone files:**
106
103
 
107
- 5.5. **Archive research:**
104
+ ```bash
105
+ ~/.claude/mindsystem/scripts/archive-milestone-files.sh v{{version}}
106
+ ```
108
107
 
109
- - If `.planning/research/` exists, move to `.planning/milestones/v{{version}}/research/`
110
- - Skip silently if no research directory exists
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
- 6. **Update PROJECT.md:**
114
+ 9. **Update STATE.md:**
113
115
 
114
- - Add "Current State" section with shipped version
115
- - Add "Next Milestone Goals" section
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
- 7. **Commit and tag:**
119
+ 10. **Commit and tag:**
119
120
 
120
- - Stage: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, archive files
121
- - Commit: `chore: archive v{{version}} milestone`
122
- - Tag: `git tag -a v{{version}} -m "[milestone summary]"`
123
- - Ask about pushing tag
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
- 8. **Offer next steps:**
126
- - `/ms:new-milestone` — discover goals and update PROJECT.md (includes optional discovery mode)
126
+ 11. **Offer next steps:**
127
+ - `/ms:new-milestone` — discover goals and update PROJECT.md
127
128
 
128
- 9. **Update last command**
129
- - Update `.planning/STATE.md` Last Command field
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
- - Raw artifacts cleaned from phase directories (CONTEXT, DESIGN, RESEARCH, SUMMARY, UAT, VERIFICATION, EXECUTION-ORDER)
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
- **[Recommended command]** — [one-line reason from conversation]
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
- **Plan first gap closure phase**
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
- ## > Next Up
339
- **Define requirements and create roadmap** - `/ms:create-roadmap`
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
- **{identifier}: {name}** — {one-line description}
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. **Always show what it is** — name + description, never just a command path
30
- 2. **Pull context from source** — ROADMAP.md for phases, PLAN.md `<objective>` for plans
31
- 3. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
32
- 4. **`/clear` explanation** — always include, keeps it concise but explains why
33
- 5. **"Also available" not "Other options"** sounds more app-like
34
- 6. **Visual separators** `---` above and below to make it stand out
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
- **Start v1.1** — discover what to build next
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
- **Complete milestone** — archive and tag
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
- **Plan gap closure** — create phases to complete milestone
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
- **A. Complete milestone** — accept debt, track in backlog
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
- **Start Next Milestone** — discover what to build, update PROJECT.md
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
- **Plan gap closure** — create additional plans to complete the phase
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
- **Audit milestone** — verify requirements, cross-phase integration, E2E flows
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/ROADMAP.md_
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
- - Update ROADMAP.md to collapse completed milestone in `<details>` tag
121
- - Update PROJECT.md to brownfield format with Current State section
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 (Context7), ms-lookup deep (Perplexity), WebSearch, WebFetch
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 (Perplexity), WebSearch
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 Context7/official docs]
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: [Context7/official docs URL]
134
+ // Source: [official docs URL]
135
135
  [code]
136
136
  ```
137
137
 
138
138
  ### [Common Operation 2]
139
139
  ```typescript
140
- // Source: [Context7/official docs URL]
140
+ // Source: [official docs URL]
141
141
  [code]
142
142
  ```
143
143
 
144
144
  ### [Common Operation 3]
145
145
  ```typescript
146
- // Source: [Context7/official docs URL]
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
- - [Context7 library ID] - [topics fetched]
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 Context7, widely used
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 Context7/official sources
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)