mindsystem-cc 3.11.0 → 3.13.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 (35) hide show
  1. package/agents/ms-consolidator.md +4 -4
  2. package/agents/ms-executor.md +19 -351
  3. package/agents/ms-flutter-code-quality.md +7 -6
  4. package/agents/ms-plan-checker.md +170 -175
  5. package/agents/ms-plan-writer.md +121 -125
  6. package/agents/ms-roadmapper.md +1 -18
  7. package/agents/ms-verifier.md +22 -18
  8. package/commands/ms/check-phase.md +3 -3
  9. package/commands/ms/design-phase.md +2 -9
  10. package/commands/ms/execute-phase.md +8 -6
  11. package/commands/ms/help.md +0 -5
  12. package/commands/ms/new-project.md +3 -40
  13. package/commands/ms/plan-phase.md +4 -3
  14. package/commands/ms/review-design.md +1 -8
  15. package/mindsystem/references/goal-backward.md +10 -25
  16. package/mindsystem/references/plan-format.md +326 -247
  17. package/mindsystem/references/scope-estimation.md +29 -57
  18. package/mindsystem/references/tdd-execution.md +70 -0
  19. package/mindsystem/references/tdd.md +53 -194
  20. package/mindsystem/templates/config.json +0 -11
  21. package/mindsystem/templates/phase-prompt.md +51 -367
  22. package/mindsystem/templates/roadmap.md +2 -2
  23. package/mindsystem/templates/verification-report.md +2 -2
  24. package/mindsystem/workflows/adhoc.md +16 -21
  25. package/mindsystem/workflows/execute-phase.md +71 -50
  26. package/mindsystem/workflows/execute-plan.md +183 -1060
  27. package/mindsystem/workflows/mockup-generation.md +10 -4
  28. package/mindsystem/workflows/plan-phase.md +56 -75
  29. package/mindsystem/workflows/transition.md +1 -10
  30. package/mindsystem/workflows/verify-phase.md +16 -20
  31. package/package.json +1 -1
  32. package/scripts/update-state.sh +59 -0
  33. package/scripts/validate-execution-order.sh +102 -0
  34. package/skills/flutter-code-quality/SKILL.md +4 -3
  35. package/mindsystem/templates/summary.md +0 -293
@@ -215,46 +215,9 @@ Do not compress. Capture everything gathered.
215
215
 
216
216
  </step>
217
217
 
218
- <step name="workflow_preferences">
219
-
220
- Ask workflow preferences in a single AskUserQuestion call (2 questions):
221
-
222
- Use AskUserQuestion with questions array:
223
-
224
- ```
225
- questions: [
226
- {
227
- header: "Depth",
228
- question: "How thorough should planning be?",
229
- multiSelect: false,
230
- options: [
231
- { label: "Quick", description: "Ship fast (3-5 phases, 1-3 plans each)" },
232
- { label: "Standard (Recommended)", description: "Balanced scope and speed (5-8 phases, 3-5 plans each)" },
233
- { label: "Comprehensive", description: "Thorough coverage (8-12 phases, 5-10 plans each)" }
234
- ]
235
- },
236
- {
237
- header: "Execution",
238
- question: "Run plans in parallel?",
239
- multiSelect: false,
240
- options: [
241
- { label: "Parallel (Recommended)", description: "Independent plans run simultaneously" },
242
- { label: "Sequential", description: "One plan at a time" }
243
- ]
244
- }
245
- ]
246
- ```
247
-
248
- **Notes:**
249
- - Depth controls compression tolerance, not artificial inflation
250
- - Parallelization spawns multiple agents for independent plans
251
- - All settings can be changed later in config.json
252
-
253
- </step>
254
-
255
218
  <step name="config">
256
219
 
257
- Create `.planning/config.json` with chosen depth, parallelization, and subsystems using `templates/config.json` structure.
220
+ Create `.planning/config.json` with subsystems and code_review using `templates/config.json` structure.
258
221
 
259
222
  **Subsystems:** Derive 5-10 initial subsystems from the project context gathered during questioning. These are short, lowercase identifiers for the major functional areas of the project.
260
223
 
@@ -263,7 +226,7 @@ Examples by project type:
263
226
  - SaaS: `["auth", "dashboard", "analytics", "billing", "notifications", "ui", "api", "database"]`
264
227
  - Mobile app: `["auth", "onboarding", "feed", "messaging", "profile", "media", "api", "storage"]`
265
228
 
266
- Place `subsystems` array as the first field in config.json (before `depth`). These values are used throughout the system for consistent categorization of summaries, debug docs, and adhoc work.
229
+ These values are used throughout the system for consistent categorization of summaries, debug docs, and adhoc work.
267
230
 
268
231
  </step>
269
232
 
