mindforge-cc 11.9.0 → 11.9.2

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 (201) hide show
  1. package/.agent/mindforge/consult.md +1 -1
  2. package/.agent/mindforge/cost-report.md +1 -1
  3. package/.agent/mindforge/ship.md +2 -2
  4. package/.agent/mindforge/update.md +1 -1
  5. package/.agent/mindforge/wf-catalog.md +5 -2
  6. package/.claude/commands/mindforge/consult.md +1 -1
  7. package/.claude/commands/mindforge/cost-report.md +1 -1
  8. package/.claude/commands/mindforge/ship.md +2 -2
  9. package/.claude/commands/mindforge/skill-tdd.md +53 -0
  10. package/.claude/commands/mindforge/skills-index.md +118 -0
  11. package/.claude/commands/mindforge/systematic-debug.md +60 -0
  12. package/.claude/commands/mindforge/update.md +1 -1
  13. package/.claude/commands/mindforge/wf-accessibility-audit.md +31 -0
  14. package/.claude/commands/mindforge/wf-ai-model-eval.md +31 -0
  15. package/.claude/commands/mindforge/wf-api-migration.md +31 -0
  16. package/.claude/commands/mindforge/wf-architecture-modernization.md +32 -0
  17. package/.claude/commands/mindforge/wf-catalog.md +62 -0
  18. package/.claude/commands/mindforge/wf-code-audit.md +31 -0
  19. package/.claude/commands/mindforge/wf-code-explainer.md +31 -0
  20. package/.claude/commands/mindforge/wf-competitive-analysis.md +31 -0
  21. package/.claude/commands/mindforge/wf-competitive-teardown.md +31 -0
  22. package/.claude/commands/mindforge/wf-cost-analysis.md +31 -0
  23. package/.claude/commands/mindforge/wf-data-pipeline-validate.md +31 -0
  24. package/.claude/commands/mindforge/wf-database-migration.md +31 -0
  25. package/.claude/commands/mindforge/wf-debug-detective.md +32 -0
  26. package/.claude/commands/mindforge/wf-design-system-audit.md +31 -0
  27. package/.claude/commands/mindforge/wf-documentation-gen.md +31 -0
  28. package/.claude/commands/mindforge/wf-feature-planner.md +31 -0
  29. package/.claude/commands/mindforge/wf-incident-response.md +31 -0
  30. package/.claude/commands/mindforge/wf-multi-repo-sync.md +31 -0
  31. package/.claude/commands/mindforge/wf-mutation-testing.md +31 -0
  32. package/.claude/commands/mindforge/wf-onboard-codebase.md +31 -0
  33. package/.claude/commands/mindforge/wf-orchestrate-review.md +35 -0
  34. package/.claude/commands/mindforge/wf-perf-optimize.md +31 -0
  35. package/.claude/commands/mindforge/wf-pr-review.md +31 -0
  36. package/.claude/commands/mindforge/wf-refactor-plan.md +31 -0
  37. package/.claude/commands/mindforge/wf-release-prep.md +31 -0
  38. package/.claude/commands/mindforge/wf-security-threat-model.md +31 -0
  39. package/.claude/commands/mindforge/wf-tdd-sprint.md +31 -0
  40. package/.claude/commands/mindforge/wf-tech-evaluation.md +31 -0
  41. package/.claude/commands/mindforge/wf-ux-heuristic-audit.md +31 -0
  42. package/.claude/commands/mindforge/wf-verification-loop.md +45 -0
  43. package/.claude/commands/mindforge/wf-workflow-optimizer.md +51 -0
  44. package/.claude/commands/mindforge/wf-writer-reviewer.md +30 -0
  45. package/.mindforge/MINDFORGE-SCHEMA.json +126 -13
  46. package/.mindforge/config.json +3 -3
  47. package/.mindforge/engine/cost-tracking/router.md +1 -1
  48. package/.mindforge/engine/cost-tracking/token-ledger.md +21 -24
  49. package/.mindforge/memory/sync-manifest.json +1 -1
  50. package/.mindforge/metrics/METRICS-SCHEMA.md +13 -4
  51. package/.mindforge/personas/cost-optimizer.md +2 -2
  52. package/.mindforge/personas/doc-auditor.md +1 -1
  53. package/.mindforge/personas/monorepo-architect.md +2 -1
  54. package/.mindforge/personas/multi-model-bridge.md +1 -1
  55. package/.mindforge/personas/release-manager.md +5 -3
  56. package/.mindforge/skills/cost-aware-routing/SKILL.md +3 -3
  57. package/.mindforge/skills/documentation/SKILL.md +4 -1
  58. package/.mindforge/skills/multi-llm-consult/SKILL.md +2 -2
  59. package/CHANGELOG.md +216 -1821
  60. package/MINDFORGE.md +4 -4
  61. package/README.md +103 -509
  62. package/RELEASENOTES.md +75 -0
  63. package/SECURITY.md +1 -1
  64. package/bin/autonomous/audit-writer.js +48 -33
  65. package/bin/dashboard/api-router.js +11 -10
  66. package/bin/dashboard/error-response.js +44 -0
  67. package/bin/dashboard/frontend/index.html +20 -3
  68. package/bin/dashboard/metrics-aggregator.js +29 -8
  69. package/bin/dashboard/revops-api.js +12 -2
  70. package/bin/dashboard/server.js +85 -5
  71. package/bin/dashboard/temporal-api.js +11 -5
  72. package/bin/engine/remediation-engine.js +12 -1
  73. package/bin/engine/temporal-hub.js +41 -9
  74. package/bin/eval/eval-harness.js +212 -1
  75. package/bin/eval/golden-set-retrieval.json +9 -0
  76. package/bin/governance/policy-engine.js +8 -0
  77. package/bin/hindsight-injector.js +8 -2
  78. package/bin/hooks/instinct-capture-hook.js +7 -1
  79. package/bin/install.js +1 -1
  80. package/bin/learning/instinct-cli.js +7 -24
  81. package/bin/memory/knowledge-capture.js +23 -3
  82. package/bin/memory/knowledge-graph.js +70 -31
  83. package/bin/memory/vector-hub.js +304 -31
  84. package/bin/mindforge-cli.js +43 -11
  85. package/bin/models/cost-tracker.js +22 -23
  86. package/bin/models/model-router.js +28 -7
  87. package/bin/models/usage-record.js +71 -0
  88. package/bin/updater/changelog-fetcher.js +95 -5
  89. package/bin/utils/file-lock.js +106 -0
  90. package/bin/utils/mindforge-params.js +124 -0
  91. package/bin/utils/readiness-gate.js +3 -3
  92. package/bin/validate-config.js +34 -16
  93. package/changelogs/README.md +109 -0
  94. package/changelogs/index.json +103 -0
  95. package/changelogs/v0.1.0.md +21 -0
  96. package/changelogs/v0.2.0.md +15 -0
  97. package/changelogs/v0.3.0.md +28 -0
  98. package/changelogs/v0.4.0.md +29 -0
  99. package/changelogs/v0.5.0.md +34 -0
  100. package/changelogs/v0.6.0.md +34 -0
  101. package/changelogs/v1.0.0.md +60 -0
  102. package/changelogs/v1.0.1.md +15 -0
  103. package/changelogs/v1.0.2.md +10 -0
  104. package/changelogs/v1.0.3.md +10 -0
  105. package/changelogs/v1.0.4.md +10 -0
  106. package/changelogs/v1.0.5.md +10 -0
  107. package/changelogs/v10.0.0.md +71 -0
  108. package/changelogs/v10.0.2.md +15 -0
  109. package/changelogs/v10.0.3.md +21 -0
  110. package/changelogs/v10.0.4.md +16 -0
  111. package/changelogs/v10.0.5.md +16 -0
  112. package/changelogs/v10.0.6.md +15 -0
  113. package/changelogs/v10.0.7.md +15 -0
  114. package/changelogs/v10.0.8.md +15 -0
  115. package/changelogs/v10.0.9.md +15 -0
  116. package/changelogs/v10.1.0.md +16 -0
  117. package/changelogs/v10.1.1.md +15 -0
  118. package/changelogs/v10.2.0.md +14 -0
  119. package/changelogs/v10.3.0.md +13 -0
  120. package/changelogs/v10.4.0.md +13 -0
  121. package/changelogs/v10.5.0.md +13 -0
  122. package/changelogs/v10.6.0.md +13 -0
  123. package/changelogs/v10.7.0.md +15 -0
  124. package/changelogs/v11.0.0.md +66 -0
  125. package/changelogs/v11.0.1.md +10 -0
  126. package/changelogs/v11.1.0.md +56 -0
  127. package/changelogs/v11.2.0.md +41 -0
  128. package/changelogs/v11.2.1.md +38 -0
  129. package/changelogs/v11.3.0.md +45 -0
  130. package/changelogs/v11.3.1.md +39 -0
  131. package/changelogs/v11.4.0.md +38 -0
  132. package/changelogs/v11.5.0.md +77 -0
  133. package/changelogs/v11.5.1.md +47 -0
  134. package/changelogs/v11.6.0.md +45 -0
  135. package/changelogs/v11.7.0.md +30 -0
  136. package/changelogs/v11.7.1.md +8 -0
  137. package/changelogs/v11.8.0.md +19 -0
  138. package/changelogs/v11.8.1.md +28 -0
  139. package/changelogs/v11.8.2.md +22 -0
  140. package/changelogs/v11.8.3.md +22 -0
  141. package/changelogs/v11.9.0.md +17 -0
  142. package/changelogs/v11.9.1.md +8 -0
  143. package/changelogs/v11.9.2.md +209 -0
  144. package/changelogs/v2.0.0-alpha.1.md +42 -0
  145. package/changelogs/v2.0.0-alpha.10.md +13 -0
  146. package/changelogs/v2.0.0-alpha.11.md +14 -0
  147. package/changelogs/v2.0.0-alpha.12.md +16 -0
  148. package/changelogs/v2.0.0-alpha.2.md +14 -0
  149. package/changelogs/v2.0.0-alpha.3.md +17 -0
  150. package/changelogs/v2.0.0-alpha.4.md +17 -0
  151. package/changelogs/v2.0.0-alpha.7.md +18 -0
  152. package/changelogs/v2.0.0-alpha.8.md +11 -0
  153. package/changelogs/v2.0.0-alpha.9.md +12 -0
  154. package/changelogs/v2.0.0.md +35 -0
  155. package/changelogs/v2.1.0.md +22 -0
  156. package/changelogs/v2.1.1.md +25 -0
  157. package/changelogs/v2.1.2.md +21 -0
  158. package/changelogs/v2.3.2.md +19 -0
  159. package/changelogs/v2.3.3.md +16 -0
  160. package/changelogs/v2.3.4.md +16 -0
  161. package/changelogs/v2.3.5.md +21 -0
  162. package/changelogs/v2.4.0.md +29 -0
  163. package/changelogs/v2.5.0.md +26 -0
  164. package/changelogs/v2.6.0.md +26 -0
  165. package/changelogs/v3.0.0.md +17 -0
  166. package/changelogs/v4.0.0.md +19 -0
  167. package/changelogs/v4.1.0.md +19 -0
  168. package/changelogs/v4.3.0.md +31 -0
  169. package/changelogs/v5.0.0-alpha.1.md +35 -0
  170. package/changelogs/v5.0.0-alpha.2.md +22 -0
  171. package/changelogs/v5.1.0.md +42 -0
  172. package/changelogs/v5.2.0.md +18 -0
  173. package/changelogs/v5.3.0.md +14 -0
  174. package/changelogs/v5.4.0.md +28 -0
  175. package/changelogs/v5.5.0.md +11 -0
  176. package/changelogs/v5.6.0.md +11 -0
  177. package/changelogs/v5.7.0.md +12 -0
  178. package/changelogs/v5.8.0.md +12 -0
  179. package/changelogs/v5.9.0.md +11 -0
  180. package/changelogs/v6.0.0-alpha.md +45 -0
  181. package/changelogs/v6.1.0-alpha.md +29 -0
  182. package/changelogs/v6.2.0-alpha.md +30 -0
  183. package/changelogs/v6.2.0.md +21 -0
  184. package/changelogs/v6.3.0.md +14 -0
  185. package/changelogs/v6.4.0.md +13 -0
  186. package/changelogs/v6.5.0.md +13 -0
  187. package/changelogs/v6.6.0.md +12 -0
  188. package/changelogs/v6.7.0.md +12 -0
  189. package/changelogs/v7.0.0.md +13 -0
  190. package/changelogs/v8.0.0.md +14 -0
  191. package/changelogs/v8.1.0.md +13 -0
  192. package/changelogs/v8.2.0.md +12 -0
  193. package/changelogs/v8.2.1.md +11 -0
  194. package/changelogs/v9.0.0.md +20 -0
  195. package/docs/References/config-reference.md +73 -14
  196. package/docs/commands-reference.md +12 -6
  197. package/docs/faq.md +3 -3
  198. package/docs/getting-started.md +28 -3
  199. package/docs/sdk-reference.md +1 -1
  200. package/docs/user-guide.md +2 -2
  201. package/package.json +5 -2
