mindforge-cc 2.2.0 → 2.3.5

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 (226) hide show
  1. package/.agent/CLAUDE.md +14 -0
  2. package/.agent/forge/help.md +4 -0
  3. package/.agent/forge/init-project.md +4 -0
  4. package/.agent/forge/plan-phase.md +4 -0
  5. package/.agent/mindforge/approve.md +4 -0
  6. package/.agent/mindforge/audit.md +4 -0
  7. package/.agent/mindforge/auto.md +4 -0
  8. package/.agent/mindforge/benchmark.md +4 -0
  9. package/.agent/mindforge/browse.md +4 -0
  10. package/.agent/mindforge/complete-milestone.md +4 -0
  11. package/.agent/mindforge/costs.md +4 -0
  12. package/.agent/mindforge/cross-review.md +4 -0
  13. package/.agent/mindforge/dashboard.md +4 -0
  14. package/.agent/mindforge/debug.md +4 -0
  15. package/.agent/mindforge/discuss-phase.md +4 -0
  16. package/.agent/mindforge/execute-phase.md +4 -0
  17. package/.agent/mindforge/health.md +4 -0
  18. package/.agent/mindforge/help.md +4 -0
  19. package/.agent/mindforge/init-org.md +4 -0
  20. package/.agent/mindforge/init-project.md +4 -0
  21. package/.agent/mindforge/install-skill.md +4 -0
  22. package/.agent/mindforge/learn.md +4 -0
  23. package/.agent/mindforge/map-codebase.md +4 -0
  24. package/.agent/mindforge/marketplace.md +4 -0
  25. package/.agent/mindforge/metrics.md +4 -0
  26. package/.agent/mindforge/migrate.md +4 -0
  27. package/.agent/mindforge/milestone.md +4 -0
  28. package/.agent/mindforge/new-runtime.md +4 -0
  29. package/.agent/mindforge/next.md +4 -0
  30. package/.agent/mindforge/plan-phase.md +4 -0
  31. package/.agent/mindforge/plugins.md +4 -0
  32. package/.agent/mindforge/pr-review.md +4 -0
  33. package/.agent/mindforge/profile-team.md +4 -0
  34. package/.agent/mindforge/publish-skill.md +4 -0
  35. package/.agent/mindforge/qa.md +4 -0
  36. package/.agent/mindforge/quick.md +4 -0
  37. package/.agent/mindforge/release.md +4 -0
  38. package/.agent/mindforge/remember.md +4 -0
  39. package/.agent/mindforge/research.md +4 -0
  40. package/.agent/mindforge/retrospective.md +4 -0
  41. package/.agent/mindforge/review.md +4 -0
  42. package/.agent/mindforge/security-scan.md +4 -0
  43. package/.agent/mindforge/ship.md +4 -0
  44. package/.agent/mindforge/skills.md +4 -0
  45. package/.agent/mindforge/status.md +4 -0
  46. package/.agent/mindforge/steer.md +4 -0
  47. package/.agent/mindforge/sync-confluence.md +4 -0
  48. package/.agent/mindforge/sync-jira.md +4 -0
  49. package/.agent/mindforge/tokens.md +4 -0
  50. package/.agent/mindforge/update.md +4 -0
  51. package/.agent/mindforge/verify-phase.md +4 -0
  52. package/.agent/mindforge/workspace.md +4 -0
  53. package/.agent/workflows/forge:help.md +10 -0
  54. package/.agent/workflows/forge:init-project.md +35 -0
  55. package/.agent/workflows/forge:plan-phase.md +33 -0
  56. package/.agent/workflows/mindforge:add-backlog.md +24 -0
  57. package/.agent/workflows/mindforge:agent.md +25 -0
  58. package/.agent/workflows/mindforge:approve.md +21 -0
  59. package/.agent/workflows/mindforge:audit.md +33 -0
  60. package/.agent/workflows/mindforge:auto.md +25 -0
  61. package/.agent/workflows/mindforge:benchmark.md +36 -0
  62. package/.agent/workflows/mindforge:browse.md +29 -0
  63. package/.agent/workflows/mindforge:complete-milestone.md +21 -0
  64. package/.agent/workflows/mindforge:costs.md +14 -0
  65. package/.agent/workflows/mindforge:cross-review.md +20 -0
  66. package/.agent/workflows/mindforge:dashboard.md +101 -0
  67. package/.agent/workflows/mindforge:debug.md +129 -0
  68. package/.agent/workflows/mindforge:discuss-phase.md +141 -0
  69. package/.agent/workflows/mindforge:do.md +25 -0
  70. package/.agent/workflows/mindforge:execute-phase.md +193 -0
  71. package/.agent/workflows/mindforge:health.md +24 -0
  72. package/.agent/workflows/mindforge:help.md +26 -0
  73. package/.agent/workflows/mindforge:init-org.md +134 -0
  74. package/.agent/workflows/mindforge:init-project.md +169 -0
  75. package/.agent/workflows/mindforge:install-skill.md +27 -0
  76. package/.agent/workflows/mindforge:learn.md +146 -0
  77. package/.agent/workflows/mindforge:map-codebase.md +301 -0
  78. package/.agent/workflows/mindforge:marketplace.md +123 -0
  79. package/.agent/workflows/mindforge:metrics.md +25 -0
  80. package/.agent/workflows/mindforge:migrate.md +43 -0
  81. package/.agent/workflows/mindforge:milestone.md +15 -0
  82. package/.agent/workflows/mindforge:new-runtime.md +22 -0
  83. package/.agent/workflows/mindforge:next.md +108 -0
  84. package/.agent/workflows/mindforge:note.md +27 -0
  85. package/.agent/workflows/mindforge:plan-phase.md +128 -0
  86. package/.agent/workflows/mindforge:plant-seed.md +24 -0
  87. package/.agent/workflows/mindforge:plugins.md +43 -0
  88. package/.agent/workflows/mindforge:pr-review.md +44 -0
  89. package/.agent/workflows/mindforge:profile-team.md +26 -0
  90. package/.agent/workflows/mindforge:publish-skill.md +22 -0
  91. package/.agent/workflows/mindforge:qa.md +19 -0
  92. package/.agent/workflows/mindforge:quick.md +138 -0
  93. package/.agent/workflows/mindforge:release.md +13 -0
  94. package/.agent/workflows/mindforge:remember.md +29 -0
  95. package/.agent/workflows/mindforge:research.md +15 -0
  96. package/.agent/workflows/mindforge:retrospective.md +29 -0
  97. package/.agent/workflows/mindforge:review-backlog.md +26 -0
  98. package/.agent/workflows/mindforge:review.md +160 -0
  99. package/.agent/workflows/mindforge:security-scan.md +236 -0
  100. package/.agent/workflows/mindforge:session-report.md +31 -0
  101. package/.agent/workflows/mindforge:ship.md +103 -0
  102. package/.agent/workflows/mindforge:skills.md +144 -0
  103. package/.agent/workflows/mindforge:status.md +107 -0
  104. package/.agent/workflows/mindforge:steer.md +16 -0
  105. package/.agent/workflows/mindforge:sync-confluence.md +14 -0
  106. package/.agent/workflows/mindforge:sync-jira.md +15 -0
  107. package/.agent/workflows/mindforge:tokens.md +11 -0
  108. package/.agent/workflows/mindforge:ui-phase.md +27 -0
  109. package/.agent/workflows/mindforge:ui-review.md +28 -0
  110. package/.agent/workflows/mindforge:update.md +45 -0
  111. package/.agent/workflows/mindforge:validate-phase.md +25 -0
  112. package/.agent/workflows/mindforge:verify-phase.md +65 -0
  113. package/.agent/workflows/mindforge:workspace.md +32 -0
  114. package/.agent/workflows/mindforge:workstreams.md +27 -0
  115. package/.claude/CLAUDE.md +14 -0
  116. package/.mindforge/memory/knowledge-base.jsonl +11 -0
  117. package/.mindforge/memory/pattern-library.jsonl +2 -0
  118. package/.mindforge/memory/team-preferences.jsonl +5 -0
  119. package/.planning/AUDIT.jsonl +1 -1
  120. package/.planning/HANDOFF.json +6 -26
  121. package/.planning/ROADMAP.md +3 -1
  122. package/.planning/jira-sync.json +3 -7
  123. package/.planning/phases/.gitkeep +0 -0
  124. package/.planning/research/.gitkeep +0 -0
  125. package/.planning/screenshots/.gitkeep +0 -0
  126. package/.planning/slack-threads.json +1 -4
  127. package/CHANGELOG.md +69 -9
  128. package/README.md +1 -1
  129. package/RELEASENOTES.md +1 -1
  130. package/bin/installer-core.js +204 -63
  131. package/bin/wizard/theme.js +4 -2
  132. package/package.json +1 -1
  133. package/.planning/approvals/v2-architecture-approval.json +0 -15
  134. package/.planning/decisions/ADR-001-handoff-tracking.md +0 -41
  135. package/.planning/decisions/ADR-002-markdown-commands.md +0 -46
  136. package/.planning/decisions/ADR-003-skills-trigger-model.md +0 -37
  137. package/.planning/decisions/ADR-004-wave-parallelism-model.md +0 -45
  138. package/.planning/decisions/ADR-005-append-only-audit-log.md +0 -51
  139. package/.planning/decisions/ADR-006-tiered-skills-system.md +0 -22
  140. package/.planning/decisions/ADR-007-trigger-keyword-model.md +0 -22
  141. package/.planning/decisions/ADR-008-just-in-time-skill-loading.md +0 -29
  142. package/.planning/decisions/ADR-009-enterprise-integration-retry-policy.md +0 -8
  143. package/.planning/decisions/ADR-010-governance-tier-escalation.md +0 -8
  144. package/.planning/decisions/ADR-011-multi-developer-handoff-contract.md +0 -8
  145. package/.planning/decisions/ADR-012-intelligence-feedback-loops.md +0 -19
  146. package/.planning/decisions/ADR-013-mindforge-md-constitution.md +0 -16
  147. package/.planning/decisions/ADR-014-metrics-as-signals-not-evaluation.md +0 -15
  148. package/.planning/decisions/ADR-015-npm-based-skill-registry.md +0 -26
  149. package/.planning/decisions/ADR-016-ci-exit-code-0-on-timeout.md +0 -27
  150. package/.planning/decisions/ADR-017-sdk-localhost-only.md +0 -28
  151. package/.planning/decisions/ADR-018-installer-self-install-detection.md +0 -15
  152. package/.planning/decisions/ADR-019-self-update-scope-preservation.md +0 -14
  153. package/.planning/decisions/ADR-020-v1.0.0-stable-interface-contract.md +0 -23
  154. package/.planning/decisions/ADR-021-autonomy-boundary.md +0 -17
  155. package/.planning/decisions/ADR-022-node-repair-hierarchy.md +0 -19
  156. package/.planning/decisions/ADR-023-gate-3-timing.md +0 -15
  157. package/.planning/decisions/ADR-036-learn-command-docs-as-skill-source.md +0 -26
  158. package/.planning/decisions/ADR-037-auto-capture-frequency-threshold.md +0 -26
  159. package/.planning/decisions/ADR-038-skill-quality-minimum-60.md +0 -27
  160. package/.planning/phases/day1/REVIEW-DAY1.md +0 -50
  161. package/.planning/phases/day1/SECURITY-REVIEW-DAY1.md +0 -15
  162. package/.planning/phases/day2/REVIEW-DAY2.md +0 -521
  163. package/.planning/phases/day3/REVIEW-DAY3.md +0 -234
  164. /package/{.planning/phases/01-migrate-gsd-to-mindforge/.gitkeep → .mindforge/memory/decision-library.jsonl} +0 -0
  165. /package/docs/{Context → context}/Master-Context.md +0 -0
  166. /package/docs/{References → references}/audit-events.md +0 -0
  167. /package/docs/{References → references}/checkpoints.md +0 -0
  168. /package/docs/{References → references}/commands.md +0 -0
  169. /package/docs/{References → references}/config-reference.md +0 -0
  170. /package/docs/{References → references}/continuation-format.md +0 -0
  171. /package/docs/{References → references}/decimal-phase-calculation.md +0 -0
  172. /package/docs/{References → references}/git-integration.md +0 -0
  173. /package/docs/{References → references}/git-planning-commit.md +0 -0
  174. /package/docs/{References → references}/model-profile-resolution.md +0 -0
  175. /package/docs/{References → references}/model-profiles.md +0 -0
  176. /package/docs/{References → references}/phase-argument-parsing.md +0 -0
  177. /package/docs/{References → references}/planning-config.md +0 -0
  178. /package/docs/{References → references}/questioning.md +0 -0
  179. /package/docs/{References → references}/sdk-api.md +0 -0
  180. /package/docs/{References → references}/skills-api.md +0 -0
  181. /package/docs/{References → references}/tdd.md +0 -0
  182. /package/docs/{References → references}/ui-brand.md +0 -0
  183. /package/docs/{References → references}/user-profiling.md +0 -0
  184. /package/docs/{References → references}/verification-patterns.md +0 -0
  185. /package/docs/{References → references}/workstream-flag.md +0 -0
  186. /package/docs/{Templates → templates}/Agents/CLAUDE-MD.md +0 -0
  187. /package/docs/{Templates → templates}/Agents/COPILOT-INSTRUCTIONS.md +0 -0
  188. /package/docs/{Templates → templates}/Agents/DEBUGGER-PROMPT.md +0 -0
  189. /package/docs/{Templates → templates}/Agents/PLANNER-PROMPT.md +0 -0
  190. /package/docs/{Templates → templates}/Execution/CONTINUE-HERE.md +0 -0
  191. /package/docs/{Templates → templates}/Execution/DISCUSSION-LOG.md +0 -0
  192. /package/docs/{Templates → templates}/Execution/PHASE-PROMPT.md +0 -0
  193. /package/docs/{Templates → templates}/Execution/STATE.md +0 -0
  194. /package/docs/{Templates → templates}/Execution/SUMMARY-COMPLEX.md +0 -0
  195. /package/docs/{Templates → templates}/Execution/SUMMARY-MINIMAL.md +0 -0
  196. /package/docs/{Templates → templates}/Execution/SUMMARY-STANDARD.md +0 -0
  197. /package/docs/{Templates → templates}/Execution/SUMMARY.md +0 -0
  198. /package/docs/{Templates → templates}/Profile/DEV-PREFERENCES.md +0 -0
  199. /package/docs/{Templates → templates}/Profile/USER-PROFILE.md +0 -0
  200. /package/docs/{Templates → templates}/Profile/USER-SETUP.md +0 -0
  201. /package/docs/{Templates → templates}/Project/DISCOVERY.md +0 -0
  202. /package/docs/{Templates → templates}/Project/MILESTONE-ARCHIVE.md +0 -0
  203. /package/docs/{Templates → templates}/Project/MILESTONE.md +0 -0
  204. /package/docs/{Templates → templates}/Project/PROJECT.md +0 -0
  205. /package/docs/{Templates → templates}/Project/REQUIREMENTS.md +0 -0
  206. /package/docs/{Templates → templates}/Project/RETROSPECTIVE.md +0 -0
  207. /package/docs/{Templates → templates}/Project/ROADMAP.md +0 -0
  208. /package/docs/{Templates → templates}/Quality/DEBUG.md +0 -0
  209. /package/docs/{Templates → templates}/Quality/UAT.md +0 -0
  210. /package/docs/{Templates → templates}/Quality/UI-SPEC.md +0 -0
  211. /package/docs/{Templates → templates}/Quality/VALIDATION.md +0 -0
  212. /package/docs/{Templates → templates}/Quality/VERIFICATION-REPORT.md +0 -0
  213. /package/docs/{Templates → templates}/System/CONFIG.json +0 -0
  214. /package/docs/{Templates → templates}/System/CONTEXT.md +0 -0
  215. /package/docs/{Templates/Codebase → templates/codebase}/architecture.md +0 -0
  216. /package/docs/{Templates/Codebase → templates/codebase}/concerns.md +0 -0
  217. /package/docs/{Templates/Codebase → templates/codebase}/conventions.md +0 -0
  218. /package/docs/{Templates/Codebase → templates/codebase}/integrations.md +0 -0
  219. /package/docs/{Templates/Codebase → templates/codebase}/stack.md +0 -0
  220. /package/docs/{Templates/Codebase → templates/codebase}/structure.md +0 -0
  221. /package/docs/{Templates/Codebase → templates/codebase}/testing.md +0 -0
  222. /package/docs/{Templates/Research → templates/research}/ARCHITECTURE.md +0 -0
  223. /package/docs/{Templates/Research → templates/research}/FEATURES.md +0 -0
  224. /package/docs/{Templates/Research → templates/research}/PITFALLS.md +0 -0
  225. /package/docs/{Templates/Research → templates/research}/STACK.md +0 -0
  226. /package/docs/{Templates/Research → templates/research}/SUMMARY.md +0 -0
