mindforge-cc 2.0.0-alpha.9 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/.agent/CLAUDE.md +26 -0
  2. package/.agent/mindforge/add-backlog.md +32 -0
  3. package/.agent/mindforge/agent.md +31 -0
  4. package/.agent/mindforge/do.md +31 -0
  5. package/.agent/mindforge/execute-phase.md +23 -0
  6. package/.agent/mindforge/install-skill.md +20 -11
  7. package/.agent/mindforge/learn.md +142 -0
  8. package/.agent/mindforge/marketplace.md +120 -0
  9. package/.agent/mindforge/new-runtime.md +19 -0
  10. package/.agent/mindforge/note.md +35 -0
  11. package/.agent/mindforge/plant-seed.md +31 -0
  12. package/.agent/mindforge/remember.md +16 -4
  13. package/.agent/mindforge/review-backlog.md +34 -0
  14. package/.agent/mindforge/session-report.md +39 -0
  15. package/.agent/mindforge/ui-phase.md +34 -0
  16. package/.agent/mindforge/ui-review.md +36 -0
  17. package/.agent/mindforge/validate-phase.md +31 -0
  18. package/.agent/mindforge/workstreams.md +35 -0
  19. package/.claude/CLAUDE.md +26 -0
  20. package/.claude/commands/mindforge/add-backlog.md +32 -0
  21. package/.claude/commands/mindforge/agent.md +31 -0
  22. package/.claude/commands/mindforge/approve.md +27 -15
  23. package/.claude/commands/mindforge/audit.md +30 -26
  24. package/.claude/commands/mindforge/auto.md +29 -18
  25. package/.claude/commands/mindforge/benchmark.md +26 -29
  26. package/.claude/commands/mindforge/browse.md +24 -22
  27. package/.claude/commands/mindforge/complete-milestone.md +28 -14
  28. package/.claude/commands/mindforge/costs.md +26 -9
  29. package/.claude/commands/mindforge/cross-review.md +27 -13
  30. package/.claude/commands/mindforge/dashboard.md +35 -98
  31. package/.claude/commands/mindforge/debug.md +34 -126
  32. package/.claude/commands/mindforge/discuss-phase.md +36 -138
  33. package/.claude/commands/mindforge/do.md +31 -0
  34. package/.claude/commands/mindforge/execute-phase.md +37 -167
  35. package/.claude/commands/mindforge/health.md +27 -17
  36. package/.claude/commands/mindforge/help.md +25 -19
  37. package/.claude/commands/mindforge/init-org.md +37 -131
  38. package/.claude/commands/mindforge/init-project.md +40 -155
  39. package/.claude/commands/mindforge/install-skill.md +32 -15
  40. package/.claude/commands/mindforge/learn.md +36 -0
  41. package/.claude/commands/mindforge/map-codebase.md +36 -298
  42. package/.claude/commands/mindforge/marketplace.md +33 -0
  43. package/.claude/commands/mindforge/metrics.md +29 -18
  44. package/.claude/commands/mindforge/migrate.md +33 -40
  45. package/.claude/commands/mindforge/milestone.md +35 -12
  46. package/.claude/commands/mindforge/new-runtime.md +29 -0
  47. package/.claude/commands/mindforge/next.md +34 -105
  48. package/.claude/commands/mindforge/note.md +35 -0
  49. package/.claude/commands/mindforge/plan-phase.md +34 -125
  50. package/.claude/commands/mindforge/plant-seed.md +31 -0
  51. package/.claude/commands/mindforge/plugins.md +30 -36
  52. package/.claude/commands/mindforge/pr-review.md +32 -41
  53. package/.claude/commands/mindforge/profile-team.md +26 -19
  54. package/.claude/commands/mindforge/publish-skill.md +28 -17
  55. package/.claude/commands/mindforge/qa.md +27 -12
  56. package/.claude/commands/mindforge/quick.md +35 -135
  57. package/.claude/commands/mindforge/release.md +27 -8
  58. package/.claude/commands/mindforge/remember.md +25 -10
  59. package/.claude/commands/mindforge/research.md +27 -9
  60. package/.claude/commands/mindforge/retrospective.md +28 -22
  61. package/.claude/commands/mindforge/review-backlog.md +34 -0
  62. package/.claude/commands/mindforge/review.md +37 -157
  63. package/.claude/commands/mindforge/security-scan.md +34 -233
  64. package/.claude/commands/mindforge/session-report.md +39 -0
  65. package/.claude/commands/mindforge/ship.md +34 -100
  66. package/.claude/commands/mindforge/skills.md +36 -141
  67. package/.claude/commands/mindforge/status.md +30 -104
  68. package/.claude/commands/mindforge/steer.md +25 -10
  69. package/.claude/commands/mindforge/sync-confluence.md +28 -9
  70. package/.claude/commands/mindforge/sync-jira.md +32 -12
  71. package/.claude/commands/mindforge/tokens.md +25 -6
  72. package/.claude/commands/mindforge/ui-phase.md +34 -0
  73. package/.claude/commands/mindforge/ui-review.md +36 -0
  74. package/.claude/commands/mindforge/update.md +33 -42
  75. package/.claude/commands/mindforge/validate-phase.md +31 -0
  76. package/.claude/commands/mindforge/verify-phase.md +30 -62
  77. package/.claude/commands/mindforge/workspace.md +28 -25
  78. package/.claude/commands/mindforge/workstreams.md +35 -0
  79. package/.mindforge/distribution/marketplace.md +53 -0
  80. package/.mindforge/org/skills/MANIFEST.md +1 -0
  81. package/.mindforge/personas/advisor-researcher.md +89 -0
  82. package/.mindforge/personas/analyst.md +112 -52
  83. package/.mindforge/personas/architect.md +100 -67
  84. package/.mindforge/personas/assumptions-analyzer-extend.md +87 -0
  85. package/.mindforge/personas/assumptions-analyzer.md +109 -0
  86. package/.mindforge/personas/codebase-mapper-extend.md +93 -0
  87. package/.mindforge/personas/codebase-mapper.md +770 -0
  88. package/.mindforge/personas/coverage-specialist.md +104 -0
  89. package/.mindforge/personas/debug-specialist.md +118 -52
  90. package/.mindforge/personas/debugger.md +97 -0
  91. package/.mindforge/personas/decision-architect.md +102 -0
  92. package/.mindforge/personas/developer.md +97 -85
  93. package/.mindforge/personas/executor.md +88 -0
  94. package/.mindforge/personas/integration-checker.md +92 -0
  95. package/.mindforge/personas/nyquist-auditor.md +84 -0
  96. package/.mindforge/personas/phase-researcher.md +107 -0
  97. package/.mindforge/personas/plan-checker.md +92 -0
  98. package/.mindforge/personas/planner.md +105 -0
  99. package/.mindforge/personas/project-researcher.md +99 -0
  100. package/.mindforge/personas/qa-engineer.md +113 -61
  101. package/.mindforge/personas/release-manager.md +102 -64
  102. package/.mindforge/personas/research-agent.md +108 -24
  103. package/.mindforge/personas/research-synthesizer.md +101 -0
  104. package/.mindforge/personas/roadmapper-extend.md +100 -0
  105. package/.mindforge/personas/roadmapper.md +103 -0
  106. package/.mindforge/personas/security-reviewer.md +114 -91
  107. package/.mindforge/personas/tech-writer.md +118 -51
  108. package/.mindforge/personas/ui-auditor.md +94 -0
  109. package/.mindforge/personas/ui-checker.md +89 -0
  110. package/.mindforge/personas/ui-researcher.md +99 -0
  111. package/.mindforge/personas/user-profiler.md +93 -0
  112. package/.mindforge/personas/verifier.md +101 -0
  113. package/.mindforge/production/production-checklist.md +34 -123
  114. package/.mindforge/skills-builder/auto-capture-protocol.md +88 -0
  115. package/.mindforge/skills-builder/learn-protocol.md +161 -0
  116. package/.mindforge/skills-builder/quality-scoring.md +120 -0
  117. package/.planning/AUDIT.jsonl +1 -0
  118. package/.planning/decisions/ADR-036-learn-command-docs-as-skill-source.md +26 -0
  119. package/.planning/decisions/ADR-037-auto-capture-frequency-threshold.md +26 -0
  120. package/.planning/decisions/ADR-038-skill-quality-minimum-60.md +27 -0
  121. package/CHANGELOG.md +78 -0
  122. package/MINDFORGE.md +11 -0
  123. package/README.md +80 -6
  124. package/bin/autonomous/auto-runner.js +12 -0
  125. package/bin/install.js +8 -2
  126. package/bin/installer-core.js +129 -26
  127. package/bin/migrations/1.0.0-to-2.0.0.js +115 -0
  128. package/bin/migrations/schema-versions.js +12 -0
  129. package/bin/mindforge-cli.js +35 -0
  130. package/bin/review/cross-review-engine.js +11 -0
  131. package/bin/skill-registry.js +167 -0
  132. package/bin/skill-validator.js +144 -0
  133. package/bin/skills-builder/learn-cli.js +57 -0
  134. package/bin/skills-builder/marketplace-cli.js +54 -0
  135. package/bin/skills-builder/marketplace-client.js +198 -0
  136. package/bin/skills-builder/pattern-detector.js +144 -0
  137. package/bin/skills-builder/skill-generator.js +258 -0
  138. package/bin/skills-builder/skill-registrar.js +107 -0
  139. package/bin/skills-builder/skill-scorer.js +263 -0
  140. package/bin/skills-builder/source-loader.js +268 -0
  141. package/docs/Context/Master-Context.md +6 -13
  142. package/docs/PERSONAS.md +611 -0
  143. package/docs/architecture/README.md +6 -1
  144. package/docs/architecture/adr-039-multi-runtime-support.md +20 -0
  145. package/docs/architecture/adr-040-additive-schema-migration.md +21 -0
  146. package/docs/architecture/adr-041-stable-runtime-interface-contract.md +20 -0
  147. package/docs/architecture/decision-records-index.md +3 -0
  148. package/docs/commands-reference.md +3 -0
  149. package/docs/mindforge-md-reference.md +4 -0
  150. package/docs/reference/commands.md +53 -43
  151. package/docs/skills-authoring-guide.md +29 -0
  152. package/docs/skills-publishing-guide.md +3 -2
  153. package/docs/testing-current-version.md +3 -3
  154. package/docs/upgrade.md +16 -2
  155. package/docs/user-guide.md +57 -8
  156. package/docs/usp-features.md +21 -6
  157. package/package.json +1 -1