@@ -31,7 +31,7 @@ $ARGUMENTS
31
31
  - Identify divergence (models disagree — flag for user)
32
32
  - Identify novel insights (unique points from one model)
33
33
  7. **Present results** with clear attribution (which model said what).
34
- 8. Log consultation in token-ledger.jsonl (model, tokens, cost per call).
34
+ 8. Log consultation in token-usage.jsonl (model, tokens, cost per call).
35
35
  9. Report total cost of this consultation.
36
36
  10. Remind: "External opinions are advisory — user sovereignty applies."
37
37
  </process>
@@ -19,7 +19,7 @@ $ARGUMENTS
19
19
 
20
20
  <process>
21
21
  1. Parse flags: --window (time period, default: current session), --by-model, --by-task, --phase.
22
- 2. Read `.mindforge/metrics/token-ledger.jsonl` for the specified window.
22
+ 2. Read `.mindforge/metrics/token-usage.jsonl` for the specified window.
23
23
  3. **Compute totals:**
24
24
  - Total tokens (input, output, cached)
25
25
  - Total estimated cost (USD)
@@ -29,7 +29,7 @@ Generate a CHANGELOG.md entry following Keep a Changelog format:
29
29
  - [Security improvements]
30
30
  ```
31
31
 
32
- Prepend this to CHANGELOG.md.
32
+ Create changelogs/vX.Y.Z.md with the full entry. Prepend a matching entry to root CHANGELOG.md (trim oldest if rolling window > 10 entries).
33
33
 
34
34
  ## Step 2 — Run final quality gates
35
35
  Run all of the following and report results:
@@ -93,7 +93,7 @@ Generate a complete PR description:
93
93
 
94
94
  ## Step 4 — Commit and tag
95
95
  ```bash
