mindforge-cc 9.0.0 → 10.0.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 (641) hide show
  1. package/.mindforge/config.json +1 -1
  2. package/CHANGELOG.md +15 -0
  3. package/LICENSE +1 -1
  4. package/MINDFORGE.md +13 -0
  5. package/README.md +7 -1
  6. package/bin/autonomous/audit-writer.js +90 -0
  7. package/bin/autonomous/auto-runner.js +209 -431
  8. package/bin/autonomous/state-manager.js +116 -0
  9. package/bin/autonomous/task-dispatcher.js +114 -0
  10. package/bin/autonomous/wave-executor.js +169 -0
  11. package/bin/browser/browser-daemon.js +31 -1
  12. package/bin/change-classifier.js +3 -3
  13. package/bin/dashboard/api-router.js +21 -22
  14. package/bin/dashboard/metrics-aggregator.js +44 -3
  15. package/bin/dashboard/server.js +54 -10
  16. package/bin/dashboard/sse-bridge.js +51 -5
  17. package/bin/engine/learning-manager.js +1 -1
  18. package/bin/engine/mesh-syncer.js +26 -22
  19. package/bin/engine/nexus-tracer.js +6 -5
  20. package/bin/engine/orbital-guardian.js +13 -10
  21. package/bin/engine/skill-evolver.js +12 -14
  22. package/bin/engine/temporal-hub.js +25 -1
  23. package/bin/governance/policy-engine.js +5 -5
  24. package/bin/governance/policy-gate-hardened.js +2 -2
  25. package/bin/governance/quantum-crypto.js +10 -2
  26. package/bin/memory/identity-synthesizer.js +9 -11
  27. package/bin/memory/knowledge-store.js +62 -6
  28. package/bin/memory/semantic-hub.js +26 -30
  29. package/bin/memory/vector-hub.js +377 -193
  30. package/bin/migrations/v8-sqlite-migration.js +22 -21
  31. package/bin/migrations/v9-unified-memory.js +1 -1
  32. package/bin/mindforge-cli.js +47 -11
  33. package/bin/models/model-broker.js +2 -0
  34. package/bin/revops/remediation-queue.js +16 -55
  35. package/bin/utils/errors.js +40 -0
  36. package/bin/utils/file-io.js +102 -0
  37. package/bin/utils/index.js +6 -0
  38. package/bin/utils/paths.js +33 -0
  39. package/docs/sdk-reference.md +374 -24
  40. package/docs/troubleshooting.md +4 -4
  41. package/examples/sdk-integration/README.md +24 -0
  42. package/examples/sdk-integration/index.js +24 -0
  43. package/examples/starter-project/MINDFORGE.md +8 -8
  44. package/package.json +25 -14
  45. package/.agent/bin/lib/commands.cjs +0 -959
  46. package/.agent/bin/lib/config.cjs +0 -421
  47. package/.agent/bin/lib/core.cjs +0 -1166
  48. package/.agent/bin/lib/frontmatter.cjs +0 -307
  49. package/.agent/bin/lib/init.cjs +0 -1336
  50. package/.agent/bin/lib/milestone.cjs +0 -252
  51. package/.agent/bin/lib/model-profiles.cjs +0 -68
  52. package/.agent/bin/lib/phase.cjs +0 -888
  53. package/.agent/bin/lib/profile-output.cjs +0 -952
  54. package/.agent/bin/lib/profile-pipeline.cjs +0 -539
  55. package/.agent/bin/lib/roadmap.cjs +0 -329
  56. package/.agent/bin/lib/security.cjs +0 -356
  57. package/.agent/bin/lib/state.cjs +0 -969
  58. package/.agent/bin/lib/template.cjs +0 -222
  59. package/.agent/bin/lib/uat.cjs +0 -189
  60. package/.agent/bin/lib/verify.cjs +0 -851
  61. package/.agent/bin/lib/workstream.cjs +0 -491
  62. package/.agent/bin/mindforge-tools.cjs +0 -897
  63. package/.agent/file-manifest.json +0 -219
  64. package/.agent/forge/help.md +0 -11
  65. package/.agent/forge/init-project.md +0 -36
  66. package/.agent/forge/plan-phase.md +0 -34
  67. package/.agent/mindforge/add-backlog.md +0 -32
  68. package/.agent/mindforge/agent.md +0 -31
  69. package/.agent/mindforge/approve.md +0 -22
  70. package/.agent/mindforge/audit.md +0 -34
  71. package/.agent/mindforge/auto.md +0 -26
  72. package/.agent/mindforge/benchmark.md +0 -37
  73. package/.agent/mindforge/browse.md +0 -30
  74. package/.agent/mindforge/complete-milestone.md +0 -22
  75. package/.agent/mindforge/costs.md +0 -15
  76. package/.agent/mindforge/cross-review.md +0 -21
  77. package/.agent/mindforge/dashboard.md +0 -102
  78. package/.agent/mindforge/debug.md +0 -133
  79. package/.agent/mindforge/discuss-phase.md +0 -142
  80. package/.agent/mindforge/do.md +0 -31
  81. package/.agent/mindforge/execute-phase.md +0 -200
  82. package/.agent/mindforge/health.md +0 -31
  83. package/.agent/mindforge/help.md +0 -33
  84. package/.agent/mindforge/init-org.md +0 -135
  85. package/.agent/mindforge/init-project.md +0 -170
  86. package/.agent/mindforge/install-skill.md +0 -28
  87. package/.agent/mindforge/learn.md +0 -147
  88. package/.agent/mindforge/learning.md +0 -20
  89. package/.agent/mindforge/map-codebase.md +0 -302
  90. package/.agent/mindforge/marketplace.md +0 -124
  91. package/.agent/mindforge/metrics.md +0 -26
  92. package/.agent/mindforge/migrate.md +0 -44
  93. package/.agent/mindforge/milestone.md +0 -16
  94. package/.agent/mindforge/new-runtime.md +0 -23
  95. package/.agent/mindforge/next.md +0 -109
  96. package/.agent/mindforge/note.md +0 -35
  97. package/.agent/mindforge/plan-phase.md +0 -131
  98. package/.agent/mindforge/plant-seed.md +0 -31
  99. package/.agent/mindforge/plugins.md +0 -44
  100. package/.agent/mindforge/pr-review.md +0 -45
  101. package/.agent/mindforge/profile-team.md +0 -27
  102. package/.agent/mindforge/publish-skill.md +0 -23
  103. package/.agent/mindforge/qa.md +0 -20
  104. package/.agent/mindforge/quick.md +0 -139
  105. package/.agent/mindforge/record-learning.md +0 -22
  106. package/.agent/mindforge/release.md +0 -14
  107. package/.agent/mindforge/remember.md +0 -30
  108. package/.agent/mindforge/research.md +0 -16
  109. package/.agent/mindforge/retrospective.md +0 -31
  110. package/.agent/mindforge/review-backlog.md +0 -34
  111. package/.agent/mindforge/review.md +0 -161
  112. package/.agent/mindforge/security-scan.md +0 -242
  113. package/.agent/mindforge/session-report.md +0 -39
  114. package/.agent/mindforge/ship.md +0 -111
  115. package/.agent/mindforge/skills.md +0 -145
  116. package/.agent/mindforge/status.md +0 -113
  117. package/.agent/mindforge/steer.md +0 -17
  118. package/.agent/mindforge/sync-confluence.md +0 -15
  119. package/.agent/mindforge/sync-jira.md +0 -16
  120. package/.agent/mindforge/tokens.md +0 -12
  121. package/.agent/mindforge/ui-phase.md +0 -34
  122. package/.agent/mindforge/ui-review.md +0 -36
  123. package/.agent/mindforge/update.md +0 -46
  124. package/.agent/mindforge/validate-phase.md +0 -31
  125. package/.agent/mindforge/verify-phase.md +0 -66
  126. package/.agent/mindforge/workspace.md +0 -33
  127. package/.agent/mindforge/workstreams.md +0 -35
  128. package/.agent/settings.json +0 -42
  129. package/.agent/skills/mindforge-add-backlog/SKILL.md +0 -72
  130. package/.agent/skills/mindforge-add-phase/SKILL.md +0 -39
  131. package/.agent/skills/mindforge-add-tests/SKILL.md +0 -28
  132. package/.agent/skills/mindforge-add-todo/SKILL.md +0 -42
  133. package/.agent/skills/mindforge-audit-milestone/SKILL.md +0 -29
  134. package/.agent/skills/mindforge-audit-uat/SKILL.md +0 -20
  135. package/.agent/skills/mindforge-autonomous/SKILL.md +0 -33
  136. package/.agent/skills/mindforge-brainstorming/SKILL.md +0 -164
  137. package/.agent/skills/mindforge-brainstorming/scripts/frame-template.html +0 -214
  138. package/.agent/skills/mindforge-brainstorming/scripts/helper.js +0 -88
  139. package/.agent/skills/mindforge-brainstorming/scripts/server.cjs +0 -354
  140. package/.agent/skills/mindforge-brainstorming/scripts/start-server.sh +0 -148
  141. package/.agent/skills/mindforge-brainstorming/scripts/stop-server.sh +0 -56
  142. package/.agent/skills/mindforge-brainstorming/spec-document-reviewer-prompt.md +0 -49
  143. package/.agent/skills/mindforge-brainstorming/visual-companion.md +0 -287
  144. package/.agent/skills/mindforge-check-todos/SKILL.md +0 -40
  145. package/.agent/skills/mindforge-cleanup/SKILL.md +0 -19
  146. package/.agent/skills/mindforge-complete-milestone/SKILL.md +0 -131
  147. package/.agent/skills/mindforge-debug/SKILL.md +0 -163
  148. package/.agent/skills/mindforge-debug_extended/CREATION-LOG.md +0 -119
  149. package/.agent/skills/mindforge-debug_extended/SKILL.md +0 -296
  150. package/.agent/skills/mindforge-debug_extended/condition-based-waiting-example.ts +0 -158
  151. package/.agent/skills/mindforge-debug_extended/condition-based-waiting.md +0 -115
  152. package/.agent/skills/mindforge-debug_extended/defense-in-depth.md +0 -122
  153. package/.agent/skills/mindforge-debug_extended/find-polluter.sh +0 -63
  154. package/.agent/skills/mindforge-debug_extended/root-cause-tracing.md +0 -169
  155. package/.agent/skills/mindforge-debug_extended/test-academic.md +0 -14
  156. package/.agent/skills/mindforge-debug_extended/test-pressure-1.md +0 -58
  157. package/.agent/skills/mindforge-debug_extended/test-pressure-2.md +0 -68
  158. package/.agent/skills/mindforge-debug_extended/test-pressure-3.md +0 -69
  159. package/.agent/skills/mindforge-discuss-phase/SKILL.md +0 -54
  160. package/.agent/skills/mindforge-do/SKILL.md +0 -26
  161. package/.agent/skills/mindforge-execute-phase/SKILL.md +0 -49
  162. package/.agent/skills/mindforge-execute-phase_extended/SKILL.md +0 -70
  163. package/.agent/skills/mindforge-fast/SKILL.md +0 -23
  164. package/.agent/skills/mindforge-forensics/SKILL.md +0 -49
  165. package/.agent/skills/mindforge-health/SKILL.md +0 -17
  166. package/.agent/skills/mindforge-help/SKILL.md +0 -23
  167. package/.agent/skills/mindforge-insert-phase/SKILL.md +0 -28
  168. package/.agent/skills/mindforge-join-discord/SKILL.md +0 -19
  169. package/.agent/skills/mindforge-list-phase-assumptions/SKILL.md +0 -41
  170. package/.agent/skills/mindforge-list-workspaces/SKILL.md +0 -17
  171. package/.agent/skills/mindforge-manager/SKILL.md +0 -32
  172. package/.agent/skills/mindforge-map-codebase/SKILL.md +0 -64
  173. package/.agent/skills/mindforge-milestone-summary/SKILL.md +0 -44
  174. package/.agent/skills/mindforge-neural-orchestrator/SKILL.md +0 -115
  175. package/.agent/skills/mindforge-neural-orchestrator/references/codex-tools.md +0 -100
  176. package/.agent/skills/mindforge-neural-orchestrator/references/gemini-tools.md +0 -33
  177. package/.agent/skills/mindforge-new-milestone/SKILL.md +0 -38
  178. package/.agent/skills/mindforge-new-project/SKILL.md +0 -36
  179. package/.agent/skills/mindforge-new-workspace/SKILL.md +0 -39
  180. package/.agent/skills/mindforge-next/SKILL.md +0 -19
  181. package/.agent/skills/mindforge-note/SKILL.md +0 -29
  182. package/.agent/skills/mindforge-parallel-mesh_extended/SKILL.md +0 -182
  183. package/.agent/skills/mindforge-pause-work/SKILL.md +0 -35
  184. package/.agent/skills/mindforge-plan-milestone-gaps/SKILL.md +0 -28
  185. package/.agent/skills/mindforge-plan-phase/SKILL.md +0 -38
  186. package/.agent/skills/mindforge-plan-phase_extended/SKILL.md +0 -152
  187. package/.agent/skills/mindforge-plan-phase_extended/plan-document-reviewer-prompt.md +0 -49
  188. package/.agent/skills/mindforge-plant-seed/SKILL.md +0 -22
  189. package/.agent/skills/mindforge-pr-branch/SKILL.md +0 -21
  190. package/.agent/skills/mindforge-profile-user/SKILL.md +0 -38
  191. package/.agent/skills/mindforge-progress/SKILL.md +0 -19
  192. package/.agent/skills/mindforge-quick/SKILL.md +0 -38
  193. package/.agent/skills/mindforge-reapply-patches/SKILL.md +0 -124
  194. package/.agent/skills/mindforge-remove-phase/SKILL.md +0 -26
  195. package/.agent/skills/mindforge-remove-workspace/SKILL.md +0 -22
  196. package/.agent/skills/mindforge-research-phase/SKILL.md +0 -186
  197. package/.agent/skills/mindforge-resume-work/SKILL.md +0 -35
  198. package/.agent/skills/mindforge-review/SKILL.md +0 -31
  199. package/.agent/skills/mindforge-review-backlog/SKILL.md +0 -58
  200. package/.agent/skills/mindforge-review-inbound/SKILL.md +0 -213
  201. package/.agent/skills/mindforge-review-request/SKILL.md +0 -105
  202. package/.agent/skills/mindforge-review-request/code-reviewer.md +0 -146
  203. package/.agent/skills/mindforge-session-report/SKILL.md +0 -16
  204. package/.agent/skills/mindforge-set-profile/SKILL.md +0 -9
  205. package/.agent/skills/mindforge-settings/SKILL.md +0 -32
  206. package/.agent/skills/mindforge-ship/SKILL.md +0 -16
  207. package/.agent/skills/mindforge-ship_extended/SKILL.md +0 -200
  208. package/.agent/skills/mindforge-skill-creation/SKILL.md +0 -655
  209. package/.agent/skills/mindforge-skill-creation/anthropic-best-practices.md +0 -1150
  210. package/.agent/skills/mindforge-skill-creation/examples/CLAUDE_MD_TESTING.md +0 -189
  211. package/.agent/skills/mindforge-skill-creation/graphviz-conventions.dot +0 -172
  212. package/.agent/skills/mindforge-skill-creation/persuasion-principles.md +0 -187
  213. package/.agent/skills/mindforge-skill-creation/render-graphs.js +0 -168
  214. package/.agent/skills/mindforge-skill-creation/testing-skills-with-subagents.md +0 -384
  215. package/.agent/skills/mindforge-stats/SKILL.md +0 -16
  216. package/.agent/skills/mindforge-swarm-execution/SKILL.md +0 -277
  217. package/.agent/skills/mindforge-swarm-execution/code-quality-reviewer-prompt.md +0 -26
  218. package/.agent/skills/mindforge-swarm-execution/implementer-prompt.md +0 -113
  219. package/.agent/skills/mindforge-swarm-execution/spec-reviewer-prompt.md +0 -61
  220. package/.agent/skills/mindforge-system-architecture/SKILL.md +0 -136
  221. package/.agent/skills/mindforge-system-architecture/examples.md +0 -120
  222. package/.agent/skills/mindforge-system-architecture/scaling-checklist.md +0 -76
  223. package/.agent/skills/mindforge-tdd/SKILL.md +0 -112
  224. package/.agent/skills/mindforge-tdd/deep-modules.md +0 -21
  225. package/.agent/skills/mindforge-tdd/interface-design.md +0 -22
  226. package/.agent/skills/mindforge-tdd/mocking.md +0 -24
  227. package/.agent/skills/mindforge-tdd/refactoring.md +0 -21
  228. package/.agent/skills/mindforge-tdd/tests.md +0 -28
  229. package/.agent/skills/mindforge-tdd_extended/SKILL.md +0 -371
  230. package/.agent/skills/mindforge-tdd_extended/testing-anti-patterns.md +0 -299
  231. package/.agent/skills/mindforge-thread/SKILL.md +0 -123
  232. package/.agent/skills/mindforge-ui-phase/SKILL.md +0 -24
  233. package/.agent/skills/mindforge-ui-review/SKILL.md +0 -24
  234. package/.agent/skills/mindforge-update/SKILL.md +0 -35
  235. package/.agent/skills/mindforge-validate-phase/SKILL.md +0 -26
  236. package/.agent/skills/mindforge-verify-work/SKILL.md +0 -30
  237. package/.agent/skills/mindforge-verify-work_extended/SKILL.md +0 -139
  238. package/.agent/skills/mindforge-workspace-isolated/SKILL.md +0 -218
  239. package/.agent/skills/mindforge-workstreams/SKILL.md +0 -65
  240. package/.agent/workflows/forge:help.md +0 -10
  241. package/.agent/workflows/forge:init-project.md +0 -35
  242. package/.agent/workflows/forge:plan-phase.md +0 -33
  243. package/.agent/workflows/mindforge-add-phase.md +0 -112
  244. package/.agent/workflows/mindforge-add-tests.md +0 -351
  245. package/.agent/workflows/mindforge-add-todo.md +0 -158
  246. package/.agent/workflows/mindforge-audit-milestone.md +0 -332
  247. package/.agent/workflows/mindforge-audit-uat.md +0 -109
  248. package/.agent/workflows/mindforge-autonomous.md +0 -815
  249. package/.agent/workflows/mindforge-check-todos.md +0 -177
  250. package/.agent/workflows/mindforge-cleanup.md +0 -152
  251. package/.agent/workflows/mindforge-complete-milestone.md +0 -766
  252. package/.agent/workflows/mindforge-diagnose-issues.md +0 -220
  253. package/.agent/workflows/mindforge-discovery-phase.md +0 -289
  254. package/.agent/workflows/mindforge-discuss-phase-assumptions.md +0 -645
  255. package/.agent/workflows/mindforge-discuss-phase.md +0 -1047
  256. package/.agent/workflows/mindforge-do.md +0 -104
  257. package/.agent/workflows/mindforge-execute-phase.md +0 -838
  258. package/.agent/workflows/mindforge-execute-plan.md +0 -509
  259. package/.agent/workflows/mindforge-fast.md +0 -105
  260. package/.agent/workflows/mindforge-forensics.md +0 -265
  261. package/.agent/workflows/mindforge-health.md +0 -181
  262. package/.agent/workflows/mindforge-help.md +0 -606
  263. package/.agent/workflows/mindforge-insert-phase.md +0 -130
  264. package/.agent/workflows/mindforge-list-phase-assumptions.md +0 -178
  265. package/.agent/workflows/mindforge-list-workspaces.md +0 -56
  266. package/.agent/workflows/mindforge-manager.md +0 -360
  267. package/.agent/workflows/mindforge-map-codebase.md +0 -370
  268. package/.agent/workflows/mindforge-milestone-summary.md +0 -223
  269. package/.agent/workflows/mindforge-new-milestone.md +0 -469
  270. package/.agent/workflows/mindforge-new-project.md +0 -1226
  271. package/.agent/workflows/mindforge-new-workspace.md +0 -237
  272. package/.agent/workflows/mindforge-next.md +0 -97
  273. package/.agent/workflows/mindforge-node-repair.md +0 -92
  274. package/.agent/workflows/mindforge-note.md +0 -156
  275. package/.agent/workflows/mindforge-pause-work.md +0 -176
  276. package/.agent/workflows/mindforge-plan-milestone-gaps.md +0 -273
  277. package/.agent/workflows/mindforge-plan-phase.md +0 -877
  278. package/.agent/workflows/mindforge-plant-seed.md +0 -169
  279. package/.agent/workflows/mindforge-pr-branch.md +0 -129
  280. package/.agent/workflows/mindforge-profile-user.md +0 -450
  281. package/.agent/workflows/mindforge-progress.md +0 -507
  282. package/.agent/workflows/mindforge-quick.md +0 -732
  283. package/.agent/workflows/mindforge-remove-phase.md +0 -155
  284. package/.agent/workflows/mindforge-remove-workspace.md +0 -90
  285. package/.agent/workflows/mindforge-research-phase.md +0 -74
  286. package/.agent/workflows/mindforge-resume-project.md +0 -325
  287. package/.agent/workflows/mindforge-review.md +0 -228
  288. package/.agent/workflows/mindforge-session-report.md +0 -146
  289. package/.agent/workflows/mindforge-settings.md +0 -283
  290. package/.agent/workflows/mindforge-ship.md +0 -228
  291. package/.agent/workflows/mindforge-stats.md +0 -60
  292. package/.agent/workflows/mindforge-transition.md +0 -671
  293. package/.agent/workflows/mindforge-ui-phase.md +0 -290
  294. package/.agent/workflows/mindforge-ui-review.md +0 -157
  295. package/.agent/workflows/mindforge-update.md +0 -323
  296. package/.agent/workflows/mindforge-validate-phase.md +0 -167
  297. package/.agent/workflows/mindforge-verify-phase.md +0 -254
  298. package/.agent/workflows/mindforge-verify-work.md +0 -628
  299. package/.agent/workflows/mindforge:add-backlog.md +0 -24
  300. package/.agent/workflows/mindforge:agent.md +0 -25
  301. package/.agent/workflows/mindforge:approve.md +0 -21
  302. package/.agent/workflows/mindforge:architecture.md +0 -40
  303. package/.agent/workflows/mindforge:audit.md +0 -33
  304. package/.agent/workflows/mindforge:auto.md +0 -25
  305. package/.agent/workflows/mindforge:benchmark.md +0 -36
  306. package/.agent/workflows/mindforge:brainstorming.md +0 -16
  307. package/.agent/workflows/mindforge:browse.md +0 -29
  308. package/.agent/workflows/mindforge:complete-milestone.md +0 -21
  309. package/.agent/workflows/mindforge:costs.md +0 -14
  310. package/.agent/workflows/mindforge:cross-review.md +0 -20
  311. package/.agent/workflows/mindforge:dashboard.md +0 -101
  312. package/.agent/workflows/mindforge:debug.md +0 -131
  313. package/.agent/workflows/mindforge:discuss-phase.md +0 -141
  314. package/.agent/workflows/mindforge:do.md +0 -25
  315. package/.agent/workflows/mindforge:execute-phase.md +0 -205
  316. package/.agent/workflows/mindforge:executor.md +0 -18
  317. package/.agent/workflows/mindforge:health.md +0 -24
  318. package/.agent/workflows/mindforge:help.md +0 -26
  319. package/.agent/workflows/mindforge:identity.md +0 -18
  320. package/.agent/workflows/mindforge:init-org.md +0 -134
  321. package/.agent/workflows/mindforge:init-project.md +0 -185
  322. package/.agent/workflows/mindforge:install-skill.md +0 -27
  323. package/.agent/workflows/mindforge:learn.md +0 -146
  324. package/.agent/workflows/mindforge:map-codebase.md +0 -301
  325. package/.agent/workflows/mindforge:marketplace.md +0 -123
  326. package/.agent/workflows/mindforge:memory.md +0 -18
  327. package/.agent/workflows/mindforge:metrics.md +0 -25
  328. package/.agent/workflows/mindforge:migrate.md +0 -43
  329. package/.agent/workflows/mindforge:milestone.md +0 -15
  330. package/.agent/workflows/mindforge:new-runtime.md +0 -22
  331. package/.agent/workflows/mindforge:next.md +0 -108
  332. package/.agent/workflows/mindforge:note.md +0 -27
  333. package/.agent/workflows/mindforge:plan-phase.md +0 -139
  334. package/.agent/workflows/mindforge:planner.md +0 -18
  335. package/.agent/workflows/mindforge:plant-seed.md +0 -24
  336. package/.agent/workflows/mindforge:plugins.md +0 -43
  337. package/.agent/workflows/mindforge:pr-review.md +0 -44
  338. package/.agent/workflows/mindforge:profile-team.md +0 -26
  339. package/.agent/workflows/mindforge:publish-skill.md +0 -22
  340. package/.agent/workflows/mindforge:qa.md +0 -19
  341. package/.agent/workflows/mindforge:quick.md +0 -138
  342. package/.agent/workflows/mindforge:release.md +0 -13
  343. package/.agent/workflows/mindforge:remember.md +0 -29
  344. package/.agent/workflows/mindforge:research.md +0 -15
  345. package/.agent/workflows/mindforge:researcher.md +0 -18
  346. package/.agent/workflows/mindforge:retrospective.md +0 -29
  347. package/.agent/workflows/mindforge:review-backlog.md +0 -26
  348. package/.agent/workflows/mindforge:review.md +0 -160
  349. package/.agent/workflows/mindforge:reviewer.md +0 -18
  350. package/.agent/workflows/mindforge:security-scan.md +0 -236
  351. package/.agent/workflows/mindforge:session-report.md +0 -31
  352. package/.agent/workflows/mindforge:ship.md +0 -108
  353. package/.agent/workflows/mindforge:skills.md +0 -144
  354. package/.agent/workflows/mindforge:soul.md +0 -54
  355. package/.agent/workflows/mindforge:status.md +0 -107
  356. package/.agent/workflows/mindforge:steer.md +0 -16
  357. package/.agent/workflows/mindforge:sync-confluence.md +0 -14
  358. package/.agent/workflows/mindforge:sync-jira.md +0 -15
  359. package/.agent/workflows/mindforge:tdd.md +0 -46
  360. package/.agent/workflows/mindforge:tokens.md +0 -11
  361. package/.agent/workflows/mindforge:tool.md +0 -18
  362. package/.agent/workflows/mindforge:ui-phase.md +0 -27
  363. package/.agent/workflows/mindforge:ui-review.md +0 -28
  364. package/.agent/workflows/mindforge:update.md +0 -45
  365. package/.agent/workflows/mindforge:validate-phase.md +0 -25
  366. package/.agent/workflows/mindforge:verify-phase.md +0 -65
  367. package/.agent/workflows/mindforge:workspace.md +0 -32
  368. package/.agent/workflows/mindforge:workstreams.md +0 -27
  369. package/.agent/workflows/publish-release.md +0 -36
  370. package/.claude/CLAUDE.md +0 -102
  371. package/.claude/commands/forge/help.md +0 -7
  372. package/.claude/commands/forge/init-project.md +0 -32
  373. package/.claude/commands/forge/plan-phase.md +0 -30
  374. package/.claude/commands/mindforge/add-backlog.md +0 -32
  375. package/.claude/commands/mindforge/agent.md +0 -31
  376. package/.claude/commands/mindforge/approve.md +0 -22
  377. package/.claude/commands/mindforge/audit.md +0 -34
  378. package/.claude/commands/mindforge/auto.md +0 -26
  379. package/.claude/commands/mindforge/benchmark.md +0 -37
  380. package/.claude/commands/mindforge/browse.md +0 -30
  381. package/.claude/commands/mindforge/complete-milestone.md +0 -22
  382. package/.claude/commands/mindforge/costs.md +0 -15
  383. package/.claude/commands/mindforge/cross-review.md +0 -21
  384. package/.claude/commands/mindforge/dashboard.md +0 -102
  385. package/.claude/commands/mindforge/debug.md +0 -133
  386. package/.claude/commands/mindforge/discuss-phase.md +0 -142
  387. package/.claude/commands/mindforge/do.md +0 -31
  388. package/.claude/commands/mindforge/execute-phase.md +0 -200
  389. package/.claude/commands/mindforge/health.md +0 -31
  390. package/.claude/commands/mindforge/help.md +0 -33
  391. package/.claude/commands/mindforge/init-org.md +0 -135
  392. package/.claude/commands/mindforge/init-project.md +0 -170
  393. package/.claude/commands/mindforge/install-skill.md +0 -28
  394. package/.claude/commands/mindforge/learn.md +0 -147
  395. package/.claude/commands/mindforge/learning.md +0 -20
  396. package/.claude/commands/mindforge/map-codebase.md +0 -302
  397. package/.claude/commands/mindforge/marketplace.md +0 -124
  398. package/.claude/commands/mindforge/metrics.md +0 -26
  399. package/.claude/commands/mindforge/migrate.md +0 -44
  400. package/.claude/commands/mindforge/milestone.md +0 -16
  401. package/.claude/commands/mindforge/new-runtime.md +0 -23
  402. package/.claude/commands/mindforge/next.md +0 -109
  403. package/.claude/commands/mindforge/note.md +0 -35
  404. package/.claude/commands/mindforge/plan-phase.md +0 -131
  405. package/.claude/commands/mindforge/plant-seed.md +0 -31
  406. package/.claude/commands/mindforge/plugins.md +0 -44
  407. package/.claude/commands/mindforge/pr-review.md +0 -45
  408. package/.claude/commands/mindforge/profile-team.md +0 -27
  409. package/.claude/commands/mindforge/publish-skill.md +0 -23
  410. package/.claude/commands/mindforge/qa.md +0 -20
  411. package/.claude/commands/mindforge/quick.md +0 -139
  412. package/.claude/commands/mindforge/record-learning.md +0 -22
  413. package/.claude/commands/mindforge/release.md +0 -14
  414. package/.claude/commands/mindforge/remember.md +0 -30
  415. package/.claude/commands/mindforge/research.md +0 -16
  416. package/.claude/commands/mindforge/retrospective.md +0 -31
  417. package/.claude/commands/mindforge/review-backlog.md +0 -34
  418. package/.claude/commands/mindforge/review.md +0 -161
  419. package/.claude/commands/mindforge/security-scan.md +0 -242
  420. package/.claude/commands/mindforge/session-report.md +0 -39
  421. package/.claude/commands/mindforge/ship.md +0 -111
  422. package/.claude/commands/mindforge/skills.md +0 -145
  423. package/.claude/commands/mindforge/status.md +0 -113
  424. package/.claude/commands/mindforge/steer.md +0 -17
  425. package/.claude/commands/mindforge/sync-confluence.md +0 -15
  426. package/.claude/commands/mindforge/sync-jira.md +0 -16
  427. package/.claude/commands/mindforge/tokens.md +0 -12
  428. package/.claude/commands/mindforge/ui-phase.md +0 -34
  429. package/.claude/commands/mindforge/ui-review.md +0 -36
  430. package/.claude/commands/mindforge/update.md +0 -46
  431. package/.claude/commands/mindforge/validate-phase.md +0 -31
  432. package/.claude/commands/mindforge/verify-phase.md +0 -66
  433. package/.claude/commands/mindforge/workspace.md +0 -33
  434. package/.claude/commands/mindforge/workstreams.md +0 -35
  435. package/.claude/settings.local.json +0 -16
  436. package/.mindforge/audit/AUDIT-SCHEMA.md +0 -470
  437. package/.mindforge/browser/daemon-protocol.md +0 -24
  438. package/.mindforge/browser/qa-engine.md +0 -16
  439. package/.mindforge/browser/session-manager.md +0 -18
  440. package/.mindforge/browser/visual-verify-spec.md +0 -31
  441. package/.mindforge/celestial.db +0 -0
  442. package/.mindforge/ci/ci-config-schema.md +0 -21
  443. package/.mindforge/ci/ci-mode.md +0 -179
  444. package/.mindforge/ci/github-actions-adapter.md +0 -224
  445. package/.mindforge/ci/gitlab-ci-adapter.md +0 -31
  446. package/.mindforge/ci/jenkins-adapter.md +0 -44
  447. package/.mindforge/dashboard/api-reference.md +0 -122
  448. package/.mindforge/dashboard/dashboard-spec.md +0 -96
  449. package/.mindforge/distribution/marketplace.md +0 -53
  450. package/.mindforge/distribution/registry-client.md +0 -166
  451. package/.mindforge/distribution/registry-schema.md +0 -96
  452. package/.mindforge/distribution/skill-publisher.md +0 -44
  453. package/.mindforge/distribution/skill-validator.md +0 -74
  454. package/.mindforge/governance/GOVERNANCE-CONFIG.md +0 -17
  455. package/.mindforge/governance/approval-workflow.md +0 -37
  456. package/.mindforge/governance/change-classifier.md +0 -63
  457. package/.mindforge/governance/compliance-gates.md +0 -31
  458. package/.mindforge/governance/policies/sovereign-default.json +0 -16
  459. package/.mindforge/integrations/confluence.md +0 -27
  460. package/.mindforge/integrations/connection-manager.md +0 -163
  461. package/.mindforge/integrations/github.md +0 -25
  462. package/.mindforge/integrations/gitlab.md +0 -13
  463. package/.mindforge/integrations/jira.md +0 -102
  464. package/.mindforge/integrations/slack.md +0 -41
  465. package/.mindforge/intelligence/antipattern-detector.md +0 -75
  466. package/.mindforge/intelligence/difficulty-scorer.md +0 -55
  467. package/.mindforge/intelligence/health-engine.md +0 -208
  468. package/.mindforge/intelligence/skill-gap-analyser.md +0 -40
  469. package/.mindforge/intelligence/smart-compaction.md +0 -71
  470. package/.mindforge/memory/MEMORY-SCHEMA.md +0 -155
  471. package/.mindforge/memory/engine/capture-protocol.md +0 -36
  472. package/.mindforge/memory/engine/global-sync-spec.md +0 -42
  473. package/.mindforge/memory/engine/retrieval-spec.md +0 -44
  474. package/.mindforge/memory/sync-manifest.json +0 -6
  475. package/.mindforge/metrics/METRICS-SCHEMA.md +0 -42
  476. package/.mindforge/metrics/quality-tracker.md +0 -32
  477. package/.mindforge/models/model-registry.md +0 -48
  478. package/.mindforge/models/model-router.md +0 -30
  479. package/.mindforge/monorepo/cross-package-planner.md +0 -114
  480. package/.mindforge/monorepo/dependency-graph-builder.md +0 -32
  481. package/.mindforge/monorepo/workspace-detector.md +0 -129
  482. package/.mindforge/org/CONVENTIONS.md +0 -62
  483. package/.mindforge/org/ORG.md +0 -51
  484. package/.mindforge/org/SECURITY.md +0 -50
  485. package/.mindforge/org/TOOLS.md +0 -53
  486. package/.mindforge/org/integrations/INTEGRATIONS-CONFIG.md +0 -58
  487. package/.mindforge/org/skills/MANIFEST.md +0 -15
  488. package/.mindforge/plugins/PLUGINS-MANIFEST.md +0 -23
  489. package/.mindforge/plugins/plugin-loader.md +0 -93
  490. package/.mindforge/plugins/plugin-registry.md +0 -44
  491. package/.mindforge/plugins/plugin-schema.md +0 -68
  492. package/.mindforge/pr-review/ai-reviewer.md +0 -266
  493. package/.mindforge/pr-review/finding-formatter.md +0 -46
  494. package/.mindforge/pr-review/review-prompt-templates.md +0 -44
  495. package/.mindforge/production/compatibility-layer.md +0 -39
  496. package/.mindforge/production/migration-engine.md +0 -52
  497. package/.mindforge/production/production-checklist.md +0 -76
  498. package/.mindforge/production/token-optimiser.md +0 -68
  499. package/.mindforge/skills-builder/auto-capture-protocol.md +0 -88
  500. package/.mindforge/skills-builder/learn-protocol.md +0 -161
  501. package/.mindforge/skills-builder/quality-scoring.md +0 -120
  502. package/.mindforge/team/TEAM-PROFILE.md +0 -42
  503. package/.mindforge/team/multi-handoff.md +0 -23
  504. package/.mindforge/team/profiles/README.md +0 -13
  505. package/.mindforge/team/session-merger.md +0 -18
  506. package/.planning/ARCHITECTURE.md +0 -0
  507. package/.planning/HANDOFF.json +0 -8
  508. package/.planning/PROJECT.md +0 -33
  509. package/.planning/RELEASE-CHECKLIST.md +0 -68
  510. package/.planning/REQUIREMENTS.md +0 -35
  511. package/.planning/ROADMAP.md +0 -12
  512. package/.planning/STATE.md +0 -36
  513. package/.planning/approvals/.gitkeep +0 -1
  514. package/.planning/archive/.gitkeep +0 -1
  515. package/.planning/audit-archive/.gitkeep +0 -1
  516. package/.planning/decisions/.gitkeep +0 -0
  517. package/.planning/jira-sync.json +0 -1
  518. package/.planning/milestones/.gitkeep +0 -1
  519. package/.planning/phases/.gitkeep +0 -0
  520. package/.planning/research/.gitkeep +0 -0
  521. package/.planning/screenshots/.gitkeep +0 -0
  522. package/.planning/slack-threads.json +0 -1
  523. package/docs/CAPABILITIES-MANIFEST.md +0 -64
  524. package/docs/Context/Master-Context.md +0 -731
  525. package/docs/INTELLIGENCE-MESH.md +0 -37
  526. package/docs/MIND-FORGE-REFERENCE-V6.md +0 -96
  527. package/docs/PERSONAS.md +0 -960
  528. package/docs/References/audit-events.md +0 -59
  529. package/docs/References/checkpoints.md +0 -778
  530. package/docs/References/commands.md +0 -107
  531. package/docs/References/config-reference.md +0 -81
  532. package/docs/References/continuation-format.md +0 -249
  533. package/docs/References/decimal-phase-calculation.md +0 -64
  534. package/docs/References/git-integration.md +0 -295
  535. package/docs/References/git-planning-commit.md +0 -38
  536. package/docs/References/model-profile-resolution.md +0 -36
  537. package/docs/References/model-profiles.md +0 -139
  538. package/docs/References/phase-argument-parsing.md +0 -61
  539. package/docs/References/planning-config.md +0 -202
  540. package/docs/References/questioning.md +0 -162
  541. package/docs/References/sdk-api.md +0 -53
  542. package/docs/References/skills-api.md +0 -57
  543. package/docs/References/tdd.md +0 -263
  544. package/docs/References/ui-brand.md +0 -160
  545. package/docs/References/user-profiling.md +0 -681
  546. package/docs/References/verification-patterns.md +0 -612
  547. package/docs/References/workstream-flag.md +0 -58
  548. package/docs/Templates/Agents/CLAUDE-MD.md +0 -122
  549. package/docs/Templates/Agents/COPILOT-INSTRUCTIONS.md +0 -7
  550. package/docs/Templates/Agents/DEBUGGER-PROMPT.md +0 -91
  551. package/docs/Templates/Agents/PLANNER-PROMPT.md +0 -117
  552. package/docs/Templates/Codebase/architecture.md +0 -255
  553. package/docs/Templates/Codebase/concerns.md +0 -310
  554. package/docs/Templates/Codebase/conventions.md +0 -307
  555. package/docs/Templates/Codebase/integrations.md +0 -280
  556. package/docs/Templates/Codebase/stack.md +0 -186
  557. package/docs/Templates/Codebase/structure.md +0 -285
  558. package/docs/Templates/Codebase/testing.md +0 -480
  559. package/docs/Templates/Execution/CONTINUE-HERE.md +0 -78
  560. package/docs/Templates/Execution/DISCUSSION-LOG.md +0 -63
  561. package/docs/Templates/Execution/PHASE-PROMPT.md +0 -610
  562. package/docs/Templates/Execution/STATE.md +0 -176
  563. package/docs/Templates/Execution/SUMMARY-COMPLEX.md +0 -59
  564. package/docs/Templates/Execution/SUMMARY-MINIMAL.md +0 -41
  565. package/docs/Templates/Execution/SUMMARY-STANDARD.md +0 -48
  566. package/docs/Templates/Execution/SUMMARY.md +0 -248
  567. package/docs/Templates/Profile/DEV-PREFERENCES.md +0 -21
  568. package/docs/Templates/Profile/USER-PROFILE.md +0 -146
  569. package/docs/Templates/Profile/USER-SETUP.md +0 -311
  570. package/docs/Templates/Project/AGENTS_LEARNING.md +0 -88
  571. package/docs/Templates/Project/DISCOVERY.md +0 -146
  572. package/docs/Templates/Project/MILESTONE-ARCHIVE.md +0 -123
  573. package/docs/Templates/Project/MILESTONE.md +0 -115
  574. package/docs/Templates/Project/PROJECT.md +0 -206
  575. package/docs/Templates/Project/REQUIREMENTS.md +0 -231
  576. package/docs/Templates/Project/RETROSPECTIVE.md +0 -54
  577. package/docs/Templates/Project/ROADMAP.md +0 -202
  578. package/docs/Templates/Quality/DEBUG.md +0 -164
  579. package/docs/Templates/Quality/UAT.md +0 -280
  580. package/docs/Templates/Quality/UI-SPEC.md +0 -100
  581. package/docs/Templates/Quality/VALIDATION.md +0 -76
  582. package/docs/Templates/Quality/VERIFICATION-REPORT.md +0 -322
  583. package/docs/Templates/Research/ARCHITECTURE.md +0 -204
  584. package/docs/Templates/Research/FEATURES.md +0 -147
  585. package/docs/Templates/Research/PITFALLS.md +0 -200
  586. package/docs/Templates/Research/STACK.md +0 -120
  587. package/docs/Templates/Research/SUMMARY.md +0 -170
  588. package/docs/Templates/System/CONFIG.json +0 -43
  589. package/docs/Templates/System/CONTEXT.md +0 -352
  590. package/docs/adr/ADR-024-browser-localhost-only.md +0 -17
  591. package/docs/adr/ADR-025-visual-verify-failure-treatment.md +0 -19
  592. package/docs/adr/ADR-026-session-persistence-security.md +0 -20
  593. package/docs/adr/ADR-042-ads-protocol.md +0 -30
  594. package/docs/architecture/NEXUS-DASHBOARD.md +0 -35
  595. package/docs/architecture/PAR-ZTS-SURVEY.md +0 -43
  596. package/docs/architecture/README.md +0 -78
  597. package/docs/architecture/V3-CORE.md +0 -52
  598. package/docs/architecture/V4-SWARM-MESH.md +0 -77
  599. package/docs/architecture/V5-ENTERPRISE.md +0 -131
  600. package/docs/architecture/V6-SOVEREIGN.md +0 -43
  601. package/docs/architecture/V8-SRE.md +0 -88
  602. package/docs/architecture/V9-BEDROCK.md +0 -162
  603. package/docs/architecture/adr-039-multi-runtime-support.md +0 -20
  604. package/docs/architecture/adr-040-additive-schema-migration.md +0 -21
  605. package/docs/architecture/adr-041-stable-runtime-interface-contract.md +0 -20
  606. package/docs/architecture/decision-records-index.md +0 -29
  607. package/docs/ci-cd-integration.md +0 -30
  608. package/docs/ci-cd.md +0 -92
  609. package/docs/ci-quickstart.md +0 -78
  610. package/docs/commands-skills/DISCOVERED_SKILLS.md +0 -21
  611. package/docs/contributing/CONTRIBUTING.md +0 -38
  612. package/docs/contributing/plugin-authoring.md +0 -50
  613. package/docs/contributing/skill-authoring.md +0 -41
  614. package/docs/enterprise-setup.md +0 -25
  615. package/docs/feature-dashboard.md +0 -63
  616. package/docs/governance-guide.md +0 -134
  617. package/docs/monorepo-guide.md +0 -26
  618. package/docs/persona-customisation.md +0 -56
  619. package/docs/publishing-guide.md +0 -43
  620. package/docs/quick-verify.md +0 -33
  621. package/docs/registry/AGENTS.md +0 -37
  622. package/docs/registry/COMMANDS.md +0 -87
  623. package/docs/registry/HOOKS.md +0 -38
  624. package/docs/registry/PERSONAS.md +0 -64
  625. package/docs/registry/README.md +0 -27
  626. package/docs/registry/SKILLS.md +0 -142
  627. package/docs/registry/WORKFLOWS.md +0 -72
  628. package/docs/release-checklist-guide.md +0 -37
  629. package/docs/requirements.md +0 -29
  630. package/docs/security/SECURITY.md +0 -55
  631. package/docs/security/ZTAI-OVERVIEW.md +0 -37
  632. package/docs/security/penetration-test-results.md +0 -31
  633. package/docs/security/threat-model.md +0 -142
  634. package/docs/skills-authoring-guide.md +0 -176
  635. package/docs/skills-publishing-guide.md +0 -22
  636. package/docs/team-setup-guide.md +0 -21
  637. package/docs/testing-current-version.md +0 -130
  638. package/docs/tutorial.md +0 -162
  639. package/docs/upgrade.md +0 -58
  640. package/docs/usp-features.md +0 -102
  641. package/docs/workflow-atlas.md +0 -57