@@ -1,104 +1,30 @@
1
- # MindForge — Status Command
2
- # Usage: /mindforge:status
3
-
4
- Display a rich dashboard of the current project state.
5
- Pull data from STATE.md, AUDIT.jsonl, REQUIREMENTS.md, and the phases directory.
6
-
7
- ## Dashboard sections
8
-
9
- ### Section 1 — Project header
10
- ```
11
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
12
- MindForge Status [Project Name]
13
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
14
- Last updated : [STATE.md last updated timestamp]
15
- Current phase: Phase [N] — [phase description]
16
- Status : [status from STATE.md]
17
- ```
18
-
19
- ### Section 2 — Phase progress
20
- ```
21
- Phase Progress
22
- ───────────────────────────────────────────────────────
23
- Phase 1 [████████████████████] 100% — Complete ✅
24
- Phase 2 [████████░░░░░░░░░░░░] 40% — In progress
25
- Phase 3 [░░░░░░░░░░░░░░░░░░░░] 0% Not started
26
- Phase 4 [░░░░░░░░░░░░░░░░░░░░] 0% Not started
27
- ```
28
- Calculate percentage from: tasks with SUMMARY files / total tasks in phase.
29
- Count ONLY SUMMARY files that contain `Status: Completed ✅` (or `Status` + `Completed`).
30
- Do not count failed tasks as progress.
31
- If VERIFICATION.md is missing for a phase: label it "In progress" not "0% verified".
32
-
33
- ### Section 3 — Requirements coverage
34
- Read REQUIREMENTS.md and count:
35
- - Total v1 requirements
36
- - Requirements with a passing test (from VERIFICATION.md files)
37
- - Requirements implemented but untested
38
- - Requirements not yet started
39
-
40
- ```
41
- Requirements (v1)
42
- ───────────────────────────────────────────────────────
43
- Total : [N]
44
- ✅ Done + tested : [N]
45
- ⚠️ Done, no test : [N]
46
- 🔴 Not started : [N]
47
- ```
48
-
49
- ### Section 4 — Recent activity (from AUDIT.jsonl)
50
- Read the last 10 entries from AUDIT.jsonl and display:
51
- ```
52
- Recent Activity
53
- ───────────────────────────────────────────────────────
54
- [timestamp] task_completed Plan 03: User API endpoints ✅
55
- [timestamp] task_completed Plan 02: Product model ✅
56
- [timestamp] task_started Plan 03: User API endpoints
57
- [timestamp] task_completed Plan 01: User model ✅
58
- [timestamp] context_compaction Phase 2, Plan 03 (72% context)
59
- ```
60
- If AUDIT.jsonl is empty or missing, display:
61
- ```
62
- Recent Activity
63
- ───────────────────────────────────────────────────────
64
- No activity logged yet. Activity will appear here
65
- after running /mindforge:execute-phase.
66
- ```
67
-
68
- ### Section 5 — Open issues
69
- Check for:
70
- - Any open SECURITY-REVIEW files with CRITICAL or HIGH findings
71
- - Any BUGS.md files with open issues
72
- - Any failed tasks in WAVE-REPORT files
73
- - Any blockers in STATE.md
74
-
75
- ```
76
- Open Issues
77
- ───────────────────────────────────────────────────────
78
- 🔴 CRITICAL: [if any — from SECURITY-REVIEW]
79
- 🟠 HIGH: [if any]
80
- ✅ No open issues
81
- ```
82
-
83
- ### Section 6 — Next action
84
- ```
85
- Next Action
86
- ───────────────────────────────────────────────────────
87
- [What STATE.md says the next action is]
88
- Run: /mindforge:next
89
- to auto-execute the next step.
90
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
91
- ```
92
-
93
- ## Data sources (in priority order)
94
- 1. STATE.md — authoritative for current status
95
- 2. AUDIT.jsonl — authoritative for history
96
- 3. REQUIREMENTS.md — authoritative for scope
97
- 4. VERIFICATION.md files — authoritative for test coverage
98
- 5. WAVE-REPORT files — authoritative for execution history
99
- 6. HANDOFF.json — authoritative for session state
100
-
101
- ## Performance notes
102
- - For recent activity, read only the last 500 bytes of AUDIT.jsonl:
103
- `tail -c 500 .planning/AUDIT.jsonl | [parse last complete JSON objects]`
104
- - For requirement counts, count lines starting with `| FR-` instead of parsing the whole file.
1
+ ---
2
+ name: mindforge:status
3
+ description: Display a rich dashboard of the current project state
4
+ argument-hint: none
5
+ allowed-tools:
6
+ - list_dir
7
+ - view_file
8
+ - run_command
9
+ ---
10
+
11
+ <objective>
12
+ Provide a high-level visual summary of the project's health, progress, requirement coverage, and recent activity by synthesizing data from the `.planning/` directory.
13
+ </objective>
14
+
15
+ <execution_context>
16
+ .claude/commands/mindforge/status.md
17
+ </execution_context>
18
+
19
+ <context>
20
+ Sources: STATE.md, AUDIT.jsonl, REQUIREMENTS.md, and phase directories.
21
+ Focus: Real-time visibility into phase completion and open issues.
22
+ </context>
23
+
24
+ <process>
25
+ 1. **Gather Phase Data**: Read `STATE.md` and calculate progress percentage for active/planned phases.
26
+ 2. **Audit Requirements**: Count total, completed (verified), implemented (untested), and pending requirements from `REQUIREMENTS.md`.
27
+ 3. **Extract Recent Activity**: Parse the last few entries of `AUDIT.jsonl` (using efficient tail read).
28
+ 4. **Monitor Issues**: Check for critical security findings, open bugs, or execution blockers.
29
+ 5. **Render Dashboard**: Display the multi-section summary including header, progress bars, requirement counts, and activity logs.
30
+ </process>
@@ -1,13 +1,28 @@
1
- # /mindforge:steer "[instruction]"
1
+ ---
2
+ name: mindforge:steer
3
+ description: Inject mid-execution guidance into the running autonomous engine
4
+ argument-hint: "[instruction]"
5
+ allowed-tools:
6
+ - write_to_file
7
+ - view_file
8
+ ---
2
9
 