96
- git add CHANGELOG.md
96
+ git add changelogs/vX.Y.Z.md CHANGELOG.md
97
97
  git commit -m "docs(changelog): add Phase [N] release notes"
98
98
  git push origin feat/mindforge-core-scaffold
99
99
  ```
@@ -15,7 +15,7 @@ Execute `bin/updater/self-update.js` `checkAndUpdate()`.
15
15
  Always show: current version, latest version, update type (major/minor/patch).
16
16
 
17
17
  ### 2. Changelog display (unless --skip-changelog)
18
- Fetch and display the relevant CHANGELOG.md section.
18
+ Fetch and display the relevant changelog section (root CHANGELOG.md rolling window covers the newest 10 versions; older versions are fetched from changelogs/vX.Y.Z.md via the changelog-fetcher.js fallback path).
19
19
  For major updates: prefix with ⚠️ BREAKING CHANGES notice.
20
20
  Limit display to 3,000 characters — link to full CHANGELOG for the rest.
21
21
 
@@ -1,9 +1,9 @@
1
1
  ---
2
- description: "Browse the MindForge dynamic workflow library — 32 pre-built multi-agent workflows across 5 tiers"
2
+ description: "Browse the MindForge dynamic workflow library — 35 pre-built multi-agent workflows across 5 tiers"
3
3
  ---
4
4
  # /mindforge:wf-catalog
5
5
 
6
- Browse and discover the MindForge **Dynamic Workflow Library** — 32 pre-built multi-agent workflows that run via Claude Code's Workflow tool.
6
+ Browse and discover the MindForge **Dynamic Workflow Library** — 35 pre-built multi-agent workflows that run via Claude Code's Workflow tool.
7
7
 
8
8
  ## Usage
9
9
  `/mindforge:wf-catalog` — show all workflows grouped by tier
@@ -30,6 +30,8 @@ Browse and discover the MindForge **Dynamic Workflow Library** — 32 pre-built
30
30
  - `/mindforge:wf-mutation-testing` — Mutant generator → parallel kill-test → score
31
31
  - `/mindforge:wf-code-explainer` — Structure → domain → architecture → narrative tour
32
32
  - `/mindforge:wf-design-system-audit` — 5-dimension parallel audit → consistency score
33
+ - `/mindforge:wf-orchestrate-review` — 4-lens panel (factual/domain/safety/style) → merged verdict
34
+ - `/mindforge:wf-verification-loop` — Implementer vs. scorer loop → re-attempts until score maxed
33
35
 
34
36
  **Ops** — Infrastructure and release workflows
35
37
  - `/mindforge:wf-incident-response` — Parallel investigation → RCA → postmortem
@@ -46,6 +48,7 @@ Browse and discover the MindForge **Dynamic Workflow Library** — 32 pre-built
46
48
  - `/mindforge:wf-documentation-gen` — Parallel doc gen → normalize → publish-ready
47
49
  - `/mindforge:wf-api-migration` — Breaking change detection → guide → compat matrix
48
50
  - `/mindforge:wf-data-pipeline-validate` — Stage-by-stage validation → quality gates
51
+ - `/mindforge:wf-workflow-optimizer` — Builder + scorer + optimizer → revises the process itself
49
52
 
50
53
  **Beast** — Compound workflows (5 phases, 8+ agents, adversarial verification)
51
54
  - `/mindforge:wf-security-hardening` — 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap
@@ -31,7 +31,7 @@ $ARGUMENTS
31
31
  - Identify divergence (models disagree — flag for user)
32
32
  - Identify novel insights (unique points from one model)
33
33
  7. **Present results** with clear attribution (which model said what).
34
- 8. Log consultation in token-ledger.jsonl (model, tokens, cost per call).
34
+ 8. Log consultation in token-usage.jsonl (model, tokens, cost per call).
35
35
  9. Report total cost of this consultation.
36
36
  10. Remind: "External opinions are advisory — user sovereignty applies."
37
37
  </process>
@@ -19,7 +19,7 @@ $ARGUMENTS
19
19
 
20
20
  <process>
21
21
  1. Parse flags: --window (time period, default: current session), --by-model, --by-task, --phase.
22
- 2. Read `.mindforge/metrics/token-ledger.jsonl` for the specified window.
22
+ 2. Read `.mindforge/metrics/token-usage.jsonl` for the specified window.
23
23
  3. **Compute totals:**
24
24
  - Total tokens (input, output, cached)
25
25
  - Total estimated cost (USD)
@@ -29,7 +29,7 @@ Generate a CHANGELOG.md entry following Keep a Changelog format:
29
29
  - [Security improvements]
30
30
  ```