@@ -1,277 +0,0 @@
1
- ---
2
- name: mindforge-swarm-execution
3
- description: Use when executing implementation plans with independent tasks in the current session
4
- ---
5
-
6
- # Subagent-Driven Development
7
-
8
- Execute plan by dispatching fresh subagent per task, with two-stage review after each: spec compliance review first, then code quality review.
9
-
10
- **Why subagents:** You delegate tasks to specialized agents with isolated context. By precisely crafting their instructions and context, you ensure they stay focused and succeed at their task. They should never inherit your session's context or history — you construct exactly what they need. This also preserves your own context for coordination work.
11
-
12
- **Core principle:** Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration
13
-
14
- ## When to Use
15
-
16
- ```dot
17
- digraph when_to_use {
18
- "Have implementation plan?" [shape=diamond];
19
- "Tasks mostly independent?" [shape=diamond];
20
- "Stay in this session?" [shape=diamond];
21
- "mindforge-swarm-execution" [shape=box];
22
- "mindforge-execute-phase_extended" [shape=box];
23
- "Manual execution or brainstorm first" [shape=box];
24
-
25
- "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
26
- "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
27
- "Tasks mostly independent?" -> "Stay in this session?" [label="yes"];
28
- "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
29
- "Stay in this session?" -> "mindforge-swarm-execution" [label="yes"];
30
- "Stay in this session?" -> "mindforge-execute-phase_extended" [label="no - parallel session"];
31
- }
32
- ```
33
-
34
- **vs. Executing Plans (parallel session):**
35
- - Same session (no context switch)
36
- - Fresh subagent per task (no context pollution)
37
- - Two-stage review after each task: spec compliance first, then code quality
38
- - Faster iteration (no human-in-loop between tasks)
39
-
40
- ## The Process
41
-
42
- ```dot
43
- digraph process {
44
- rankdir=TB;
45
-
46
- subgraph cluster_per_task {
47
- label="Per Task";
48
- "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];
49
- "Implementer subagent asks questions?" [shape=diamond];
50
- "Answer questions, provide context" [shape=box];
51
- "Implementer subagent implements, tests, commits, self-reviews" [shape=box];
52
- "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box];
53
- "Spec reviewer subagent confirms code matches spec?" [shape=diamond];
54
- "Implementer subagent fixes spec gaps" [shape=box];
55
- "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box];
56
- "Code quality reviewer subagent approves?" [shape=diamond];
57
- "Implementer subagent fixes quality issues" [shape=box];
58
- "Mark task complete in TodoWrite" [shape=box];
59
- }
60
-
61
- "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
62
- "More tasks remain?" [shape=diamond];
63
- "Dispatch final code reviewer subagent for entire implementation" [shape=box];
64
- "Use mindforge:ship_extended" [shape=box style=filled fillcolor=lightgreen];
65
-
66
- "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";
67
- "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
68
- "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
69
- "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";
70
- "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];
71
- "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)";
72
- "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?";
73
- "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"];
74
- "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"];
75
- "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"];
76
- "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?";
77
- "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"];
78
- "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"];
79
- "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
80
- "Mark task complete in TodoWrite" -> "More tasks remain?";
81
- "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
82
- "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"];
83
- "Dispatch final code reviewer subagent for entire implementation" -> "Use mindforge:ship_extended";
84
- }
85
- ```
86
-
87
- ## Model Selection
88
-
89
- Use the least powerful model that can handle each role to conserve cost and increase speed.
90
-
91
- **Mechanical implementation tasks** (isolated functions, clear specs, 1-2 files): use a fast, cheap model. Most implementation tasks are mechanical when the plan is well-specified.
92
-
93
- **Integration and judgment tasks** (multi-file coordination, pattern matching, debugging): use a standard model.
94
-
95
- **Architecture, design, and review tasks**: use the most capable available model.
96
-
97
- **Task complexity signals:**
98
- - Touches 1-2 files with a complete spec → cheap model
99
- - Touches multiple files with integration concerns → standard model
100
- - Requires design judgment or broad codebase understanding → most capable model
101
-
102
- ## Handling Implementer Status
103
-
104
- Implementer subagents report one of four statuses. Handle each appropriately:
105
-
106
- **DONE:** Proceed to spec compliance review.
107
-
108
- **DONE_WITH_CONCERNS:** The implementer completed the work but flagged doubts. Read the concerns before proceeding. If the concerns are about correctness or scope, address them before review. If they're observations (e.g., "this file is getting large"), note them and proceed to review.
109
-
110
- **NEEDS_CONTEXT:** The implementer needs information that wasn't provided. Provide the missing context and re-dispatch.
111
-
112
- **BLOCKED:** The implementer cannot complete the task. Assess the blocker:
113
- 1. If it's a context problem, provide more context and re-dispatch with the same model
114
- 2. If the task requires more reasoning, re-dispatch with a more capable model
115
- 3. If the task is too large, break it into smaller pieces
116
- 4. If the plan itself is wrong, escalate to the human
117
-
118
- **Never** ignore an escalation or force the same model to retry without changes. If the implementer said it's stuck, something needs to change.
119
-
120
- ## Prompt Templates
121
-
122
- - `./implementer-prompt.md` - Dispatch implementer subagent
123
- - `./spec-reviewer-prompt.md` - Dispatch spec compliance reviewer subagent
124
- - `./code-quality-reviewer-prompt.md` - Dispatch code quality reviewer subagent
125
-
126
- ## Example Workflow
127
-
128
- ```
129
- You: I'm using Subagent-Driven Development to execute this plan.
130
-
131
- [Read plan file once: docs/mindforge/plans/feature-plan.md]
132
- [Extract all 5 tasks with full text and context]
133
- [Create TodoWrite with all tasks]
134
-
135
- Task 1: Hook installation script
136
-
137
- [Get Task 1 text and context (already extracted)]
138
- [Dispatch implementation subagent with full task text + context]
139
-
140
- Implementer: "Before I begin - should the hook be installed at user or system level?"
141
-
142
- You: "User level (~/.config/mindforge/hooks/)"
143
-
144
- Implementer: "Got it. Implementing now..."
145
- [Later] Implementer:
146
- - Implemented install-hook command
147
- - Added tests, 5/5 passing
148
- - Self-review: Found I missed --force flag, added it
149
- - Committed
150
-
151
- [Dispatch spec compliance reviewer]
152
- Spec reviewer: ✅ Spec compliant - all requirements met, nothing extra
153
-
154
- [Get git SHAs, dispatch code quality reviewer]
155
- Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.
156
-
157
- [Mark Task 1 complete]
158
-
159
- Task 2: Recovery modes
160
-
161
- [Get Task 2 text and context (already extracted)]
162
- [Dispatch implementation subagent with full task text + context]
163
-
164
- Implementer: [No questions, proceeds]
165
- Implementer:
166
- - Added verify/repair modes
167
- - 8/8 tests passing
168
- - Self-review: All good
169
- - Committed
170
-
171
- [Dispatch spec compliance reviewer]
172
- Spec reviewer: ❌ Issues:
173
- - Missing: Progress reporting (spec says "report every 100 items")
174
- - Extra: Added --json flag (not requested)
175
-
176
- [Implementer fixes issues]
177
- Implementer: Removed --json flag, added progress reporting
178
-
179
- [Spec reviewer reviews again]
180
- Spec reviewer: ✅ Spec compliant now
181
-
182
- [Dispatch code quality reviewer]
183
- Code reviewer: Strengths: Solid. Issues (Important): Magic number (100)
184
-
185
- [Implementer fixes]
186
- Implementer: Extracted PROGRESS_INTERVAL constant
187
-
188
- [Code reviewer reviews again]
189
- Code reviewer: ✅ Approved
190
-
191
- [Mark Task 2 complete]
192
-
193
- ...
194
-
195
- [After all tasks]
196
- [Dispatch final code-reviewer]
197
- Final reviewer: All requirements met, ready to merge
198
-
199
- Done!
200
- ```
201
-
202
- ## Advantages
203
-
204
- **vs. Manual execution:**
205
- - Subagents follow TDD naturally
206
- - Fresh context per task (no confusion)
207
- - Parallel-safe (subagents don't interfere)
208
- - Subagent can ask questions (before AND during work)
209
-
210
- **vs. Executing Plans:**
211
- - Same session (no handoff)
212
- - Continuous progress (no waiting)
213
- - Review checkpoints automatic
214
-
215
- **Efficiency gains:**
216
- - No file reading overhead (controller provides full text)
217
- - Controller curates exactly what context is needed
218
- - Subagent gets complete information upfront
219
- - Questions surfaced before work begins (not after)
220
-
221
- **Quality gates:**
222
- - Self-review catches issues before handoff
223
- - Two-stage review: spec compliance, then code quality
224
- - Review loops ensure fixes actually work
225
- - Spec compliance prevents over/under-building
226
- - Code quality ensures implementation is well-built
227
-
228
- **Cost:**
229
- - More subagent invocations (implementer + 2 reviewers per task)
230
- - Controller does more prep work (extracting all tasks upfront)
231
- - Review loops add iterations
232
- - But catches issues early (cheaper than debugging later)
233
-
234
- ## Red Flags
235
-
236
- **Never:**
237
- - Start implementation on main/master branch without explicit user consent
238
- - Skip reviews (spec compliance OR code quality)
239
- - Proceed with unfixed issues
240
- - Dispatch multiple implementation subagents in parallel (conflicts)
241
- - Make subagent read plan file (provide full text instead)
242
- - Skip scene-setting context (subagent needs to understand where task fits)
243
- - Ignore subagent questions (answer before letting them proceed)
244
- - Accept "close enough" on spec compliance (spec reviewer found issues = not done)
245
- - Skip review loops (reviewer found issues = implementer fixes = review again)
246
- - Let implementer self-review replace actual review (both are needed)
247
- - **Start code quality review before spec compliance is ✅** (wrong order)
248
- - Move to next task while either review has open issues
249
-
250
- **If subagent asks questions:**
251
- - Answer clearly and completely
252
- - Provide additional context if needed
253
- - Don't rush them into implementation
254
-
255
- **If reviewer finds issues:**
256
- - Implementer (same subagent) fixes them
257
- - Reviewer reviews again
258
- - Repeat until approved
259
- - Don't skip the re-review
260
-
261
- **If subagent fails task:**
262
- - Dispatch fix subagent with specific instructions
263
- - Don't try to fix manually (context pollution)
264
-
265
- ## Integration
266
-
267
- **Required workflow skills:**
268
- - **mindforge:using-git-worktrees** - REQUIRED: Set up isolated workspace before starting
269
- - **mindforge:plan-phase_extended** - Creates the plan this skill executes
270
- - **mindforge:requesting-code-review** - Code review template for reviewer subagents
271
- - **mindforge:ship_extended** - Complete development after all tasks
272
-
273
- **Subagents should use:**
274
- - **mindforge:tdd_extended** - Subagents follow TDD for each task
275
-
276
- **Alternative workflow:**
277
- - **mindforge:execute-phase_extended** - Use for parallel session instead of same-session execution
@@ -1,26 +0,0 @@
1
- # Code Quality Reviewer Prompt Template
2
-
3
- Use this template when dispatching a code quality reviewer subagent.
4
-
5
- **Purpose:** Verify implementation is well-built (clean, tested, maintainable)
6
-
7
- **Only dispatch after spec compliance review passes.**
8
-
9
- ```
10
- Task tool (mindforge:code-reviewer):
11
- Use template at requesting-code-review/code-reviewer.md
12
-
13
- WHAT_WAS_IMPLEMENTED: [from implementer's report]
14
- PLAN_OR_REQUIREMENTS: Task N from [plan-file]
15
- BASE_SHA: [commit before task]
16
- HEAD_SHA: [current commit]
17
- DESCRIPTION: [task summary]
18
- ```
19
-
20
- **In addition to standard code quality concerns, the reviewer should check:**
21
- - Does each file have one clear responsibility with a well-defined interface?
22
- - Are units decomposed so they can be understood and tested independently?
23
- - Is the implementation following the file structure from the plan?
24
- - Did this implementation create new files that are already large, or significantly grow existing files? (Don't flag pre-existing file sizes — focus on what this change contributed.)
25
-
26
- **Code reviewer returns:** Strengths, Issues (Critical/Important/Minor), Assessment
@@ -1,113 +0,0 @@
1
- # Implementer Subagent Prompt Template
2
-
3
- Use this template when dispatching an implementer subagent.
4
-
5
- ```
6
- Task tool (general-purpose):
7
- description: "Implement Task N: [task name]"
8
- prompt: |
9
- You are implementing Task N: [task name]
10
-
11
- ## Task Description
12
-
13
- [FULL TEXT of task from plan - paste it here, don't make subagent read file]
14
-
15
- ## Context
16
-
17
- [Scene-setting: where this fits, dependencies, architectural context]
18
-
19
- ## Before You Begin
20
-
21
- If you have questions about:
22
- - The requirements or acceptance criteria
23
- - The approach or implementation strategy
24
- - Dependencies or assumptions
25
- - Anything unclear in the task description
26
-
27
- **Ask them now.** Raise any concerns before starting work.
28
-
29
- ## Your Job
30
-
31
- Once you're clear on requirements:
32
- 1. Implement exactly what the task specifies
33
- 2. Write tests (following TDD if task says to)
34
- 3. Verify implementation works
35
- 4. Commit your work
36
- 5. Self-review (see below)
37
- 6. Report back
38
-
39
- Work from: [directory]
40
-
41
- **While you work:** If you encounter something unexpected or unclear, **ask questions**.
42
- It's always OK to pause and clarify. Don't guess or make assumptions.
43
-
44
- ## Code Organization
45
-
46
- You reason best about code you can hold in context at once, and your edits are more
47
- reliable when files are focused. Keep this in mind:
48
- - Follow the file structure defined in the plan
49
- - Each file should have one clear responsibility with a well-defined interface
50
- - If a file you're creating is growing beyond the plan's intent, stop and report
51
- it as DONE_WITH_CONCERNS — don't split files on your own without plan guidance
52
- - If an existing file you're modifying is already large or tangled, work carefully
53
- and note it as a concern in your report
54
- - In existing codebases, follow established patterns. Improve code you're touching
55
- the way a good developer would, but don't restructure things outside your task.
56
-
57
- ## When You're in Over Your Head
58
-
59
- It is always OK to stop and say "this is too hard for me." Bad work is worse than
60
- no work. You will not be penalized for escalating.
61
-
62
- **STOP and escalate when:**
63
- - The task requires architectural decisions with multiple valid approaches
64
- - You need to understand code beyond what was provided and can't find clarity
65
- - You feel uncertain about whether your approach is correct
66
- - The task involves restructuring existing code in ways the plan didn't anticipate
67
- - You've been reading file after file trying to understand the system without progress
68
-
69
- **How to escalate:** Report back with status BLOCKED or NEEDS_CONTEXT. Describe
70
- specifically what you're stuck on, what you've tried, and what kind of help you need.
71
- The controller can provide more context, re-dispatch with a more capable model,
72
- or break the task into smaller pieces.
73
-
74
- ## Before Reporting Back: Self-Review
75
-
76
- Review your work with fresh eyes. Ask yourself:
77
-
78
- **Completeness:**
79
- - Did I fully implement everything in the spec?
80
- - Did I miss any requirements?
81
- - Are there edge cases I didn't handle?
82
-
83
- **Quality:**
84
- - Is this my best work?
85
- - Are names clear and accurate (match what things do, not how they work)?
86
- - Is the code clean and maintainable?
87
-
88
- **Discipline:**
89
- - Did I avoid overbuilding (YAGNI)?
90
- - Did I only build what was requested?
91
- - Did I follow existing patterns in the codebase?
92
-
93
- **Testing:**
94
- - Do tests actually verify behavior (not just mock behavior)?
95
- - Did I follow TDD if required?
96
- - Are tests comprehensive?
97
-
98
- If you find issues during self-review, fix them now before reporting.
99
-
100
- ## Report Format
101
-
102
- When done, report:
103
- - **Status:** DONE | DONE_WITH_CONCERNS | BLOCKED | NEEDS_CONTEXT
104
- - What you implemented (or what you attempted, if blocked)
105
- - What you tested and test results
106
- - Files changed
107
- - Self-review findings (if any)
108
- - Any issues or concerns
109
-
110
- Use DONE_WITH_CONCERNS if you completed the work but have doubts about correctness.
111
- Use BLOCKED if you cannot complete the task. Use NEEDS_CONTEXT if you need
112
- information that wasn't provided. Never silently produce work you're unsure about.
113
- ```
@@ -1,61 +0,0 @@
1
- # Spec Compliance Reviewer Prompt Template
2
-
3
- Use this template when dispatching a spec compliance reviewer subagent.
4
-
5
- **Purpose:** Verify implementer built what was requested (nothing more, nothing less)
6
-
7
- ```
8
- Task tool (general-purpose):
9
- description: "Review spec compliance for Task N"
10
- prompt: |
11
- You are reviewing whether an implementation matches its specification.
12
-
13
- ## What Was Requested
14
-
15
- [FULL TEXT of task requirements]
16
-
17
- ## What Implementer Claims They Built
18
-
19
- [From implementer's report]
20
-
21
- ## CRITICAL: Do Not Trust the Report
22
-
23
- The implementer finished suspiciously quickly. Their report may be incomplete,
24
- inaccurate, or optimistic. You MUST verify everything independently.
25
-
26
- **DO NOT:**
27
- - Take their word for what they implemented
28
- - Trust their claims about completeness
29
- - Accept their interpretation of requirements
30
-
31
- **DO:**
32
- - Read the actual code they wrote
33
- - Compare actual implementation to requirements line by line
34
- - Check for missing pieces they claimed to implement
35
- - Look for extra features they didn't mention
36
-
37
- ## Your Job
38
-
39
- Read the implementation code and verify:
40
-
41
- **Missing requirements:**
42
- - Did they implement everything that was requested?
43
- - Are there requirements they skipped or missed?
44
- - Did they claim something works but didn't actually implement it?
45
-
46
- **Extra/unneeded work:**
47
- - Did they build things that weren't requested?
48
- - Did they over-engineer or add unnecessary features?
49
- - Did they add "nice to haves" that weren't in spec?
50
-
51
- **Misunderstandings:**
52
- - Did they interpret requirements differently than intended?
53
- - Did they solve the wrong problem?
54
- - Did they implement the right feature but wrong way?
55
-
56
- **Verify by reading code, not by trusting report.**
57
-
58
- Report:
59
- - ✅ Spec compliant (if everything matches after code inspection)
60
- - ❌ Issues found: [list specifically what's missing or extra, with file:line references]
61
- ```
@@ -1,136 +0,0 @@
1
- ---
2
- name: system-architecture
3
- description: Design systems with appropriate complexity - no more, no less. Use when the user asks to architect applications, design system boundaries, plan service decomposition, evaluate monolith vs microservices, make scaling decisions, or review structural trade-offs. Applies to new system design, refactoring, and migration planning.
4
- ---
5
-
6
- # System Architecture
7
-
8
- Design real structures with clear boundaries, explicit trade-offs, and appropriate complexity. Match architecture to actual requirements, not imagined future needs.
9
-
10
- ## Workflow
11
-
12
- When the user requests an architecture, follow these steps:
13
-
14
- ```
15
- Task Progress:
16
- - [ ] Step 1: Clarify constraints
17
- - [ ] Step 2: Identify domains
18
- - [ ] Step 3: Map data flow
19
- - [ ] Step 4: Draw boundaries with rationale
20
- - [ ] Step 5: Run complexity checklist
21
- - [ ] Step 6: Present architecture with trade-offs
22
- ```
23
-
24
- **Step 1 - Clarify constraints.** Ask about:
25
-
26
- | Constraint | Question | Why it matters |
27
- |------------|----------|----------------|
28
- | Scale | What's the real load? (users, requests/sec, data size) | Design for 10x current, not 1000x |
29
- | Team | How many developers? How many teams? | Deployable units ≤ number of teams |
30
- | Lifespan | Prototype? MVP? Long-term product? | Temporary systems need temporary solutions |
31
- | Change vectors | What actually varies? | Abstract only where you have evidence of variation |
32
-
33
- **Step 2 - Identify domains.** Group by business capability, not technical layer. Look for things that change for different reasons and at different rates.
34
-
35
- **Step 3 - Map data flow.** Trace: where does data enter → how does it transform → where does it exit? Make the flow obvious.
36
-
37
- **Step 4 - Draw boundaries.** Every boundary needs a reason: different team, different change rate, different compliance requirement, or different scaling need.
38
-
39
- **Step 5 - Run complexity checklist.** Before adding any non-trivial pattern:
40
-
41
- ```
42
- [ ] Have I tried the simple solution?
43
- [ ] Do I have evidence it's insufficient?
44
- [ ] Can my team operate this?
45
- [ ] Will this still make sense in 6 months?
46
- [ ] Can I explain why this complexity is necessary?
47
- ```
48
-
49
- If any answer is "no", keep it simple.
50
-
51
- **Step 6 - Present the architecture** using the output template below.
52
-
53
- ## Output Template
54
-
55
- ```markdown
56
- ### System: [Name]
57
-
58
- **Constraints**:
59
- - Scale: [current and expected load]
60
- - Team: [size and structure]
61
- - Lifespan: [prototype / MVP / long-term]
62
-
63
- **Architecture**:
64
- [Component diagram or description of components and their relationships]
65
-
66
- **Data Flow**:
67
- [How data enters → transforms → exits]
68
-
69
- **Key Boundaries**:
70
- | Boundary | Reason | Change Rate |
71
- |----------|--------|-------------|
72
- | ... | ... | ... |
73
-
74
- **Trade-offs**:
75
- - Chose X over Y because [reason]
76
- - Accepted [limitation] to gain [benefit]
77
-
78
- **Complexity Justification**:
79
- - [Each non-trivial pattern] → [why it's needed, with evidence]
80
- ```
81
-
82
- ## Core Principles
83
-
84
- 1. **Boundaries at real differences.** Separate concerns that change for different reasons and at different rates.
85
- 2. **Dependencies flow inward.** Core logic depends on nothing. Infrastructure depends on core.
86
- 3. **Follow the data.** Architecture should make data flow obvious.
87
- 4. **Design for failure.** Network fails. Databases timeout. Build compensation into the structure.
88
- 5. **Design for operations.** You will debug this at 3am. Every request needs a trace. Every error needs context for replay.
89
-
90
- For concrete good/bad examples of each principle, see [examples.md](examples.md).
91
-
92
- ## Anti-Patterns
93
-
94
- | Don't | Do Instead |
95
- |-------|------------|
96
- | Microservices for a 3-person team | Well-structured monolith |
97
- | Event sourcing for CRUD | Simple state storage |
98
- | Message queues within the same process | Just call the function |
99
- | Distributed transactions | Redesign to avoid, or accept eventual consistency |
100
- | Repository wrapping an ORM | Use the ORM directly |
101
- | Interfaces with one implementation | Mock at boundaries only |
102
- | AbstractFactoryFactoryBean | Just instantiate the thing |
103
- | DI containers for simple graphs | Constructor injection is enough |
104
- | Clean Architecture for a TODO app | Match layers to actual complexity |
105
- | DDD tactics without strategic design | Aggregates need bounded contexts |
106
- | Hexagonal ports with one adapter | Just call the database |
107
- | CQRS when reads = writes | Add when they diverge |
108
- | "We might swap databases" | You won't; rewrite if you do |
109
- | "Multi-tenant someday" | Build it when you have tenant #2 |
110
- | "Microservices for team scale" | Helps at 50+ engineers, not 4 |
111
-
112
- ## Success Criteria
113
-
114
- Your architecture is right-sized when:
115
-
116
- 1. **You can draw it** - dependency graph fits on a whiteboard
117
- 2. **You can explain it** - new team member understands data flow in 30 minutes
118
- 3. **You can change it** - adding a feature touches 1-3 modules, not 10
119
- 4. **You can delete it** - removing a component needs no archaeology
120
- 5. **You can debug it** - tracing a request takes minutes, not hours
121
- 6. **It matches your team** - deployable units ≤ number of teams
122
-
123
- ## When the Simple Solution Isn't Enough
124
-
125
- If the complexity checklist says "yes, scale is real", see [scaling-checklist.md](scaling-checklist.md) for concrete techniques covering caching, async processing, partitioning, horizontal scaling, and multi-region.
126
-
127
- ## Iterative Architecture
128
-
129
- Architecture is discovered, not designed upfront:
130
-
131
- 1. **Start obvious** - group by domain, not by technical layer
132
- 2. **Let hotspots emerge** - monitor which modules change together
133
- 3. **Extract when painful** - split only when the current form causes measurable problems
134
- 4. **Document decisions** - record why boundaries exist so future you knows what's load-bearing
135
-
136
- Every senior engineer has a graveyard of over-engineered systems they regret. Learn from their pain. Build boring systems that work.