3
- **Purpose**: Injects mid-execution guidance into the running autonomous engine.
4
- Steering guidance is applied at the next task boundary to course-correct the agent.
10
+ <objective>
11
+ Provide a mechanism for human course-correction during long-running autonomous waves, allowing the user to redirect the agent's focus or update constraints without stopping the process.
12
+ </objective>
5
13
 
6
- ## Usage
7
- - `/mindforge:steer "Use the new logger in all created files"`
8
- - `/mindforge:steer --task 3-05 "This plan is too broad, focus on login only"`
9
- - `/mindforge:steer --cancel` (Clears the steering queue)
14
+ <execution_context>
15
+ .claude/commands/mindforge/steer.md
16
+ </execution_context>
10
17
 
11
- ## Precedence
12
- - Steering instructions take precedence over the original `PLAN-N-MM.md` actions.
13
- - Steering cannot override core security constraints or governance gates.
18
+ <context>
19
+ Lifecycle: Applied at the next task boundary in `/mindforge:auto` mode.
20
+ Priority: Steering takes precedence over the original `PLAN.md` instructions.
21
+ </context>
22
+
23
+ <process>
24
+ 1. **Queue Instruction**: Write the steering guidance to the active execution state.
25
+ 2. **Target (Optional)**: Explicitly target a future task ID for modification.
26
+ 3. **Validate**: Ensure steering does not violate core security or governance gates.
27
+ 4. **Cancel**: Clear the steering queue if instructions are no longer relevant.
28
+ </process>
@@ -1,11 +1,30 @@
1
- Publish approved planning artifacts to Confluence. Usage:
2
- `/mindforge:sync-confluence [--architecture] [--phase N] [--milestone name]`
1
+ ---
2
+ name: mindforge:sync-confluence
3
+ description: Publish approved planning artifacts to Confluence
4
+ argument-hint: [--architecture] [--phase N] [--milestone name]
5
+ allowed-tools:
6
+ - run_command
7
+ - view_file
8
+ - write_to_file
9
+ ---
3
10
 