@@ -0,0 +1,107 @@
1
+ ---
2
+ description: Display a rich dashboard of the current project state.
3
+ ---
4
+ # MindForge — Status Command
5
+ # Usage: /mindforge:status
6
+
7
+ Display a rich dashboard of the current project state.
8
+ Pull data from STATE.md, AUDIT.jsonl, REQUIREMENTS.md, and the phases directory.
9
+
10
+ ## Dashboard sections
11
+
12
+ ### Section 1 — Project header
13
+ ```
14
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
15
+ ⚡ MindForge Status — [Project Name]
16
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
17
+ Last updated : [STATE.md last updated timestamp]
18
+ Current phase: Phase [N] — [phase description]
19
+ Status : [status from STATE.md]
20
+ ```
21
+
22
+ ### Section 2 — Phase progress
23
+ ```
24
+ Phase Progress
25
+ ───────────────────────────────────────────────────────
26
+ Phase 1 [████████████████████] 100% — Complete ✅
27
+ Phase 2 [████████░░░░░░░░░░░░] 40% — In progress
28
+ Phase 3 [░░░░░░░░░░░░░░░░░░░░] 0% — Not started
29
+ Phase 4 [░░░░░░░░░░░░░░░░░░░░] 0% — Not started
30
+ ```
31
+ Calculate percentage from: tasks with SUMMARY files / total tasks in phase.
32
+ Count ONLY SUMMARY files that contain `Status: Completed ✅` (or `Status` + `Completed`).
33
+ Do not count failed tasks as progress.
34
+ If VERIFICATION.md is missing for a phase: label it "In progress" not "0% verified".
35
+
36
+ ### Section 3 — Requirements coverage
37
+ Read REQUIREMENTS.md and count:
38
+ - Total v1 requirements
39
+ - Requirements with a passing test (from VERIFICATION.md files)
40
+ - Requirements implemented but untested
41
+ - Requirements not yet started
42
+
43
+ ```
44
+ Requirements (v1)
45
+ ───────────────────────────────────────────────────────
46
+ Total : [N]
47
+ ✅ Done + tested : [N]
48
+ ⚠️ Done, no test : [N]
49
+ 🔴 Not started : [N]
50
+ ```
51
+
52
+ ### Section 4 — Recent activity (from AUDIT.jsonl)
53
+ Read the last 10 entries from AUDIT.jsonl and display:
54
+ ```
55
+ Recent Activity
56
+ ───────────────────────────────────────────────────────
57
+ [timestamp] task_completed Plan 03: User API endpoints ✅
58
+ [timestamp] task_completed Plan 02: Product model ✅
59
+ [timestamp] task_started Plan 03: User API endpoints
60
+ [timestamp] task_completed Plan 01: User model ✅
61
+ [timestamp] context_compaction Phase 2, Plan 03 (72% context)
62
+ ```
63
+ If AUDIT.jsonl is empty or missing, display:
64
+ ```
65
+ Recent Activity
66
+ ───────────────────────────────────────────────────────
67
+ No activity logged yet. Activity will appear here
68
+ after running /mindforge:execute-phase.
69
+ ```
70
+
71
+ ### Section 5 — Open issues
72
+ Check for:
73
+ - Any open SECURITY-REVIEW files with CRITICAL or HIGH findings
74
+ - Any BUGS.md files with open issues
75
+ - Any failed tasks in WAVE-REPORT files
76
+ - Any blockers in STATE.md
77
+
78
+ ```
79
+ Open Issues
80
+ ───────────────────────────────────────────────────────
81
+ 🔴 CRITICAL: [if any — from SECURITY-REVIEW]
82
+ 🟠 HIGH: [if any]
83
+ ✅ No open issues
84
+ ```
85
+
86
+ ### Section 6 — Next action
87
+ ```
88
+ Next Action
89
+ ───────────────────────────────────────────────────────
90
+ [What STATE.md says the next action is]
91
+ Run: /mindforge:next
92
+ to auto-execute the next step.
93
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
94
+ ```
95
+
96
+ ## Data sources (in priority order)
97
+ 1. STATE.md — authoritative for current status
98
+ 2. AUDIT.jsonl — authoritative for history
99
+ 3. REQUIREMENTS.md — authoritative for scope
100
+ 4. VERIFICATION.md files — authoritative for test coverage
101
+ 5. WAVE-REPORT files — authoritative for execution history
102
+ 6. HANDOFF.json — authoritative for session state
103
+
104
+ ## Performance notes
105
+ - For recent activity, read only the last 500 bytes of AUDIT.jsonl:
106
+ `tail -c 500 .planning/AUDIT.jsonl | [parse last complete JSON objects]`
107
+ - For requirement counts, count lines starting with `| FR-` instead of parsing the whole file.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Injects mid-execution guidance into the running autonomous engine.
3
+ ---
4
+ # /mindforge:steer "[instruction]"
5
+
6
+ **Purpose**: Injects mid-execution guidance into the running autonomous engine.
7
+ Steering guidance is applied at the next task boundary to course-correct MindForge.
8
+
9
+ ## Usage
10
+ - `/mindforge:steer "Use the new logger in all created files"`
11
+ - `/mindforge:steer --task 3-05 "This plan is too broad, focus on login only"`
12
+ - `/mindforge:steer --cancel` (Clears the steering queue)
13
+
14
+ ## Precedence
15
+ - Steering instructions take precedence over the original `PLAN-N-MM.md` actions.
16
+ - Steering cannot override core security constraints or governance gates.
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: Publish approved planning artifacts to Confluence. Usage:
3
+ ---
4
+ Publish approved planning artifacts to Confluence. Usage:
5
+ `/mindforge:sync-confluence [--architecture] [--phase N] [--milestone name]`
6
+
7
+ ## Behaviour
8
+ - verify Confluence availability through `connection-manager.md`
9
+ - publish idempotently by existing page title or page ID
10
+ - never publish secrets, raw approval notes, or raw audit logs
11
+ - log success, skip, or failure to AUDIT
12
+
13
+ Publishing failures are non-fatal and create a pending manual action in
14
+ `STATE.md`.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Synchronise MindForge phase and plan metadata to Jira. Usage:
3
+ ---
4
+ Synchronise MindForge phase and plan metadata to Jira. Usage:
5
+ `/mindforge:sync-jira [--phase N] [--plan M]`
6
+
7
+ ## Behaviour
8
+ - verify Jira availability through `connection-manager.md`
9
+ - create or update Epic and Story mappings in `.planning/jira-sync.json`
10
+ - use dynamic transition lookup, never hardcoded IDs
11
+ - preserve manual Jira edits
12
+ - log all actions to AUDIT
13
+
14
+ Integration failures are non-fatal and should be written to `STATE.md` for
15
+ manual retry.
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: Display token consumption profile and efficiency analysis.
3
+ ---
4
+ # MindForge — Token Usage Command
5
+ # Usage: /mindforge:tokens [--phase N] [--session ID] [--window short|medium|long] [--optimise]
6
+
7
+ ## Purpose
8
+ Display token consumption profile and efficiency analysis.
9
+ Helps identify where tokens are being spent and how to reduce waste.
10
+
11
+ ## Default output (no flags — last 5 sessions)
@@ -0,0 +1,27 @@
1
+ ---
2
+ description: Generate a UI Design Contract (UI-SPEC.md) for the current phase
3
+ ---
4
+ <objective>
5
+ Generate a detailed UI design contract (UI-SPEC.md) for a frontend development phase to ensure consistent spacing, typography, color palettes, and accessibility standards before implementation.
6
+ </objective>
7
+
8
+ <execution_context>
9
+ .claude/commands/mindforge/ui-phase.md
10
+ </execution_context>
11
+
12
+ <context>
13
+ Arguments: $ARGUMENTS (The phase number [N], optional)
14
+ Configuration: MINDFORGE.md `UI_PHASE_ACCESSIBILITY_STANDARD`
15
+ State: Resolves the phase from STATE.md if N is not provided.
16
+ </context>
17
+
18
+ <process>
19
+ 1. **Identify Phase**: Get the current or targeted phase number.
20
+ 2. **Read Inputs**: Read `REQUIREMENTS.md` and `DESIGN_SYSTEM.md`.
21
+ 3. **Generate UI-SPEC.md**:
22
+ - Define component-level spacing and layout for the phase.
23
+ - Specify required colors and typography from the design system.
24
+ - List accessibility requirements (WCAG level).
25
+ 4. **Finalize**: Write `UI-SPEC.md` to the phase's planning directory or the root `.planning/`.
26
+ 5. **Confirm**: Provide a link to the user for review.
27
+ </process>
@@ -0,0 +1,28 @@
1
+ ---
2
+ description: Perform a retroactive visual audit of implemented UI against the DESIGN_SYSTEM.md and UI-SPEC.md
3
+ ---
4
+ <objective>
5
+ Perform a retroactive, multi-pillar visual audit of implemented UI features against the defined Design System and UI-SPEC.md to ensure pixel-perfect fidelity and accessibility compliance.
6
+ </objective>
7
+
8
+ <execution_context>
9
+ .claude/commands/mindforge/ui-review.md
10
+ </execution_context>
11
+
12
+ <context>
13
+ Arguments: $ARGUMENTS (The phase number [N], optional)
14
+ Sources: `DESIGN_SYSTEM.md`, `UI-SPEC.md`, and the live application UI.
15
+ </context>
16
+
17
+ <process>
18
+ 1. **Identify Target**: Determine the phase to review.
19
+ 2. **Audit Application**:
20
+ - Use the browser tool to inspect the implemented features.
21
+ - Compare against the `UI-SPEC.md` for spacing, colors, and layout.
22
+ - Audit for accessibility (ARIA labels, contrast, keyboard navigation).
23
+ 3. **Generate UI-REVIEW.md**:
24
+ - Grade each pillar (Layout, Color, Typography, etc.).
25
+ - List specific "Needs Work" items.
26
+ - Provide "Approved" status if all criteria are met.
27
+ 4. **Finalize**: Notify the user of the audit results.
28
+ </process>
@@ -0,0 +1,45 @@
1
+ ---
2
+ description: Check for and apply MindForge framework updates in a safe, scope-preserving way.
3
+ ---
4
+ # MindForge — Update Command
5
+ # Usage: /mindforge:update [--apply] [--force] [--check] [--skip-changelog]
6
+
7
+ ## Purpose
8
+ Check for and apply MindForge framework updates in a safe, scope-preserving way.
9
+
10
+ ## Execution flow
11
+
12
+ ### 1. Version check
13
+ Execute `bin/updater/self-update.js` `checkAndUpdate()`.
14
+ Always show: current version, latest version, update type (major/minor/patch).
15
+
16
+ ### 2. Changelog display (unless --skip-changelog)
17
+ Fetch and display the relevant CHANGELOG.md section.
18
+ For major updates: prefix with ⚠️ BREAKING CHANGES notice.
19
+ Limit display to 3,000 characters — link to full CHANGELOG for the rest.
20
+
21
+ ### 3. Confirmation gate (unless --apply)
22
+ Without --apply: show update info, stop. Do not modify any files.
23
+ Message: "To apply this update: /mindforge:update --apply"
24
+
25
+ ### 4. Apply (with --apply)
26
+ a. Detect original install scope (local vs global, claude vs antigravity)
27
+ b. Read schema_version from HANDOFF.json (captures current version BEFORE update)
28
+ c. Run `npx mindforge-cc@[latest] --[runtime] --[scope]`
29
+ d. Run migration: `node bin/migrations/migrate.js` with captured schema_version
30
+ e. Run /mindforge:health to verify update succeeded
31
+
32
+ ### 5. Post-update health check
33
+ If health errors: surface them immediately with specific fix instructions.
34
+ Common post-update issue: CLAUDE.md and .agent/CLAUDE.md drifted → auto-repair.
35
+
36
+ ## Error scenarios and recovery
37
+
38
+ | Error | Recovery |
39
+ |---|---|
40
+ | npm registry unreachable | Message: "Check internet. Manual: npm info mindforge-cc version" |
41
+ | Update download fails | Retry once, then suggest manual: `npx mindforge-cc@latest` |
42
+ | Migration fails | Restored from backup automatically. Run /mindforge:migrate manually. |
43
+ | Install scope detection fails | Prompt user: "Is your install global or local?" |
44
+
45
+ ## AUDIT entry
@@ -0,0 +1,25 @@
1
+ ---
2
+ description: Audit the current phase for requirement coverage and test gaps
3
+ ---
4
+ <objective>
5
+ Audit a completed project phase to ensure every requirement has been addressed and that corresponding automated tests have been implemented and are passing.
6
+ </objective>
7
+
8
+ <execution_context>
9
+ .claude/commands/mindforge/validate-phase.md
10
+ </execution_context>
11
+
12
+ <context>
13
+ Arguments: $ARGUMENTS (The phase number [N], optional)
14
+ Knowledge: `STATE.md`, `REQUIREMENTS.md`, and the codebase test suite.
15
+ </context>
16
+
17
+ <process>
18
+ 1. **Identify Phase**: Resolve the targeted phase.
19
+ 2. **Cross-reference**:
20
+ - List all requirements in `REQUIREMENTS.md` marked for this phase.
21
+ - Verify implementation of each requirement in the code.
22
+ - Check for the existence of passing tests for each requirement.
23
+ 3. **Analyze Gaps**: Identify any "orphaned" requirements or features missing tests.
24
+ 4. **Report Findings**: Summarize coverage and call out specific gaps to the user.
25
+ </process>
@@ -0,0 +1,65 @@
1
+ ---
2
+ description: Human acceptance testing for a completed phase. Usage: /mindforge:verify-phase [N]
3
+ ---
4
+ Human acceptance testing for a completed phase. Usage: /mindforge:verify-phase [N]
5
+
6
+ ## Pre-check
7
+ `.planning/phases/[N]/VERIFICATION.md` must exist.
8
+ If it does not: instruct the user to run /mindforge:execute-phase [N] first.
9
+
10
+ ## Step 1 — Extract testable deliverables
11
+ Read REQUIREMENTS.md and the phase PLAN files.
12
+ Generate a list of testable deliverables — things the user can actually check.
13
+
14
+ Format each as a clear, actionable test instruction:
15
+ "Navigate to /login and submit a form with a valid email and password.
16
+ You should be redirected to /dashboard within 2 seconds."
17
+
18
+ ## Step 2 — Walk through each deliverable
19
+ Present one at a time. After each:
20
+ "Please test this now and tell me: pass ✅ or fail ❌ — and describe what you saw."
21
+
22
+ Wait for the user's response before proceeding to the next.
23
+
24
+ ## Step 3 — Handle failures
25
+ If the user reports a failure:
26
+ 1. Ask: "What exactly happened? (error message, wrong behaviour, nothing happened)"
27
+ 2. Spawn a debug subagent with: the failure description, the relevant PLAN file,
28
+ and the relevant source files. Instruct it to find the root cause.
29
+ 3. Create a fix plan: `.planning/phases/[N]/FIX-PLAN-[N]-[NN].md`
30
+ using the same XML format as regular plans.
31
+ 4. Ask the user: "Fix plan created. Run /mindforge:execute-phase [N] again
32
+ to apply the fixes?"
33
+
34
+ ## Step 4 — Write UAT record
35
+ Write `.planning/phases/[N]/UAT.md`:
36
+
37
+ ```markdown
38
+ # UAT — Phase [N]
39
+
40
+ ## Tester
41
+ [User name or "developer"]
42
+
43
+ ## Date
44
+ [ISO 8601 date]
45
+
46
+ ## Results
47
+
48
+ | # | Deliverable | Result | Notes |
49
+ |---|------------------------------------|--------|------------------------|
50
+ | 1 | [description] | ✅ | [what was observed] |
51
+ | 2 | [description] | ❌ | [what went wrong] |
52
+
53
+ ## Overall status
54
+ All passed ✅ / Issues found — fix plans created ❌
55
+
56
+ ## Sign-off
57
+ [Passed / Pending fixes]
58
+ ```
59
+
60
+ ## Step 5 — Update state if all pass
61
+ If all deliverables pass:
62
+ Update STATE.md: phase N = verified and signed off.
63
+ Tell the user:
64
+ "✅ Phase [N] verified and signed off.
65
+ Run /mindforge:ship [N] to create the release PR."
@@ -0,0 +1,32 @@
1
+ ---
2
+ description: Monorepo workspace management.
3
+ ---
4
+ # MindForge — Workspace Command
5
+ # Usage: /mindforge:workspace [detect|list|plan phase N|test]
6
+
7
+ Monorepo workspace management.
8
+
9
+ ## detect
10
+ Run workspace detector from `.mindforge/monorepo/workspace-detector.md`.
11
+ Write WORKSPACE-MANIFEST.json.
12
+ Report: workspace type, packages found, dependency order.
13
+
14
+ ## list
15
+ Read WORKSPACE-MANIFEST.json and display package list:
16
+ ```
17
+ Workspace: Turborepo (4 packages)
18
+ packages/shared → @myapp/shared (lib, 0 dependents)
19
+ apps/api → @myapp/api (api, depends on: shared)
20
+ apps/web → @myapp/web (web, depends on: shared, api)
21
+ apps/mobile → @myapp/mobile (mobile, depends on: shared)
22
+ Execution order: shared → api → (web, mobile in parallel)
23
+ ```
24
+
25
+ ## plan phase N
26
+ Create a phase plan that spans multiple packages.
27
+ Uses cross-package-planner.md to determine package execution order.
28
+ Each PLAN file includes a `<package>` and `<working-dir>` field.
29
+
30
+ ## test
31
+ Run tests across all packages in dependency order.
32
+ Report per-package test results and aggregate coverage.
@@ -0,0 +1,27 @@
1
+ ---
2
+ description: Manage parallel feature tracks with isolated state
3
+ ---
4
+ <objective>
5
+ Enable developers to work on multiple features or bugs concurrently within the same codebase without state collision. Provides isolated tracking for each "workstream".
6
+ </objective>
7
+
8
+ <execution_context>
9
+ .claude/commands/mindforge/workstreams.md
10
+ </execution_context>
11
+
12
+ <context>
13
+ Arguments: $ARGUMENTS (Switch subcommand)
14
+ Storage: .planning/workstreams/
15
+ State: Each workstream maintains its own subset of `STATE.md` or a local context file.
16
+ </context>
17
+
18
+ <process>
19
+ 1. **Route Subcommand**:
20
+ - `list`: Show all active and archived workstreams in `.planning/workstreams/`.
21
+ - `create <name>`: Initialize a new workstream directory and baseline state.
22
+ - `switch <name>`: Update the global pointer in `STATE.md` to the targeted workstream.
23
+ - `status`: Show the current active workstream and its progress.
24
+ 2. **Manage Isolation**:
25
+ - When switching, ensure current work is saved or stashed if necessary.
26
+ 3. **Confirm**: Success/Failure status message to user.
27
+ </process>
package/.claude/CLAUDE.md CHANGED
@@ -569,3 +569,17 @@ After every phase that passes all gates:
569
569
  - /mindforge:marketplace — discover and install community skills