31
31
 
32
- Prepend this to CHANGELOG.md.
32
+ Create changelogs/vX.Y.Z.md with the full entry. Prepend a matching entry to root CHANGELOG.md (trim oldest if rolling window > 10 entries).
33
33
 
34
34
  ## Step 2 — Run final quality gates
35
35
  Run all of the following and report results:
@@ -93,7 +93,7 @@ Generate a complete PR description:
93
93
 
94
94
  ## Step 4 — Commit and tag
95
95
  ```bash
96
- git add CHANGELOG.md
96
+ git add changelogs/vX.Y.Z.md CHANGELOG.md
97
97
  git commit -m "docs(changelog): add Phase [N] release notes"
98
98
  git push origin feat/mindforge-core-scaffold
99
99
  ```
@@ -0,0 +1,53 @@
1
+ ---
2
+ description: "Test-Driven Development — RED-GREEN-REFACTOR discipline. Write the failing test first, always."
3
+ ---
4
+
5
+ # MindForge — TDD Skill Command
6
+ # Usage: /mindforge:skill-tdd [feature or bug to implement]
7
+
8
+ Activates the test-driven development skill. The core rule: **if you didn't watch the test fail, you don't know if it tests the right thing.**
9
+
10
+ ## Activation
11
+
12
+ Load `.mindforge/skills/test-driven-development/SKILL.md` immediately.
13
+ Follow its RED-GREEN-REFACTOR cycle strictly for the full duration of this session.
14
+
15
+ ## The Cycle (non-negotiable)
16
+
17
+ ### RED — Write a failing test
18
+ 1. Identify the smallest next behavior to implement.
19
+ 2. Write one test that asserts that behavior.
20
+ 3. Run it — confirm it FAILS for the right reason (not a syntax error, not a missing import — the actual assertion fails).
21
+ 4. Do not proceed until the test fails correctly.
22
+
23
+ ### GREEN — Write minimal code to pass
24
+ 1. Write the simplest code that makes the test pass.
25
+ 2. No gold-plating, no extra features. Minimum viable.
26
+ 3. Run the test — it must pass.
27
+ 4. Run the full suite — no regressions.
28
+
29
+ ### REFACTOR — Clean up
30
+ 1. Improve code structure, naming, and clarity.
31
+ 2. Remove duplication.
32
+ 3. Tests stay green throughout — run after every change.
33
+
34
+ ## Mandatory gates
35
+
36
+ - **Never write code without a failing test.** Not for "obvious" cases, not for "quick" fixes, not for "trivial" implementations.
37
+ - **One cycle at a time.** Complete RED-GREEN-REFACTOR before starting the next behavior.
38
+ - **A passing test suite is always the starting state.** If tests are red when you begin, fix them first.
39
+
40
+ ## When the user asks for a feature
41
+
42
+ 1. Decompose into the smallest testable behavior.
43
+ 2. Start with the first RED step before writing any implementation.
44
+ 3. Repeat the cycle for each behavior.
45
+
46
+ ## When the user asks for a bug fix
47
+
48
+ 1. Write a failing test that reproduces the bug (this is your RED step).
49
+ 2. Confirm it fails.
50
+ 3. Fix the code (GREEN).
51
+ 4. Refactor if needed.
52
+
53
+ The bug test becomes the regression guard — it must remain in the suite permanently.
@@ -0,0 +1,118 @@
1
+ ---
2
+ description: "Browse all available skills by category — discover and activate any skill by name."
3
+ ---
4
+
5
+ # MindForge — Skills Index
6
+ # Usage: /mindforge:skills-index [optional: category or keyword filter]
7
+
8
+ Lists all skills available in this MindForge installation. Skills in the **Engine** tier activate automatically via trigger-matching. Skills in the **Extended** tier require explicit invocation.
9
+
10
+ ---
11
+
12
+ ## How to activate a skill
13
+
14
+ **Engine tier** (auto-triggers from `.mindforge/skills/`): Just describe the task — the skill-loader matches your request against each skill's `triggers:` field and loads the relevant skill automatically.
15
+
16
+ **Extended tier** (explicit from `.agent/skills/`): Ask Claude to "use the [skill-name] skill" or invoke it by name.
17
+
18
+ ---
19
+
20
+ ## Engine Tier Skills (auto-triggered)
21
+
22
+ ### Software Development
23
+ | Skill | Triggers |
24
+ |---|---|
25
+ | `systematic-debugging` | systematic debugging, root cause analysis, debug methodology, 4-phase debug |
26
+ | `test-driven-development` | TDD, red green refactor, write test first, test before code |
27
+ | `plan` | write a plan, plan mode, implementation plan, plan before coding |
28
+ | `simplify-code` | simplify code, clean up code, refactor for clarity, reduce complexity |
29
+ | `requesting-code-review` | request code review, code review protocol, review this PR |
30
+ | `spike` | technical spike, time-boxed spike, explore this problem |
31
+ | `subagent-driven-development` | subagent driven development, delegate to subagent, multi-agent implementation |
32
+ | `code-wiki` | code wiki, document codebase, knowledge wiki, explain codebase |
33
+
34
+ ### DevOps & Orchestration
35
+ | Skill | Triggers |
36
+ |---|---|
37
+ | `kanban-orchestrator` | kanban orchestrator, multi-agent kanban, decompose and route, orchestrate tasks |
38
+ | `kanban-worker` | kanban worker, pick up kanban task, complete kanban card |
39
+
40
+ ### GitHub Workflows
41
+ | Skill | Triggers |
42
+ |---|---|
43
+ | `github-code-review` | github code review, review PR, pull request review workflow |
44
+ | `github-pr-workflow` | github pr workflow, pull request lifecycle, open PR, merge PR |
45
+ | `github-issues` | github issues, create issue, manage issues, issue triage |
46
+ | `codebase-inspection` | codebase inspection, explore codebase, understand repository |
47
+
48
+ ### Research & Intelligence
49
+ | Skill | Triggers |
50
+ |---|---|
51
+ | `research-paper-writing` | research paper, academic paper, write paper, arxiv paper |
52
+ | `arxiv` | arxiv search, find papers, search arxiv, academic literature |
53
+ | `osint-investigation` | OSINT investigation, public records research, entity investigation |
54
+ | `domain-intel` | domain intelligence, investigate domain, domain research |
55
+ | `duckduckgo-search` | duckduckgo search, DDG search, web search |
56
+ | `scrapling` | scrape website, web scraping, extract web content |
57
+ | `blogwatcher` | monitor blog, watch blog, track blog updates |
58
+
59
+ ### Creative
60
+ | Skill | Triggers |
61
+ |---|---|
62
+ | `concept-diagrams` | concept diagram, educational diagram, SVG diagram, visual explanation |
63
+ | `creative-ideation` | creative ideation, brainstorm ideas, creative ideas, generate concepts |
64
+ | `pixel-art` | pixel art, create pixel art, sprite design |
65
+ | `meme-generation` | meme generation, create meme, generate meme |
66
+
67
+ ### Security
68
+ | Skill | Triggers |
69
+ |---|---|
70
+ | `web-pentest` | web penetration test, pentest this app, security test web app, OWASP test |
71
+ | `oss-forensics` | OSS forensics, open source forensics, supply chain audit |
72
+ | `sherlock` | sherlock, username investigation, find accounts, OSINT username |
73
+
74
+ ### Data & Tooling
75
+ | Skill | Triggers |
76
+ |---|---|
77
+ | `jupyter-live-kernel` | jupyter kernel, live jupyter, interactive notebook |
78
+ | `obsidian` | obsidian notes, obsidian vault, obsidian workflow |
79
+
80
+ ---
81
+
82
+ ## Extended Tier Skills (`.agent/skills/`, explicit activation)
83
+
84
+ ### Software Development
85
+ `node-inspect-debugger` · `python-debugpy` · `skill-authoring` · `rest-graphql-debug`
86
+
87
+ ### GitHub
88
+ `github-auth` · `github-repo-management`
89
+
90
+ ### DevOps
91
+ `docker-management` · `devops-cli` · `devops-watchers` · `pinggy-tunnel` · `s6-container-supervision`
92
+
93
+ ### Research
94
+ `llm-wiki` · `polymarket` · `parallel-cli`
95
+
96
+ ### Security
97
+ `godmode` · `1password-skill`
98
+
99
+ ### Creative
100
+ `hyperframes` · `article-illustrator` · `comic-creator` · `video-orchestrator`
101
+
102
+ ---
103
+
104
+ ## Usage examples
105
+
106
+ ```
107
+ "Debug this null pointer — use systematic debugging"
108
+ → Engine tier: systematic-debugging activates automatically
109
+
110
+ "I want to do TDD on this new auth module"
111
+ → Engine tier: test-driven-development activates automatically
112
+
113
+ "Use the docker-management skill to set up my containers"
114
+ → Extended tier: explicit invocation of docker-management
115
+
116
+ "Run an OSINT investigation on this company"
117
+ → Engine tier: osint-investigation activates automatically
118
+ ```
@@ -0,0 +1,60 @@
1
+ ---
2
+ description: "4-phase root cause debugging — understand the bug completely before attempting any fix."
3
+ ---
4
+
5
+ # MindForge — Systematic Debug Command
6
+ # Usage: /mindforge:systematic-debug [problem description]
7
+
8
+ Activates the systematic debugging skill. The iron law: **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST**. Symptom fixes are failure.
9
+
10
+ ## Activation
11
+
12
+ Load `.mindforge/skills/systematic-debugging/SKILL.md` immediately.
13
+ Follow its 4-phase protocol for the full duration of this session.
14
+
15
+ ## Phase 1 — Understand the Bug
16
+
17
+ Before touching any code:
18
+
19
+ 1. **Reproduce it.** Can you reproduce it in a minimal, isolated environment?
20
+ - If no: document what you tried. Ask the user for more context. Do not guess.
21
+ - If yes: record the exact reproduction steps.
22
+
23
+ 2. **Read the error completely.** Stack trace, logs, error message — read every line.
24
+
25
+ 3. **Identify the invariant.** What assumption is being violated? What should be true that isn't?
26
+
27
+ 4. **Map the control flow.** Trace the path from input to failure point.
28
+
29
+ **Output of Phase 1:** A written statement of the root cause hypothesis with evidence.
30
+
31
+ ## Phase 2 — Isolate the Root Cause
32
+
33
+ 1. Write a failing test that exercises exactly the broken invariant.
34
+ 2. Confirm the test fails for the right reason (not just any reason).
35
+ 3. Narrow scope: is the bug in this file? This function? This line?
36
+ 4. Check: is this a regression? Run `git log --oneline -20` on affected files.
37
+
38
+ **Gate:** Do not proceed to Phase 3 without a failing test that proves the bug.
39
+
40
+ ## Phase 3 — Fix
41
+
42
+ 1. Apply the minimal fix that restores the invariant.
43
+ 2. Do not fix adjacent issues or refactor — single responsibility per fix.
44
+ 3. Run the failing test — it must now pass.
45
+ 4. Run the full test suite — zero new failures allowed.
46
+
47
+ ## Phase 4 — Verify and Document
48
+
49
+ 1. Confirm the original reproduction steps no longer trigger the bug.
50
+ 2. Write a one-paragraph RCA summary: what was broken, why, how it was fixed.
51
+ 3. Commit with a message that explains the root cause, not the symptom.
52
+
53
+ ## When you cannot find the root cause
54
+
55
+ - Add logging/instrumentation at the point of failure.
56
+ - Form 2–3 competing hypotheses and test each independently.
57
+ - Document what you ruled out — negative evidence is evidence.
58
+ - Ask the user for additional context before guessing.
59
+
60
+ Do not apply a fix that "might work." Every fix requires a root cause explanation.
@@ -15,7 +15,7 @@ Execute `bin/updater/self-update.js` `checkAndUpdate()`.
15
15
  Always show: current version, latest version, update type (major/minor/patch).