4
- ## Behaviour
5
- - verify Confluence availability through `connection-manager.md`
6
- - publish idempotently by existing page title or page ID
7
- - never publish secrets, raw approval notes, or raw audit logs
8
- - log success, skip, or failure to AUDIT
11
+ <objective>
12
+ Automate the publication of key project documentation and architectural decisions to Confluence, providing a durable and searchable record for the broader organization.
13
+ </objective>
9
14
 
10
- Publishing failures are non-fatal and create a pending manual action in
11
- `STATE.md`.
15
+ <execution_context>
16
+ .claude/commands/mindforge/sync-confluence.md
17
+ </execution_context>
18
+
19
+ <context>
20
+ Auth: Managed via `connection-manager.md`.
21
+ Exclusion: Secrets, raw logs, and PII are strictly filtered before publication.
22
+ </context>
23
+
24
+ <process>
25
+ 1. **Assemble Content**: Gather target artifacts (ARCHITECTURE.md, Phase Plans, Milestone reports).
26
+ 2. **Filter & Sanitize**: Remove all sensitive data (passwords, tokens, raw audit trails).
27
+ 3. **Publish**: Update existing pages or create new ones in the specified Confluence space.
28
+ 4. **Indempotency**: Match pages by title or project-wide ID to avoid duplication.
29
+ 5. **Audit**: Log publication success or skipped files.
30
+ </process>
@@ -1,12 +1,32 @@
1
- Synchronise MindForge phase and plan metadata to Jira. Usage:
2
- `/mindforge:sync-jira [--phase N] [--plan M]`
3
-
4
- ## Behaviour
5
- - verify Jira availability through `connection-manager.md`
6
- - create or update Epic and Story mappings in `.planning/jira-sync.json`
7
- - use dynamic transition lookup, never hardcoded IDs
8
- - preserve manual Jira edits
9
- - log all actions to AUDIT
10
-
11
- Integration failures are non-fatal and should be written to `STATE.md` for
12
- manual retry.
1
+ ---
2
+ name: mindforge:sync-jira
3
+ description: Synchronize MindForge phase and plan metadata to Jira
4
+ argument-hint: [--phase N] [--plan M]
5
+ allowed-tools:
6
+ - run_command
7
+ - view_file
8
+ - write_to_file
9
+ ---
10
+
11
+ <objective>
12
+ Maintain parity between local MindForge planning state and the enterprise Jira issue tracker, ensuring stakeholders have visibility into phase progress and task status.
13
+ </objective>
14
+
15
+ <execution_context>
16
+ .claude/commands/mindforge/sync-jira.md
17
+ </execution_context>
18
+
19
+ <context>
20
+ Metadata: .planning/jira-sync.json
21
+ Auth: Managed via `connection-manager.md`.
22
+ Resilience: Failures are non-fatal; state is logged in `STATE.md` for retry.
23
+ </context>
24
+
25
+ <process>
26
+ 1. **Verify Connection**: Ensure Jira API availability and auth tokens are valid.
27
+ 2. **Resolve Mappings**: Map Phase and Plan IDs to Jira Epics and Stories.
28
+ 3. **Transition Issues**: Update Jira statuses based on verification results (e.g., Verified -> Done).
29
+ 4. **Sync Content**: Push plan descriptions and requirements to the relevant Jira tickets.
30
+ 5. **Preserve Manual Edits**: Avoid overwriting manual comments or fields in Jira.
31
+ 6. **Audit**: Log the sync event with counts of updated and created tickets.
32
+ </process>
@@ -1,8 +1,27 @@
1
- # MindForge — Token Usage Command
2
- # Usage: /mindforge:tokens [--phase N] [--session ID] [--window short|medium|long] [--optimise]
1
+ ---
2
+ name: mindforge:tokens
3
+ description: Analyze token consumption profile and efficiency
4
+ argument-hint: [--phase N] [--session ID] [--window short|medium|long] [--optimise]
5
+ allowed-tools:
6
+ - view_file
7
+ - run_command
8
+ ---
3
9
 