570
570
 
571
571
  ---
572
+
573
+
574
+ ## 🧠 Knowledge Context (Auto-loaded)
575
+ 🧠 Knowledge Base — 5 relevant memories loaded:
576
+ Preferences : 1
577
+ Code patterns: 1
578
+ Domain : 3
579
+ ### Team Preferences
580
+ - [90% confidence] Use Tailwind: Always use Tailwind for CSS.
581
+
582
+ ### Domain Knowledge
583
+ - Auth with JWT: Secure JWT with httpOnly cookies.
584
+ - Global Tip: Always fix lints.
585
+ - Database SQL: Use indexed columns for fast queries.
@@ -0,0 +1,11 @@
1
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
2
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":false,"deprecated_by":null}
3
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":true,"deprecated_by":null,"deprecated_reason":"Switching to Vanilla CSS","deprecated_at":"2026-03-22T17:25:37.666Z"}
4
+ {"id":"a2d4b3a6-fdaa-4c9a-b654-286d9ea133e2","timestamp":"2026-03-22T17:25:37.670Z","type":"domain_knowledge","topic":"Auth with JWT","content":"Secure JWT with httpOnly cookies.","source":"manual","project":"[Project Name]","confidence":0.8,"tags":["auth"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
5
+ {"id":"6c1f0f31-3903-4b95-bae8-5473ffbec9eb","timestamp":"2026-03-22T17:25:37.671Z","type":"domain_knowledge","topic":"Database SQL","content":"Use indexed columns for fast queries.","source":"manual","project":"[Project Name]","confidence":0.7,"tags":["db"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
6
+ {"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.6,"tags":["ui"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
7
+ {"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
8
+ {"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.286Z","deprecated":false,"deprecated_by":null}
9
+ {"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.65,"tags":["ui"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.297Z","deprecated":false,"deprecated_by":null}
10
+ {"id":"a2d4b3a6-fdaa-4c9a-b654-286d9ea133e2","timestamp":"2026-03-22T17:25:37.670Z","type":"domain_knowledge","topic":"Auth with JWT","content":"Secure JWT with httpOnly cookies.","source":"manual","project":"[Project Name]","confidence":0.8500000000000001,"tags":["auth"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.298Z","deprecated":false,"deprecated_by":null}
11
+ {"id":"6c1f0f31-3903-4b95-bae8-5473ffbec9eb","timestamp":"2026-03-22T17:25:37.671Z","type":"domain_knowledge","topic":"Database SQL","content":"Use indexed columns for fast queries.","source":"manual","project":"[Project Name]","confidence":0.75,"tags":["db"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.299Z","deprecated":false,"deprecated_by":null}
@@ -0,0 +1,2 @@
1
+ {"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.6,"tags":["ui"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
2
+ {"id":"a9878977-cb7c-4dcf-8161-760ffd5e7de9","timestamp":"2026-03-22T17:25:37.673Z","type":"code_pattern","topic":"React Memo","content":"Use React.memo to prevent re-renders.","source":"manual","project":"[Project Name]","confidence":0.65,"tags":["ui"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.297Z","deprecated":false,"deprecated_by":null}
@@ -0,0 +1,5 @@
1
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
2
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":false,"deprecated_by":null}
3
+ {"id":"34a7925f-7361-4836-91eb-916495033861","timestamp":"2026-03-22T17:25:37.659Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-22T17:25:37.665Z","deprecated":true,"deprecated_by":null,"deprecated_reason":"Switching to Vanilla CSS","deprecated_at":"2026-03-22T17:25:37.666Z"}
4
+ {"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9,"tags":["ui","css"],"linked_adrs":[],"times_referenced":0,"last_referenced":null,"deprecated":false,"deprecated_by":null}
5
+ {"id":"739dcb0a-9c4b-40d2-846b-535b7e4cb274","timestamp":"2026-03-22T17:25:51.782Z","type":"team_preference","topic":"Use Tailwind","content":"Always use Tailwind for CSS.","source":"manual","project":"[Project Name]","confidence":0.9500000000000001,"tags":["ui","css"],"linked_adrs":[],"times_referenced":1,"last_referenced":"2026-03-25T17:42:57.286Z","deprecated":false,"deprecated_by":null}
@@ -1 +1 @@
1
- {"timestamp":"2026-03-22T20:52:21.691Z","event":"skill_installed","skill_name":"security-owasp","skill_version":"1.2.0","tier":2,"source":"cli-system","validation_passed":true}
1
+ {"event":"INIT","date":"2026-03-25T00:00:00Z","summary":"MindForge Project Initialized"}
@@ -1,28 +1,8 @@
1
1
  {
2
- "schema_version": "1.0.0",
3
- "project": null,
4
- "phase": null,
5
- "plan": null,
6
- "plan_step": null,
7
- "last_completed_task": {
8
- "description": null,
9
- "commit_sha": null,
10
- "verified": null
11
- },
12
- "next_task": "Run /mindforge:init-project",
13
- "in_progress": {
14
- "file": null,
15
- "intent": null,
16
- "completed_steps": [],
17
- "remaining_steps": []
18
- },
19
- "blockers": [],
20
- "decisions_needed": [],
21
- "context_refs": [],
22
- "agent_notes": "",
23
- "session_summary": "",
24
- "recent_files": [],
25
- "recent_commits": [],
26
- "updated_at": null,
27
- "_warning": "Never store secrets, tokens, or passwords in this file. It is tracked in git."
2
+ "_warning": "DO NOT ADD SECRETS OR SENSITIVE DATA TO THIS FILE. IT IS SYNCED ACROSS SESSIONS.",
3
+ "schema_type": "HANDOFF",
4
+ "schema_version": "2.0.0",
5
+ "handoffs": [],
6
+ "current_context": "",
7
+ "last_updated": "2026-03-25T00:00:00Z"
28
8
  }
@@ -1,5 +1,6 @@
1
+ # MindForge Roadmap
1
2
 
2
- ### Phase 1: Migrate GSD to MindForge
3
+ ### Phase 1: MindForge Enterprise Stabilization
3
4
 
4
5
  **Goal:** [To be planned]
5
6
  **Requirements**: TBD
@@ -7,4 +8,5 @@
7
8
  **Plans:** 0 plans
8
9
 
9
10
  Plans:
11
+
10
12
  - [ ] TBD (run /mindforge-plan-phase 1 to break down)
@@ -1,9 +1,5 @@
1
1
  {
2
- "schema_version": "1.0.0",
3
- "last_sync": null,
4
- "project_key": null,
5
- "phase_mappings": {},
6
- "transition_cache": {},
7
- "security_bugs": [],
8
- "_warning": "Do not store credentials in this file."
2
+ "sync_status": "idle",
3
+ "last_sync": "",
4
+ "mappings": []
9
5
  }
File without changes
File without changes
File without changes
@@ -1,6 +1,3 @@
1
1
  {
2
- "schema_version": "1.0.0",
3
- "channel_id": null,
4
- "threads": {},
5
- "_warning": "Do not store tokens in this file."
2
+ "threads": []
6
3
  }