16
16
 
17
17
  ### 2. Changelog display (unless --skip-changelog)
18
- Fetch and display the relevant CHANGELOG.md section.
18
+ Fetch and display the relevant changelog section (root CHANGELOG.md rolling window covers the newest 10 versions; older versions are fetched from changelogs/vX.Y.Z.md via the changelog-fetcher.js fallback path).
19
19
  For major updates: prefix with ⚠️ BREAKING CHANGES notice.
20
20
  Limit display to 3,000 characters — link to full CHANGELOG for the rest.
21
21
 
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec"
3
+ ---
4
+ # /mindforge:wf-accessibility-audit
5
+
6
+ Runs the **Accessibility Audit** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-accessibility-audit <UI codebase path or component>`
10
+
11
+ ## What it does
12
+ - **Scope**: Define target UI and map components/pages to audit
13
+ - **Audit**: 6 parallel WCAG principle auditors (Perceivable/Operable/Understandable/Robust + ARIA + Keyboard)
14
+ - **Verify**: 3-vote adversarial verification of all Level A and AA failures
15
+ - **Spec**: Remediation spec with exact ARIA attributes, HTML fixes, and WCAG references
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/accessibility-audit.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info accessibility-audit
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "4-parallel model benchmark agents → scoring matrix → cost/performance recommendation"
3
+ ---
4
+ # /mindforge:wf-ai-model-eval
5
+
6
+ Runs the **AI Model Evaluation** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-ai-model-eval <use case description>`
10
+
11
+ ## What it does
12
+ - **Scope**: Define evaluation criteria and test prompts for the use case
13
+ - **Benchmark**: 4 parallel model evaluators (quality / reasoning / speed / cost)
14
+ - **Score**: Scoring matrix across all dimensions
15
+ - **Recommend**: Ranked recommendation with break-even cost analysis
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/ai-model-eval.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info ai-model-eval
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Breaking change detection → versioning strategy → migration guide → compatibility matrix"
3
+ ---
4
+ # /mindforge:wf-api-migration
5
+
6
+ Runs the **API Migration** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-api-migration <old API path or description of changes>`
10
+
11
+ ## What it does
12
+ - **Detect**: Detect breaking vs non-breaking changes between old and new API versions
13
+ - **Version**: Propose versioning strategy: semver, URL versioning, or header versioning
14
+ - **Guide**: Generate migration guide for API consumers
15
+ - **Matrix**: Compatibility matrix: which client versions work with which API versions
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/api-migration.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info api-migration
31
+ ```
@@ -0,0 +1,32 @@
1
+ ---
2
+ description: "Legacy architecture map → target design → migration sequencing → risk gates"
3
+ ---
4
+ # /mindforge:wf-architecture-modernization
5
+
6
+ Runs the **Architecture Modernization** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-architecture-modernization <codebase or modernization goal>`
10
+
11
+ ## What it does
12
+ - **Map**: Map current architecture: components, dependencies, coupling, pain points
13
+ - **Design**: 3 parallel target architecture proposals with trade-off analysis
14
+ - **Select**: Judge panel selects best design, synthesizes hybrid
15
+ - **Sequence**: Migration sequencing with risk gates and rollback checkpoints
16
+ - **Roadmap**: Sprint-by-sprint modernization roadmap
17
+
18
+ ## Running
19
+
20
+ Invoke via Claude Code's Workflow tool:
21
+
22
+ ```
23
+ Workflow({
24
+ scriptPath: ".mindforge/dynamic-workflows/scripts/architecture-modernization.js",
25
+ args: "<your input>"
26
+ })
27
+ ```
28
+
29
+ Or discover via CLI:
30
+ ```bash
31
+ node bin/mindforge-cli.js workflow info architecture-modernization
32
+ ```
@@ -0,0 +1,62 @@
1
+ ---
2
+ description: "Browse the MindForge dynamic workflow library — 35 pre-built multi-agent workflows across 5 tiers"
3
+ ---
4
+ # /mindforge:wf-catalog
5
+
6
+ Browse and discover the MindForge **Dynamic Workflow Library** — 35 pre-built multi-agent workflows that run via Claude Code's Workflow tool.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-catalog` — show all workflows grouped by tier
10
+
11
+ ## Tiers
12
+
13
+ **Research** — Fan-out search, adversarial verification, cited synthesis
14
+ - `/mindforge:wf-competitive-analysis` — SWOT and positioning summary
15
+ - `/mindforge:wf-tech-evaluation` — Scored technology comparison matrix
16
+ - `/mindforge:wf-ai-model-eval` — Benchmark AI models → scoring matrix → recommendation
17
+ - `/mindforge:wf-ux-heuristic-audit` — 10 Nielsen heuristics parallel audit → fix brief
18
+ - `/mindforge:wf-competitive-teardown` — 5 competitor angles → positioning report
19
+
20
+ **Dev** — Coding-assistant power workflows
21
+ - `/mindforge:wf-code-audit` — Parallel security + quality + performance audit
22
+ - `/mindforge:wf-feature-planner` — Brief → PRD → architecture → user stories
23
+ - `/mindforge:wf-pr-review` — 4-dimensional parallel PR review
24
+ - `/mindforge:wf-tdd-sprint` — Strict Red-Green-Refactor TDD loop
25
+ - `/mindforge:wf-refactor-plan` — Technical debt scan → safe refactor plan
26
+ - `/mindforge:wf-test-coverage-gap` — Per-module coverage analysis → test-writing plan
27
+ - `/mindforge:wf-api-contract-test` — Spec vs impl Writer/Reviewer → violation report
28
+ - `/mindforge:wf-debug-detective` — 4-hypothesis parallel investigation → scientific RCA
29
+ - `/mindforge:wf-writer-reviewer` — Implement → fresh context review → verdict
30
+ - `/mindforge:wf-mutation-testing` — Mutant generator → parallel kill-test → score
31
+ - `/mindforge:wf-code-explainer` — Structure → domain → architecture → narrative tour
32
+ - `/mindforge:wf-design-system-audit` — 5-dimension parallel audit → consistency score
33
+ - `/mindforge:wf-orchestrate-review` — 4-lens panel (factual/domain/safety/style) → merged verdict
34
+ - `/mindforge:wf-verification-loop` — Implementer vs. scorer loop → re-attempts until score maxed
35
+
36
+ **Ops** — Infrastructure and release workflows
37
+ - `/mindforge:wf-incident-response` — Parallel investigation → RCA → postmortem
38
+ - `/mindforge:wf-release-prep` — Tests → changelog → version bump → PR
39
+ - `/mindforge:wf-dependency-health` — CVE + license + staleness audit → risk matrix
40
+ - `/mindforge:wf-database-migration` — Schema diff → risk → scripts → runbook
41
+ - `/mindforge:wf-multi-repo-sync` — Per-repo audit → divergence map → sync plan
42
+ - `/mindforge:wf-cost-analysis` — Infra/API/query/bundle cost agents → ROI plan
43
+
44
+ **Intelligence** — Deep analysis and optimization
45
+ - `/mindforge:wf-onboard-codebase` — Map → domain → architecture → guided tour
46
+ - `/mindforge:wf-perf-optimize` — Profile → bottleneck hunt → prioritized fix plan
47
+ - `/mindforge:wf-architecture-modernization` — Legacy map → 3 designs → migration roadmap
48
+ - `/mindforge:wf-documentation-gen` — Parallel doc gen → normalize → publish-ready
49
+ - `/mindforge:wf-api-migration` — Breaking change detection → guide → compat matrix
50
+ - `/mindforge:wf-data-pipeline-validate` — Stage-by-stage validation → quality gates
51
+ - `/mindforge:wf-workflow-optimizer` — Builder + scorer + optimizer → revises the process itself
52
+
53
+ **Beast** — Compound workflows (5 phases, 8+ agents, adversarial verification)
54
+ - `/mindforge:wf-security-hardening` — 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap
55
+ - `/mindforge:wf-accessibility-audit` — WCAG 2.2 per-criterion → 3-vote verify → remediation spec
56
+ - `/mindforge:wf-security-threat-model` — Asset inventory → STRIDE x6 → mitigations → CVSS matrix
57
+
58
+ ## CLI Discovery
59
+ ```bash
60
+ node bin/mindforge-cli.js workflow list
61
+ node bin/mindforge-cli.js workflow info <name>
62
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Parallel security + quality + performance audit with adversarial finding verification"
3
+ ---
4
+ # /mindforge:wf-code-audit
5
+
6
+ Runs the **Code Audit** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-code-audit [path or 'current git diff']`
10
+
11
+ ## What it does
12
+ - **Scope**: Builds file list from git diff, specified path, or entire codebase
13
+ - **Audit**: 3 parallel auditors — OWASP security, code quality, performance patterns
14
+ - **Verify**: Adversarial 2-vote verification for all high/critical severity findings
15
+ - **Report**: Risk-ranked report with remediation steps for each confirmed finding
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/code-audit.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info code-audit
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Structural map → domain extraction → architecture patterns → guided narrative tour for onboarding"
3
+ ---
4
+ # /mindforge:wf-code-explainer
5
+
6
+ Runs the **Code Explainer** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-code-explainer <codebase path or module to explain>`
10
+
11
+ ## What it does
12
+ - **Structure**: Map file structure, entry points, and module boundaries
13
+ - **Domain**: Extract domain concepts, business logic, and key abstractions
14
+ - **Architecture**: Identify architectural patterns, data flow, and design decisions
15
+ - **Tour**: Synthesize a guided narrative tour for a new developer
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/code-explainer.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info code-explainer
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Multi-angle competitive research producing a SWOT and positioning summary"
3
+ ---
4
+ # /mindforge:wf-competitive-analysis
5
+
6
+ Runs the **Competitive Analysis** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-competitive-analysis <product/company/technology>`
10
+
11
+ ## What it does
12
+ - **Scope**: Defines the competitive landscape target
13
+ - **Research**: 5 parallel angles — product features, pricing, reviews, community, roadmap
14
+ - **SWOT**: Synthesizes strengths, weaknesses, opportunities, threats
15
+ - **Position**: Produces strategic positioning and differentiation recommendations
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/competitive-analysis.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info competitive-analysis
31
+ ```