4
- ## Purpose
5
- Display token consumption profile and efficiency analysis.
6
- Helps identify where tokens are being spent and how to reduce waste.
10
+ <objective>
11
+ Deeply analyze how tokens are being consumed across the project to identify waste, improve prompt efficiency, and optimize context budgeting.
12
+ </objective>
7
13
 
8
- ## Default output (no flags — last 5 sessions)
14
+ <execution_context>
15
+ .claude/commands/mindforge/tokens.md
16
+ </execution_context>
17
+
18
+ <context>
19
+ Analysis Focus: Input vs Output tokens, cache hits/misses, compaction efficiency.
20
+ </context>
21
+
22
+ <process>
23
+ 1. **Fetch Profiles**: Read token usage data for the specified scope.
24
+ 2. **Identify Waste**: Detect large, repetitive context injections or missed cache opportunities.
25
+ 3. **Optimization Advice**: If `--optimise` is set, provide specific recommendations (e.g., "Summarize ARCHITECTURE.md to save 2k tokens/session").
26
+ 4. **Report**: Display the token consumption profile and efficiency score.
27
+ </process>
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: mindforge:ui-phase
3
+ description: Generate a UI Design Contract (UI-SPEC.md) for the current phase
4
+ argument-hint: [N]
5
+ allowed-tools:
6
+ - view_file
7
+ - write_to_file
8
+ - list_dir
9
+ ---
10
+
11
+ <objective>
12
+ 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.
13
+ </objective>
14
+
15
+ <execution_context>
16
+ .claude/commands/mindforge/ui-phase.md
17
+ </execution_context>
18
+
19
+ <context>
20
+ Arguments: $ARGUMENTS (The phase number [N], optional)
21
+ Configuration: MINDFORGE.md `UI_PHASE_ACCESSIBILITY_STANDARD`
22
+ State: Resolves the phase from STATE.md if N is not provided.
23
+ </context>
24
+
25
+ <process>
26
+ 1. **Identify Phase**: Get the current or targeted phase number.
27
+ 2. **Read Inputs**: Read `REQUIREMENTS.md` and `DESIGN_SYSTEM.md`.
28
+ 3. **Generate UI-SPEC.md**:
29
+ - Define component-level spacing and layout for the phase.
30
+ - Specify required colors and typography from the design system.
31
+ - List accessibility requirements (WCAG level).
32
+ 4. **Finalize**: Write `UI-SPEC.md` to the phase's planning directory or the root `.planning/`.
33
+ 5. **Confirm**: Provide a link to the user for review.
34
+ </process>
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: mindforge:ui-review
3
+ description: Perform a retroactive visual audit of implemented UI against the DESIGN_SYSTEM.md and UI-SPEC.md
4
+ argument-hint: [N]
5
+ allowed-tools:
6
+ - view_file
7
+ - write_to_file
8
+ - read_browser_page
9
+ - open_browser_url
10
+ ---
11
+
12
+ <objective>
13
+ 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.
14
+ </objective>
15
+
16
+ <execution_context>
17
+ .claude/commands/mindforge/ui-review.md
18
+ </execution_context>
19
+
20
+ <context>
21
+ Arguments: $ARGUMENTS (The phase number [N], optional)
22
+ Sources: `DESIGN_SYSTEM.md`, `UI-SPEC.md`, and the live application UI.
23
+ </context>
24
+
25
+ <process>
26
+ 1. **Identify Target**: Determine the phase to review.
27
+ 2. **Audit Application**:
28
+ - Use the browser tool to inspect the implemented features.
29
+ - Compare against the `UI-SPEC.md` for spacing, colors, and layout.
30
+ - Audit for accessibility (ARIA labels, contrast, keyboard navigation).
31
+ 3. **Generate UI-REVIEW.md**:
32
+ - Grade each pillar (Layout, Color, Typography, etc.).
33
+ - List specific "Needs Work" items.
34
+ - Provide "Approved" status if all criteria are met.
35
+ 4. **Finalize**: Notify the user of the audit results.
36
+ </process>
@@ -1,42 +1,33 @@
1
- # MindForge — Update Command
2
- # Usage: /mindforge:update [--apply] [--force] [--check] [--skip-changelog]
3
-
4
- ## Purpose
5
- Check for and apply MindForge framework updates in a safe, scope-preserving way.
6
-
7
- ## Execution flow
8
-
9
- ### 1. Version check
10
- Execute `bin/updater/self-update.js` `checkAndUpdate()`.
11
- Always show: current version, latest version, update type (major/minor/patch).
12
-
13
- ### 2. Changelog display (unless --skip-changelog)
14
- Fetch and display the relevant CHANGELOG.md section.
15
- For major updates: prefix with ⚠️ BREAKING CHANGES notice.
16
- Limit display to 3,000 characters — link to full CHANGELOG for the rest.
17
-
18
- ### 3. Confirmation gate (unless --apply)
19
- Without --apply: show update info, stop. Do not modify any files.
20
- Message: "To apply this update: /mindforge:update --apply"
21
-
22
- ### 4. Apply (with --apply)
23
- a. Detect original install scope (local vs global, claude vs antigravity)
24
- b. Read schema_version from HANDOFF.json (captures current version BEFORE update)
25
- c. Run `npx mindforge-cc@[latest] --[runtime] --[scope]`
26
- d. Run migration: `node bin/migrations/migrate.js` with captured schema_version
27
- e. Run /mindforge:health to verify update succeeded
28
-
29
- ### 5. Post-update health check
30
- If health errors: surface them immediately with specific fix instructions.
31
- Common post-update issue: CLAUDE.md and .agent/CLAUDE.md drifted auto-repair.
32
-
33
- ## Error scenarios and recovery
34
-
35
- | Error | Recovery |
36
- |---|---|
37
- | npm registry unreachable | Message: "Check internet. Manual: npm info mindforge-cc version" |
38
- | Update download fails | Retry once, then suggest manual: `npx mindforge-cc@latest` |
39
- | Migration fails | Restored from backup automatically. Run /mindforge:migrate manually. |
40
- | Install scope detection fails | Prompt user: "Is your install global or local?" |
41
-
42
- ## AUDIT entry
1
+ ---
2
+ name: mindforge:update
3
+ description: Safely check for and apply MindForge framework updates
4
+ argument-hint: [--apply] [--force] [--check] [--skip-changelog]
5
+ allowed-tools:
6
+ - run_command
7
+ - view_file
8
+ - write_to_file
9
+ ---
10
+
11
+ <objective>
12
+ Keep the project's MindForge installation up to date with the latest features, bug fixes, and security patches while ensuring no data loss or architectural regression.
13
+ </objective>
14
+
15
+ <execution_context>
16
+ .claude/commands/mindforge/update.md
17
+ </execution_context>
18
+
19
+ <context>
20
+ Platform: bin/updater/self-update.js
21
+ Scope: Local vs. Global detection.
22
+ Security: Enforces schema migration during the update process.
23
+ </context>
24
+
25
+ <process>
26
+ 1. **Check**: Query the registry for the latest version and compare with the current installation.
27
+ 2. **Changelog**: Display relevant updates, highlighting **BREAKING CHANGES** for major versions.
28
+ 3. **Pre-update State**: Capture the `schema_version` from HANDOFF.json.
29
+ 4. **Apply**: If `--apply` is set, download and install the new version into the detected scope.
30
+ 5. **Migrate**: Run `/mindforge:migrate` to reconcile the project schema with the new framework version.
31
+ 6. **Verify**: Run `/mindforge:health` to confirm the update succeeded without introducing errors.
32
+ 7. **Audit**: Log `update_completed` with the jump range (X.Y.Z -> A.B.C).
33
+ </process>
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: mindforge:validate-phase
3
+ description: Audit the current phase for requirement coverage and test gaps
4
+ argument-hint: [N]
5
+ allowed-tools:
6
+ - view_file
7
+ - list_dir
8
+ ---
9
+
10
+ <objective>
11
+ Audit a completed project phase to ensure every requirement has been addressed and that corresponding automated tests have been implemented and are passing.
12
+ </objective>
13
+
14
+ <execution_context>
15
+ .claude/commands/mindforge/validate-phase.md
16
+ </execution_context>
17
+
18
+ <context>
19
+ Arguments: $ARGUMENTS (The phase number [N], optional)
20
+ Knowledge: `STATE.md`, `REQUIREMENTS.md`, and the codebase test suite.
21
+ </context>
22
+
23
+ <process>
24
+ 1. **Identify Phase**: Resolve the targeted phase.
25
+ 2. **Cross-reference**:
26
+ - List all requirements in `REQUIREMENTS.md` marked for this phase.
27
+ - Verify implementation of each requirement in the code.
28
+ - Check for the existence of passing tests for each requirement.
29
+ 3. **Analyze Gaps**: Identify any "orphaned" requirements or features missing tests.
30
+ 4. **Report Findings**: Summarize coverage and call out specific gaps to the user.
31
+ </process>
@@ -1,62 +1,30 @@
1
- Human acceptance testing for a completed phase. Usage: /mindforge:verify-phase [N]
2
-
3
- ## Pre-check
4
- `.planning/phases/[N]/VERIFICATION.md` must exist.
5
- If it does not: instruct the user to run /mindforge:execute-phase [N] first.
6
-
7
- ## Step 1 — Extract testable deliverables
8
- Read REQUIREMENTS.md and the phase PLAN files.
9
- Generate a list of testable deliverables — things the user can actually check.
10
-
11
- Format each as a clear, actionable test instruction:
12
- "Navigate to /login and submit a form with a valid email and password.
13
- You should be redirected to /dashboard within 2 seconds."
14
-
15
- ## Step 2 — Walk through each deliverable
16
- Present one at a time. After each:
17
- "Please test this now and tell me: pass ✅ or fail ❌ — and describe what you saw."
18
-
19
- Wait for the user's response before proceeding to the next.
20
-
21
- ## Step 3 — Handle failures
22
- If the user reports a failure:
23
- 1. Ask: "What exactly happened? (error message, wrong behaviour, nothing happened)"
24
- 2. Spawn a debug subagent with: the failure description, the relevant PLAN file,
25
- and the relevant source files. Instruct it to find the root cause.
26
- 3. Create a fix plan: `.planning/phases/[N]/FIX-PLAN-[N]-[NN].md`
27
- using the same XML format as regular plans.
28
- 4. Ask the user: "Fix plan created. Run /mindforge:execute-phase [N] again
29
- to apply the fixes?"
30
-
31
- ## Step 4 — Write UAT record
32
- Write `.planning/phases/[N]/UAT.md`:
33
-
34
- ```markdown
35
- # UAT — Phase [N]
36
-
37
- ## Tester
38
- [User name or "developer"]
39
-
40
- ## Date
41
- [ISO 8601 date]
42
-
43
- ## Results
44
-
45
- | # | Deliverable | Result | Notes |
46
- |---|------------------------------------|--------|------------------------|
47
- | 1 | [description] | ✅ | [what was observed] |
48
- | 2 | [description] | ❌ | [what went wrong] |
49
-
50
- ## Overall status
51
- All passed ✅ / Issues found — fix plans created ❌
52
-
53
- ## Sign-off
54
- [Passed / Pending fixes]
55
- ```
56
-
57
- ## Step 5 — Update state if all pass
58
- If all deliverables pass:
59
- Update STATE.md: phase N = verified and signed off.
60
- Tell the user:
61
- "✅ Phase [N] verified and signed off.
62
- Run /mindforge:ship [N] to create the release PR."
1
+ ---
2
+ name: mindforge:verify-phase
3
+ description: Human acceptance testing (UAT) for a completed phase
4
+ argument-hint: [N]
5
+ allowed-tools:
6
+ - view_file
7
+ - write_to_file
8
+ ---
9
+
10
+ <objective>
11
+ Conduct a structured User Acceptance Testing (UAT) session for a completed phase, gathering human feedback on deliverables and identifying any required fixes.
12
+ </objective>
13
+
14
+ <execution_context>
15
+ .claude/commands/mindforge/verify-phase.md
16
+ </execution_context>
17
+
18
+ <context>
19
+ Arguments: $ARGUMENTS (Phase N)
20
+ Prerequisite: .planning/phases/[N]/VERIFICATION.md must exist.
21
+ Output: .planning/phases/[N]/UAT.md
22
+ </context>
23
+
24
+ <process>
25
+ 1. **Extract Deliverables**: Read requirements and plans to generate a list of checkable instructions for the user.
26
+ 2. **Interactive Walkthrough**: Present deliverables one at a time and ask the user for Pass/Fail status and observations.
27
+ 3. **Handle Failures**: If a task fails, spawn a debug subagent and create a `FIX-PLAN-[N]-[NN].md`.
28
+ 4. **Record Results**: Write `UAT.md` capturing testers, dates, results per deliverable, and overall sign-off status.
29
+ 5. **Update State**: If all pass, mark phase as verified in `STATE.md` and guide the user to `/mindforge:ship`.
30
+ </process>
@@ -1,29 +1,32 @@
1
- # MindForge — Workspace Command
2
- # Usage: /mindforge:workspace [detect|list|plan phase N|test]
1
+ ---
2
+ name: mindforge:workspace
3
+ description: Manage monorepo workspaces and cross-package dependencies
4
+ argument-hint: [detect|list|plan phase N|test]
5
+ allowed-tools:
6
+ - run_command
7
+ - list_dir
8
+ - view_file
9
+ - write_to_file
10
+ ---
3
11
 