@@ -340,7 +303,7 @@ Update `.planning/STATE.md` Last Command field (if STATE.md exists):
340
303
  - [ ] PROJECT.md captures full context with evolutionary structure
341
304
  - [ ] Requirements initialized as hypotheses (greenfield) or with inferred Validated (brownfield)
342
305
  - [ ] Key Decisions table initialized
343
- - [ ] config.json has depth and parallelization settings
306
+ - [ ] config.json has subsystems and code_review settings
344
307
  - [ ] All committed to git
345
308
 
346
309
  </success_criteria>
@@ -112,8 +112,9 @@ Check for `.planning/codebase/` and load relevant documents based on phase type.
112
112
  <success_criteria>
113
113
 
114
114
  - One or more PLAN.md files created in .planning/phases/XX-name/
115
- - Each plan has: objective, execution_context, context, tasks, verification, success_criteria, output
116
- - must_haves derived from phase goal and documented in frontmatter (truths, artifacts, key_links)
117
- - Tasks are specific enough for Claude to execute
115
+ - Each plan has: Context, Changes, Verification, Must-Haves (pure markdown format)
116
+ - Must-Haves derived as markdown checklist of user-observable truths
117
+ - Changes are specific enough for Claude to execute
118
+ - EXECUTION-ORDER.md created with wave groups and dependencies
118
119
  - User knows next steps (execute plan or review/adjust)
119
120
  </success_criteria>
@@ -119,14 +119,7 @@ ls .planning/phases/${PHASE_ARG}-*/*-DESIGN.md 2>/dev/null
119
119
 
120
120
  **Project UI skill (if exists):**
121
121
 
122
- Discover project-level skills:
123
- ```bash
124
- ls .claude/skills/*/SKILL.md 2>/dev/null
125
- ```
126
-
127
- If skills found, read the YAML frontmatter (name + description) of each SKILL.md. Identify any skill whose description indicates it provides UI implementation patterns (screens, widgets, components, theming, spacing, visual patterns).
128
-
129
- If a UI skill is found, load as authoritative source for existing patterns.
122
+ Check your available skills for one that provides domain expertise relevant to this project's UI implementation patterns. If found, invoke it via the Skill tool and use as authoritative source for existing patterns.
130
123
 
131
124
  **Codebase analysis:**
132
125
  - Detect platform (Flutter, React, etc.)
@@ -117,31 +117,16 @@ Key links get extra verification attention. These are where stubs and placeholde
117
117
  </the_process>
118
118
 
119
119
  <output_format>
120
- The derive_must_haves step produces a structured list for PLAN.md frontmatter:
121
-
122
- ```yaml
123
- must_haves:
124
- truths:
125
- - "User can see existing messages"
126
- - "User can send a message"
127
- - "Messages persist across refresh"
128
- artifacts:
129
- - path: "src/components/Chat.tsx"
130
- provides: "Message list rendering"
131
- - path: "src/app/api/chat/route.ts"
132
- provides: "Message CRUD operations"
133
- - path: "prisma/schema.prisma"
134
- provides: "Message model"
135
- key_links:
136
- - from: "Chat.tsx"
137
- to: "api/chat"
138
- via: "fetch in useEffect"
139
- - from: "api/chat POST"
140
- to: "database"
141
- via: "prisma.message.create"
120
+ The derive_must_haves step produces a markdown checklist for the plan's ## Must-Haves section:
121
+
122
+ ```markdown
123
+ ## Must-Haves
124
+ - [ ] User can see existing messages
125
+ - [ ] User can send a message
126
+ - [ ] Messages persist across refresh
142
127
  ```
143
128
 
144
- This structure is machine-readable for verification after execution.
129
+ Each item is a user-observable truth. The verifier derives artifacts and key_links from the plan's ## Changes section.
145
130
  </output_format>
146
131
 
147
132
  <examples>
@@ -261,7 +246,7 @@ Key links are verification priorities. Without them, you check everything equall
261
246
 
262
247
  The `derive_must_haves` step runs after gathering context, before breaking into tasks.
263
248
 
264
- Output: `must_haves` structure written to PLAN.md frontmatter.
249
+ Output: must-haves written to the plan's ## Must-Haves section.
265
250
 
266
251
  Tasks are then designed to CREATE the artifacts and ESTABLISH the wiring.
267
252
 
@@ -269,7 +254,7 @@ Tasks are then designed to CREATE the artifacts and ESTABLISH the wiring.
269
254
 
270
255
  The `verify_phase_goal` step runs after all plans execute, before updating roadmap.
271
256
 
272
- Input: `must_haves` from PLAN.md frontmatter (or derived from goal if missing).
257
+ Input: ## Must-Haves from plan markdown (or derived from goal if missing).
273
258
 
274
259
  Process: Check each truth against codebase, verify artifacts exist and aren't stubs, trace key links.
275
260