4
- Monorepo workspace management.
12
+ <objective>
13
+ Enable seamless development within monorepo environments by detecting package structures, managing cross-package dependencies, and coordinating multi-package phase planning and testing.
14
+ </objective>
5
15
 
6
- ## detect
7
- Run workspace detector from `.mindforge/monorepo/workspace-detector.md`.
8
- Write WORKSPACE-MANIFEST.json.
9
- Report: workspace type, packages found, dependency order.
16
+ <execution_context>
17
+ .claude/commands/mindforge/workspace.md
18
+ </execution_context>
10
19
 
11
- ## list
12
- Read WORKSPACE-MANIFEST.json and display package list:
13
- ```
14
- Workspace: Turborepo (4 packages)
15
- packages/shared → @myapp/shared (lib, 0 dependents)
16
- apps/api → @myapp/api (api, depends on: shared)
17
- apps/web → @myapp/web (web, depends on: shared, api)
18
- apps/mobile → @myapp/mobile (mobile, depends on: shared)
19
- Execution order: shared → api → (web, mobile in parallel)
20
- ```
20
+ <context>
21
+ Metadata: WORKSPACE-MANIFEST.json
22
+ Engine: workspace-detector.md, cross-package-planner.md
23
+ Subcommands: detect, list, plan, test.
24
+ </context>
21
25
 
22
- ## plan phase N
23
- Create a phase plan that spans multiple packages.
24
- Uses cross-package-planner.md to determine package execution order.
25
- Each PLAN file includes a `<package>` and `<working-dir>` field.
26
-
27
- ## test
28
- Run tests across all packages in dependency order.
29
- Report per-package test results and aggregate coverage.
26
+ <process>
27
+ 1. **Detect**: Run the workspace detector to identify the monorepo type and generate `WORKSPACE-MANIFEST.json`.
28
+ 2. **List**: Present a structured view of all packages, their types, and dependency relationships.
29
+ 3. **Plan**: Generate a phase plan that spans multiple packages, ensuring execution follows the correct dependency order.
30
+ 4. **Test**: Execute the test suite for all packages in the correct topological order and aggregate results.
31
+ 5. **Confirm**: Update the user on workspace health and detected configurations.
32
+ </process>