moflo 4.0.4 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  3. package/.claude/agents/analysis/code-analyzer.md +209 -209
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/base-template-generator.md +42 -42
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +265 -265
  15. package/.claude/agents/core/planner.md +167 -167
  16. package/.claude/agents/core/researcher.md +189 -189
  17. package/.claude/agents/core/reviewer.md +325 -325
  18. package/.claude/agents/core/tester.md +318 -318
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  21. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  22. package/.claude/agents/development/dev-backend-api.md +344 -344
  23. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  24. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  25. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  26. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  27. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +537 -537
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +318 -318
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +190 -190
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +366 -366
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +634 -634
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/code-goal-planner.md +445 -445
  52. package/.claude/agents/goal/goal-planner.md +167 -167
  53. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  54. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  55. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  56. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  57. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  58. package/.claude/agents/neural/safla-neural.md +73 -73
  59. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  60. package/.claude/agents/optimization/load-balancer.md +430 -430
  61. package/.claude/agents/optimization/performance-monitor.md +671 -671
  62. package/.claude/agents/optimization/resource-allocator.md +673 -673
  63. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  64. package/.claude/agents/payments/agentic-payments.md +126 -126
  65. package/.claude/agents/reasoning/agent.md +815 -815
  66. package/.claude/agents/reasoning/goal-planner.md +72 -72
  67. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  68. package/.claude/agents/sparc/architecture.md +471 -471
  69. package/.claude/agents/sparc/pseudocode.md +317 -317
  70. package/.claude/agents/sparc/refinement.md +524 -524
  71. package/.claude/agents/sparc/specification.md +275 -275
  72. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  73. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  74. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  75. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  76. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  77. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  78. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  79. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  80. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  81. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  82. package/.claude/agents/templates/coordinator-swarm-init.md +104 -104
  83. package/.claude/agents/templates/github-pr-manager.md +176 -176
  84. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  85. package/.claude/agents/templates/memory-coordinator.md +186 -186
  86. package/.claude/agents/templates/migration-plan.md +745 -745
  87. package/.claude/agents/templates/orchestrator-task.md +138 -138
  88. package/.claude/agents/templates/performance-analyzer.md +198 -198
  89. package/.claude/agents/templates/sparc-coordinator.md +182 -182
  90. package/.claude/agents/testing/production-validator.md +394 -394
  91. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  92. package/.claude/agents/testing/unit/tdd-london-swarm.md +243 -243
  93. package/.claude/agents/testing/validation/production-validator.md +394 -394
  94. package/.claude/agents/v3/v3-integration-architect.md +345 -345
  95. package/.claude/agents/v3/v3-memory-specialist.md +317 -317
  96. package/.claude/agents/v3/v3-performance-engineer.md +396 -396
  97. package/.claude/agents/v3/v3-queen-coordinator.md +97 -97
  98. package/.claude/agents/v3/v3-security-architect.md +173 -173
  99. package/.claude/commands/agents/README.md +10 -10
  100. package/.claude/commands/agents/agent-capabilities.md +21 -21
  101. package/.claude/commands/agents/agent-coordination.md +28 -28
  102. package/.claude/commands/agents/agent-spawning.md +28 -28
  103. package/.claude/commands/agents/agent-types.md +26 -26
  104. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  105. package/.claude/commands/analysis/README.md +9 -9
  106. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  107. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  108. package/.claude/commands/analysis/performance-report.md +25 -25
  109. package/.claude/commands/analysis/token-efficiency.md +44 -44
  110. package/.claude/commands/analysis/token-usage.md +25 -25
  111. package/.claude/commands/automation/README.md +9 -9
  112. package/.claude/commands/automation/auto-agent.md +122 -122
  113. package/.claude/commands/automation/self-healing.md +105 -105
  114. package/.claude/commands/automation/session-memory.md +89 -89
  115. package/.claude/commands/automation/smart-agents.md +72 -72
  116. package/.claude/commands/automation/smart-spawn.md +25 -25
  117. package/.claude/commands/automation/workflow-select.md +25 -25
  118. package/.claude/commands/claude-flow-help.md +103 -103
  119. package/.claude/commands/claude-flow-memory.md +107 -107
  120. package/.claude/commands/claude-flow-swarm.md +205 -205
  121. package/.claude/commands/coordination/README.md +9 -9
  122. package/.claude/commands/coordination/agent-spawn.md +25 -25
  123. package/.claude/commands/coordination/init.md +44 -44
  124. package/.claude/commands/coordination/orchestrate.md +43 -43
  125. package/.claude/commands/coordination/spawn.md +45 -45
  126. package/.claude/commands/coordination/swarm-init.md +85 -85
  127. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  128. package/.claude/commands/flow-nexus/app-store.md +123 -123
  129. package/.claude/commands/flow-nexus/challenges.md +119 -119
  130. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  131. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  132. package/.claude/commands/flow-nexus/payments.md +115 -115
  133. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  134. package/.claude/commands/flow-nexus/swarm.md +86 -86
  135. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  136. package/.claude/commands/flow-nexus/workflow.md +114 -114
  137. package/.claude/commands/github/README.md +11 -11
  138. package/.claude/commands/github/code-review-swarm.md +513 -513
  139. package/.claude/commands/github/code-review.md +25 -25
  140. package/.claude/commands/github/github-modes.md +146 -146
  141. package/.claude/commands/github/github-swarm.md +121 -121
  142. package/.claude/commands/github/issue-tracker.md +291 -291
  143. package/.claude/commands/github/issue-triage.md +25 -25
  144. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  145. package/.claude/commands/github/pr-enhance.md +26 -26
  146. package/.claude/commands/github/pr-manager.md +169 -169
  147. package/.claude/commands/github/project-board-sync.md +470 -470
  148. package/.claude/commands/github/release-manager.md +337 -337
  149. package/.claude/commands/github/release-swarm.md +543 -543
  150. package/.claude/commands/github/repo-analyze.md +25 -25
  151. package/.claude/commands/github/repo-architect.md +366 -366
  152. package/.claude/commands/github/swarm-issue.md +481 -481
  153. package/.claude/commands/github/swarm-pr.md +284 -284
  154. package/.claude/commands/github/sync-coordinator.md +300 -300
  155. package/.claude/commands/github/workflow-automation.md +441 -441
  156. package/.claude/commands/hive-mind/README.md +17 -17
  157. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  159. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  160. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  161. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  162. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  163. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  164. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  165. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  166. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  168. package/.claude/commands/hooks/README.md +11 -11
  169. package/.claude/commands/hooks/overview.md +57 -57
  170. package/.claude/commands/hooks/post-edit.md +117 -117
  171. package/.claude/commands/hooks/post-task.md +112 -112
  172. package/.claude/commands/hooks/pre-edit.md +113 -113
  173. package/.claude/commands/hooks/pre-task.md +111 -111
  174. package/.claude/commands/hooks/session-end.md +118 -118
  175. package/.claude/commands/hooks/setup.md +102 -102
  176. package/.claude/commands/memory/README.md +9 -9
  177. package/.claude/commands/memory/memory-persist.md +25 -25
  178. package/.claude/commands/memory/memory-search.md +25 -25
  179. package/.claude/commands/memory/memory-usage.md +25 -25
  180. package/.claude/commands/memory/neural.md +47 -47
  181. package/.claude/commands/monitoring/README.md +9 -9
  182. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  183. package/.claude/commands/monitoring/agents.md +44 -44
  184. package/.claude/commands/monitoring/real-time-view.md +25 -25
  185. package/.claude/commands/monitoring/status.md +46 -46
  186. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  187. package/.claude/commands/optimization/README.md +9 -9
  188. package/.claude/commands/optimization/auto-topology.md +61 -61
  189. package/.claude/commands/optimization/cache-manage.md +25 -25
  190. package/.claude/commands/optimization/parallel-execute.md +25 -25
  191. package/.claude/commands/optimization/parallel-execution.md +49 -49
  192. package/.claude/commands/optimization/topology-optimize.md +25 -25
  193. package/.claude/commands/pair/README.md +260 -260
  194. package/.claude/commands/pair/commands.md +545 -545
  195. package/.claude/commands/pair/config.md +509 -509
  196. package/.claude/commands/pair/examples.md +511 -511
  197. package/.claude/commands/pair/modes.md +347 -347
  198. package/.claude/commands/pair/session.md +406 -406
  199. package/.claude/commands/pair/start.md +208 -208
  200. package/.claude/commands/sparc/analyzer.md +51 -51
  201. package/.claude/commands/sparc/architect.md +53 -53
  202. package/.claude/commands/sparc/ask.md +97 -97
  203. package/.claude/commands/sparc/batch-executor.md +54 -54
  204. package/.claude/commands/sparc/code.md +89 -89
  205. package/.claude/commands/sparc/coder.md +54 -54
  206. package/.claude/commands/sparc/debug.md +83 -83
  207. package/.claude/commands/sparc/debugger.md +54 -54
  208. package/.claude/commands/sparc/designer.md +53 -53
  209. package/.claude/commands/sparc/devops.md +109 -109
  210. package/.claude/commands/sparc/docs-writer.md +80 -80
  211. package/.claude/commands/sparc/documenter.md +54 -54
  212. package/.claude/commands/sparc/innovator.md +54 -54
  213. package/.claude/commands/sparc/integration.md +83 -83
  214. package/.claude/commands/sparc/mcp.md +117 -117
  215. package/.claude/commands/sparc/memory-manager.md +54 -54
  216. package/.claude/commands/sparc/optimizer.md +54 -54
  217. package/.claude/commands/sparc/orchestrator.md +131 -131
  218. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  219. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  220. package/.claude/commands/sparc/researcher.md +54 -54
  221. package/.claude/commands/sparc/reviewer.md +54 -54
  222. package/.claude/commands/sparc/security-review.md +80 -80
  223. package/.claude/commands/sparc/sparc-modes.md +174 -174
  224. package/.claude/commands/sparc/sparc.md +111 -111
  225. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  226. package/.claude/commands/sparc/supabase-admin.md +348 -348
  227. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  228. package/.claude/commands/sparc/tdd.md +54 -54
  229. package/.claude/commands/sparc/tester.md +54 -54
  230. package/.claude/commands/sparc/tutorial.md +79 -79
  231. package/.claude/commands/sparc/workflow-manager.md +54 -54
  232. package/.claude/commands/sparc.md +166 -166
  233. package/.claude/commands/stream-chain/pipeline.md +120 -120
  234. package/.claude/commands/stream-chain/run.md +69 -69
  235. package/.claude/commands/swarm/README.md +15 -15
  236. package/.claude/commands/swarm/analysis.md +95 -95
  237. package/.claude/commands/swarm/development.md +96 -96
  238. package/.claude/commands/swarm/examples.md +168 -168
  239. package/.claude/commands/swarm/maintenance.md +102 -102
  240. package/.claude/commands/swarm/optimization.md +117 -117
  241. package/.claude/commands/swarm/research.md +136 -136
  242. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  243. package/.claude/commands/swarm/swarm-background.md +8 -8
  244. package/.claude/commands/swarm/swarm-init.md +19 -19
  245. package/.claude/commands/swarm/swarm-modes.md +8 -8
  246. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  247. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  248. package/.claude/commands/swarm/swarm-status.md +8 -8
  249. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  250. package/.claude/commands/swarm/swarm.md +27 -27
  251. package/.claude/commands/swarm/testing.md +131 -131
  252. package/.claude/commands/training/README.md +9 -9
  253. package/.claude/commands/training/model-update.md +25 -25
  254. package/.claude/commands/training/neural-patterns.md +73 -73
  255. package/.claude/commands/training/neural-train.md +25 -25
  256. package/.claude/commands/training/pattern-learn.md +25 -25
  257. package/.claude/commands/training/specialization.md +62 -62
  258. package/.claude/commands/truth/start.md +142 -142
  259. package/.claude/commands/verify/check.md +49 -49
  260. package/.claude/commands/verify/start.md +127 -127
  261. package/.claude/commands/workflows/README.md +9 -9
  262. package/.claude/commands/workflows/development.md +77 -77
  263. package/.claude/commands/workflows/research.md +62 -62
  264. package/.claude/commands/workflows/workflow-create.md +25 -25
  265. package/.claude/commands/workflows/workflow-execute.md +25 -25
  266. package/.claude/commands/workflows/workflow-export.md +25 -25
  267. package/.claude/config/v3-dependency-optimization.json +265 -265
  268. package/.claude/config/v3-performance-targets.json +250 -250
  269. package/.claude/helpers/README.md +96 -96
  270. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  271. package/.claude/helpers/auto-memory-hook.mjs +363 -363
  272. package/.claude/helpers/context-persistence-hook.mjs +1979 -1979
  273. package/.claude/helpers/github-safe.js +106 -106
  274. package/.claude/helpers/learning-service.mjs +1144 -1144
  275. package/.claude/helpers/metrics-db.mjs +488 -488
  276. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  277. package/.claude/mcp.json +12 -12
  278. package/.claude/settings.json +2 -2
  279. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  280. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  281. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  282. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  283. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  284. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  285. package/.claude/skills/dual-mode/README.md +71 -71
  286. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  287. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  288. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  289. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  290. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  291. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  292. package/.claude/skills/github-code-review/SKILL.md +1 -1
  293. package/.claude/skills/github-multi-repo/SKILL.md +2 -2
  294. package/.claude/skills/github-project-management/SKILL.md +1 -1
  295. package/.claude/skills/github-release-management/SKILL.md +2 -2
  296. package/.claude/skills/github-workflow-automation/SKILL.md +1 -1
  297. package/.claude/skills/hive-mind-advanced/SKILL.md +4 -4
  298. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  299. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  300. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  301. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  302. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  303. package/.claude/skills/skill-builder/SKILL.md +910 -910
  304. package/.claude/skills/sparc-methodology/SKILL.md +2 -2
  305. package/.claude/skills/stream-chain/SKILL.md +563 -563
  306. package/.claude/skills/swarm-advanced/SKILL.md +4 -4
  307. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  308. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  309. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  310. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  311. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  312. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  313. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  314. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  315. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  316. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  317. package/.claude/skills/verification-quality/SKILL.md +649 -649
  318. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  319. package/.claude/skills/worker-integration/skill.md +154 -154
  320. package/.claude/statusline.mjs +109 -109
  321. package/.claude-plugin/README.md +6 -6
  322. package/.claude-plugin/docs/INSTALLATION.md +4 -4
  323. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +5 -5
  324. package/.claude-plugin/docs/QUICKSTART.md +1 -1
  325. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  326. package/.claude-plugin/hooks/hooks.json +74 -74
  327. package/.claude-plugin/marketplace.json +5 -5
  328. package/.claude-plugin/plugin.json +4 -4
  329. package/README.md +148 -148
  330. package/bin/cli.js +12 -12
  331. package/bin/npx-repair.js +7 -7
  332. package/bin/npx-safe-launch.js +9 -9
  333. package/package.json +115 -114
  334. package/v3/@claude-flow/cli/README.md +5 -5
  335. package/v3/@claude-flow/cli/bin/cli.js +156 -156
  336. package/v3/@claude-flow/cli/bin/mcp-server.js +189 -189
  337. package/v3/@claude-flow/cli/dist/src/commands/analyze.d.ts +1 -1
  338. package/v3/@claude-flow/cli/dist/src/commands/analyze.js +1 -1
  339. package/v3/@claude-flow/cli/dist/src/commands/claims.d.ts +1 -1
  340. package/v3/@claude-flow/cli/dist/src/commands/claims.js +2 -2
  341. package/v3/@claude-flow/cli/dist/src/commands/completions.d.ts +1 -1
  342. package/v3/@claude-flow/cli/dist/src/commands/completions.js +1 -1
  343. package/v3/@claude-flow/cli/dist/src/commands/config.js +36 -2
  344. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +54 -7
  345. package/v3/@claude-flow/cli/dist/src/commands/deployment.d.ts +1 -1
  346. package/v3/@claude-flow/cli/dist/src/commands/deployment.js +2 -2
  347. package/v3/@claude-flow/cli/dist/src/commands/doctor.d.ts +1 -1
  348. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +1 -1
  349. package/v3/@claude-flow/cli/dist/src/commands/embeddings.d.ts +1 -1
  350. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +2 -2
  351. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  352. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +30 -112
  353. package/v3/@claude-flow/cli/dist/src/commands/init.js +6 -1
  354. package/v3/@claude-flow/cli/dist/src/commands/memory.js +30 -30
  355. package/v3/@claude-flow/cli/dist/src/commands/neural.d.ts +1 -1
  356. package/v3/@claude-flow/cli/dist/src/commands/neural.js +2 -2
  357. package/v3/@claude-flow/cli/dist/src/commands/orc.js +1 -0
  358. package/v3/@claude-flow/cli/dist/src/commands/performance.d.ts +1 -1
  359. package/v3/@claude-flow/cli/dist/src/commands/performance.js +2 -2
  360. package/v3/@claude-flow/cli/dist/src/commands/plugins.d.ts +1 -1
  361. package/v3/@claude-flow/cli/dist/src/commands/plugins.js +2 -2
  362. package/v3/@claude-flow/cli/dist/src/commands/providers.d.ts +1 -1
  363. package/v3/@claude-flow/cli/dist/src/commands/providers.js +2 -2
  364. package/v3/@claude-flow/cli/dist/src/commands/route.d.ts +1 -1
  365. package/v3/@claude-flow/cli/dist/src/commands/route.js +1 -1
  366. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  367. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +29 -29
  368. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.d.ts +1 -1
  369. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +1 -1
  370. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.d.ts +1 -1
  371. package/v3/@claude-flow/cli/dist/src/commands/ruvector/index.js +1 -1
  372. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +113 -113
  373. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +97 -97
  374. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  375. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.d.ts +1 -1
  376. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +2 -2
  377. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +36 -36
  378. package/v3/@claude-flow/cli/dist/src/commands/security.d.ts +1 -1
  379. package/v3/@claude-flow/cli/dist/src/commands/security.js +2 -2
  380. package/v3/@claude-flow/cli/dist/src/config/moflo-config.d.ts +13 -1
  381. package/v3/@claude-flow/cli/dist/src/config/moflo-config.js +93 -41
  382. package/v3/@claude-flow/cli/dist/src/index.d.ts +1 -1
  383. package/v3/@claude-flow/cli/dist/src/index.js +2 -2
  384. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +2 -2
  385. package/v3/@claude-flow/cli/dist/src/init/executor.js +3 -3
  386. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +640 -640
  387. package/v3/@claude-flow/cli/dist/src/init/moflo-init.d.ts +10 -0
  388. package/v3/@claude-flow/cli/dist/src/init/moflo-init.js +101 -20
  389. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +2 -2
  390. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +783 -783
  391. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +30 -13
  392. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.d.ts +1 -1
  393. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +1 -1
  394. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +61 -61
  395. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +2212 -2263
  396. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  397. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +1 -1
  398. package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +1 -1
  399. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.d.ts +1 -1
  400. package/v3/@claude-flow/cli/dist/src/ruvector/vector-db.js +1 -1
  401. package/v3/@claude-flow/cli/dist/src/services/agent-router.d.ts +14 -0
  402. package/v3/@claude-flow/cli/dist/src/services/agent-router.js +86 -7
  403. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  404. package/v3/@claude-flow/cli/dist/src/services/index.d.ts +1 -3
  405. package/v3/@claude-flow/cli/dist/src/services/index.js +1 -2
  406. package/v3/@claude-flow/cli/dist/src/services/learning-service.js +54 -54
  407. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.d.ts +1 -1
  408. package/v3/@claude-flow/cli/dist/src/services/ruvector-training.js +1 -1
  409. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +24 -3
  410. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +123 -12
  411. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.d.ts +1 -0
  412. package/v3/@claude-flow/cli/dist/src/services/workflow-gate.js +20 -5
  413. package/v3/@claude-flow/cli/dist/src/suggest.d.ts +1 -1
  414. package/v3/@claude-flow/cli/dist/src/suggest.js +1 -1
  415. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  416. package/v3/@claude-flow/cli/package.json +6 -6
  417. package/v3/@claude-flow/guidance/README.md +6 -6
  418. package/v3/@claude-flow/guidance/package.json +1 -1
  419. package/v3/@claude-flow/memory/README.md +1 -1
  420. package/v3/@claude-flow/shared/README.md +1 -1
  421. package/v3/@claude-flow/shared/package.json +42 -42
  422. package/v3/README.md +3 -3
@@ -1,442 +1,442 @@
1
- ---
2
- name: "V3 DDD Architecture"
3
- description: "Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern."
4
- ---
5
-
6
- # V3 DDD Architecture
7
-
8
- ## What This Skill Does
9
-
10
- Designs and implements Domain-Driven Design (DDD) architecture for claude-flow v3, decomposing god objects into bounded contexts, implementing clean architecture patterns, and enabling modular, testable code structure.
11
-
12
- ## Quick Start
13
-
14
- ```bash
15
- # Initialize DDD architecture analysis
16
- Task("Architecture analysis", "Analyze current architecture and design DDD boundaries", "core-architect")
17
-
18
- # Domain modeling (parallel)
19
- Task("Domain decomposition", "Break down orchestrator god object into domains", "core-architect")
20
- Task("Context mapping", "Map bounded contexts and relationships", "core-architect")
21
- Task("Interface design", "Design clean domain interfaces", "core-architect")
22
- ```
23
-
24
- ## DDD Implementation Strategy
25
-
26
- ### Current Architecture Analysis
27
- ```
28
- ├── PROBLEMATIC: core/orchestrator.ts (1,440 lines - GOD OBJECT)
29
- │ ├── Task management responsibilities
30
- │ ├── Session management responsibilities
31
- │ ├── Health monitoring responsibilities
32
- │ ├── Lifecycle management responsibilities
33
- │ └── Event coordination responsibilities
34
-
35
- └── TARGET: Modular DDD Architecture
36
- ├── core/domains/
37
- │ ├── task-management/
38
- │ ├── session-management/
39
- │ ├── health-monitoring/
40
- │ ├── lifecycle-management/
41
- │ └── event-coordination/
42
- └── core/shared/
43
- ├── interfaces/
44
- ├── value-objects/
45
- └── domain-events/
46
- ```
47
-
48
- ### Domain Boundaries
49
-
50
- #### 1. Task Management Domain
51
- ```typescript
52
- // core/domains/task-management/
53
- interface TaskManagementDomain {
54
- // Entities
55
- Task: TaskEntity;
56
- TaskQueue: TaskQueueEntity;
57
-
58
- // Value Objects
59
- TaskId: TaskIdVO;
60
- TaskStatus: TaskStatusVO;
61
- Priority: PriorityVO;
62
-
63
- // Services
64
- TaskScheduler: TaskSchedulingService;
65
- TaskValidator: TaskValidationService;
66
-
67
- // Repository
68
- TaskRepository: ITaskRepository;
69
- }
70
- ```
71
-
72
- #### 2. Session Management Domain
73
- ```typescript
74
- // core/domains/session-management/
75
- interface SessionManagementDomain {
76
- // Entities
77
- Session: SessionEntity;
78
- SessionState: SessionStateEntity;
79
-
80
- // Value Objects
81
- SessionId: SessionIdVO;
82
- SessionStatus: SessionStatusVO;
83
-
84
- // Services
85
- SessionLifecycle: SessionLifecycleService;
86
- SessionPersistence: SessionPersistenceService;
87
-
88
- // Repository
89
- SessionRepository: ISessionRepository;
90
- }
91
- ```
92
-
93
- #### 3. Health Monitoring Domain
94
- ```typescript
95
- // core/domains/health-monitoring/
96
- interface HealthMonitoringDomain {
97
- // Entities
98
- HealthCheck: HealthCheckEntity;
99
- Metric: MetricEntity;
100
-
101
- // Value Objects
102
- HealthStatus: HealthStatusVO;
103
- Threshold: ThresholdVO;
104
-
105
- // Services
106
- HealthCollector: HealthCollectionService;
107
- AlertManager: AlertManagementService;
108
-
109
- // Repository
110
- MetricsRepository: IMetricsRepository;
111
- }
112
- ```
113
-
114
- ## Microkernel Architecture Pattern
115
-
116
- ### Core Kernel
117
- ```typescript
118
- // core/kernel/claude-flow-kernel.ts
119
- export class ClaudeFlowKernel {
120
- private domains: Map<string, Domain> = new Map();
121
- private eventBus: DomainEventBus;
122
- private dependencyContainer: Container;
123
-
124
- async initialize(): Promise<void> {
125
- // Load core domains
126
- await this.loadDomain('task-management', new TaskManagementDomain());
127
- await this.loadDomain('session-management', new SessionManagementDomain());
128
- await this.loadDomain('health-monitoring', new HealthMonitoringDomain());
129
-
130
- // Wire up domain events
131
- this.setupDomainEventHandlers();
132
- }
133
-
134
- async loadDomain(name: string, domain: Domain): Promise<void> {
135
- await domain.initialize(this.dependencyContainer);
136
- this.domains.set(name, domain);
137
- }
138
-
139
- getDomain<T extends Domain>(name: string): T {
140
- const domain = this.domains.get(name);
141
- if (!domain) {
142
- throw new DomainNotLoadedError(name);
143
- }
144
- return domain as T;
145
- }
146
- }
147
- ```
148
-
149
- ### Plugin Architecture
150
- ```typescript
151
- // core/plugins/
152
- interface DomainPlugin {
153
- name: string;
154
- version: string;
155
- dependencies: string[];
156
-
157
- initialize(kernel: ClaudeFlowKernel): Promise<void>;
158
- shutdown(): Promise<void>;
159
- }
160
-
161
- // Example: Swarm Coordination Plugin
162
- export class SwarmCoordinationPlugin implements DomainPlugin {
163
- name = 'swarm-coordination';
164
- version = '3.0.0';
165
- dependencies = ['task-management', 'session-management'];
166
-
167
- async initialize(kernel: ClaudeFlowKernel): Promise<void> {
168
- const taskDomain = kernel.getDomain<TaskManagementDomain>('task-management');
169
- const sessionDomain = kernel.getDomain<SessionManagementDomain>('session-management');
170
-
171
- // Register swarm coordination services
172
- this.swarmCoordinator = new UnifiedSwarmCoordinator(taskDomain, sessionDomain);
173
- kernel.registerService('swarm-coordinator', this.swarmCoordinator);
174
- }
175
- }
176
- ```
177
-
178
- ## Domain Events & Integration
179
-
180
- ### Event-Driven Communication
181
- ```typescript
182
- // core/shared/domain-events/
183
- abstract class DomainEvent {
184
- public readonly eventId: string;
185
- public readonly aggregateId: string;
186
- public readonly occurredOn: Date;
187
- public readonly eventVersion: number;
188
-
189
- constructor(aggregateId: string) {
190
- this.eventId = crypto.randomUUID();
191
- this.aggregateId = aggregateId;
192
- this.occurredOn = new Date();
193
- this.eventVersion = 1;
194
- }
195
- }
196
-
197
- // Task domain events
198
- export class TaskAssignedEvent extends DomainEvent {
199
- constructor(
200
- taskId: string,
201
- public readonly agentId: string,
202
- public readonly priority: Priority
203
- ) {
204
- super(taskId);
205
- }
206
- }
207
-
208
- export class TaskCompletedEvent extends DomainEvent {
209
- constructor(
210
- taskId: string,
211
- public readonly result: TaskResult,
212
- public readonly duration: number
213
- ) {
214
- super(taskId);
215
- }
216
- }
217
-
218
- // Event handlers
219
- @EventHandler(TaskCompletedEvent)
220
- export class TaskCompletedHandler {
221
- constructor(
222
- private metricsRepository: IMetricsRepository,
223
- private sessionService: SessionLifecycleService
224
- ) {}
225
-
226
- async handle(event: TaskCompletedEvent): Promise<void> {
227
- // Update metrics
228
- await this.metricsRepository.recordTaskCompletion(
229
- event.aggregateId,
230
- event.duration
231
- );
232
-
233
- // Update session state
234
- await this.sessionService.markTaskCompleted(
235
- event.aggregateId,
236
- event.result
237
- );
238
- }
239
- }
240
- ```
241
-
242
- ## Clean Architecture Layers
243
-
244
- ```typescript
245
- // Architecture layers
246
- ┌─────────────────────────────────────────┐
247
- │ Presentation │ ← CLI, API, UI
248
- ├─────────────────────────────────────────┤
249
- │ Application │ ← Use Cases, Commands
250
- ├─────────────────────────────────────────┤
251
- │ Domain │ ← Entities, Services, Events
252
- ├─────────────────────────────────────────┤
253
- │ Infrastructure │ ← DB, MCP, External APIs
254
- └─────────────────────────────────────────┘
255
-
256
- // Dependency direction: Outside → Inside
257
- // Domain layer has NO external dependencies
258
- ```
259
-
260
- ### Application Layer (Use Cases)
261
- ```typescript
262
- // core/application/use-cases/
263
- export class AssignTaskUseCase {
264
- constructor(
265
- private taskRepository: ITaskRepository,
266
- private agentRepository: IAgentRepository,
267
- private eventBus: DomainEventBus
268
- ) {}
269
-
270
- async execute(command: AssignTaskCommand): Promise<TaskResult> {
271
- // 1. Validate command
272
- await this.validateCommand(command);
273
-
274
- // 2. Load aggregates
275
- const task = await this.taskRepository.findById(command.taskId);
276
- const agent = await this.agentRepository.findById(command.agentId);
277
-
278
- // 3. Business logic (in domain)
279
- task.assignTo(agent);
280
-
281
- // 4. Persist changes
282
- await this.taskRepository.save(task);
283
-
284
- // 5. Publish domain events
285
- task.getUncommittedEvents().forEach(event =>
286
- this.eventBus.publish(event)
287
- );
288
-
289
- // 6. Return result
290
- return TaskResult.success(task);
291
- }
292
- }
293
- ```
294
-
295
- ## Module Configuration
296
-
297
- ### Bounded Context Modules
298
- ```typescript
299
- // core/domains/task-management/module.ts
300
- export const taskManagementModule = {
301
- name: 'task-management',
302
-
303
- entities: [
304
- TaskEntity,
305
- TaskQueueEntity
306
- ],
307
-
308
- valueObjects: [
309
- TaskIdVO,
310
- TaskStatusVO,
311
- PriorityVO
312
- ],
313
-
314
- services: [
315
- TaskSchedulingService,
316
- TaskValidationService
317
- ],
318
-
319
- repositories: [
320
- { provide: ITaskRepository, useClass: SqliteTaskRepository }
321
- ],
322
-
323
- eventHandlers: [
324
- TaskAssignedHandler,
325
- TaskCompletedHandler
326
- ]
327
- };
328
- ```
329
-
330
- ## Migration Strategy
331
-
332
- ### Phase 1: Extract Domain Services
333
- ```typescript
334
- // Extract services from orchestrator.ts
335
- const extractionPlan = {
336
- week1: [
337
- 'TaskManager → task-management domain',
338
- 'SessionManager → session-management domain'
339
- ],
340
- week2: [
341
- 'HealthMonitor → health-monitoring domain',
342
- 'LifecycleManager → lifecycle-management domain'
343
- ],
344
- week3: [
345
- 'EventCoordinator → event-coordination domain',
346
- 'Wire up domain events'
347
- ]
348
- };
349
- ```
350
-
351
- ### Phase 2: Implement Clean Interfaces
352
- ```typescript
353
- // Clean separation with dependency injection
354
- export class TaskController {
355
- constructor(
356
- @Inject('AssignTaskUseCase') private assignTask: AssignTaskUseCase,
357
- @Inject('CompleteTaskUseCase') private completeTask: CompleteTaskUseCase
358
- ) {}
359
-
360
- async assign(request: AssignTaskRequest): Promise<TaskResponse> {
361
- const command = AssignTaskCommand.fromRequest(request);
362
- const result = await this.assignTask.execute(command);
363
- return TaskResponse.fromResult(result);
364
- }
365
- }
366
- ```
367
-
368
- ### Phase 3: Plugin System
369
- ```typescript
370
- // Enable plugin-based extensions
371
- const pluginSystem = {
372
- core: ['task-management', 'session-management', 'health-monitoring'],
373
- optional: ['swarm-coordination', 'learning-integration', 'performance-monitoring']
374
- };
375
- ```
376
-
377
- ## Testing Strategy
378
-
379
- ### Domain Testing (London School TDD)
380
- ```typescript
381
- // Pure domain logic testing
382
- describe('Task Entity', () => {
383
- let task: TaskEntity;
384
- let mockAgent: jest.Mocked<AgentEntity>;
385
-
386
- beforeEach(() => {
387
- task = new TaskEntity(TaskId.create(), 'Test task');
388
- mockAgent = createMock<AgentEntity>();
389
- });
390
-
391
- it('should assign to agent when valid', () => {
392
- mockAgent.canAcceptTask.mockReturnValue(true);
393
-
394
- task.assignTo(mockAgent);
395
-
396
- expect(task.assignedAgent).toBe(mockAgent);
397
- expect(task.status.value).toBe('assigned');
398
- });
399
-
400
- it('should emit TaskAssignedEvent when assigned', () => {
401
- mockAgent.canAcceptTask.mockReturnValue(true);
402
-
403
- task.assignTo(mockAgent);
404
-
405
- const events = task.getUncommittedEvents();
406
- expect(events).toHaveLength(1);
407
- expect(events[0]).toBeInstanceOf(TaskAssignedEvent);
408
- });
409
- });
410
- ```
411
-
412
- ## Success Metrics
413
-
414
- - [ ] **God Object Elimination**: orchestrator.ts (1,440 lines) → 5 focused domains (<300 lines each)
415
- - [ ] **Bounded Context Isolation**: 100% domain independence
416
- - [ ] **Plugin Architecture**: Core + optional modules loading
417
- - [ ] **Clean Architecture**: Dependency inversion maintained
418
- - [ ] **Event-Driven Communication**: Loose coupling between domains
419
- - [ ] **Test Coverage**: >90% domain logic coverage
420
-
421
- ## Related V3 Skills
422
-
423
- - `v3-core-implementation` - Implementation of DDD domains
424
- - `v3-memory-unification` - AgentDB integration within bounded contexts
425
- - `v3-swarm-coordination` - Swarm coordination as domain plugin
426
- - `v3-performance-optimization` - Performance optimization across domains
427
-
428
- ## Usage Examples
429
-
430
- ### Complete Domain Extraction
431
- ```bash
432
- # Full DDD architecture implementation
433
- Task("DDD architecture implementation",
434
- "Extract orchestrator into DDD domains with clean architecture",
435
- "core-architect")
436
- ```
437
-
438
- ### Plugin Development
439
- ```bash
440
- # Create domain plugin
441
- npm run create:plugin -- --name swarm-coordination --template domain
1
+ ---
2
+ name: "V3 DDD Architecture"
3
+ description: "Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern."
4
+ ---
5
+
6
+ # V3 DDD Architecture
7
+
8
+ ## What This Skill Does
9
+
10
+ Designs and implements Domain-Driven Design (DDD) architecture for claude-flow v3, decomposing god objects into bounded contexts, implementing clean architecture patterns, and enabling modular, testable code structure.
11
+
12
+ ## Quick Start
13
+
14
+ ```bash
15
+ # Initialize DDD architecture analysis
16
+ Task("Architecture analysis", "Analyze current architecture and design DDD boundaries", "core-architect")
17
+
18
+ # Domain modeling (parallel)
19
+ Task("Domain decomposition", "Break down orchestrator god object into domains", "core-architect")
20
+ Task("Context mapping", "Map bounded contexts and relationships", "core-architect")
21
+ Task("Interface design", "Design clean domain interfaces", "core-architect")
22
+ ```
23
+
24
+ ## DDD Implementation Strategy
25
+
26
+ ### Current Architecture Analysis
27
+ ```
28
+ ├── PROBLEMATIC: core/orchestrator.ts (1,440 lines - GOD OBJECT)
29
+ │ ├── Task management responsibilities
30
+ │ ├── Session management responsibilities
31
+ │ ├── Health monitoring responsibilities
32
+ │ ├── Lifecycle management responsibilities
33
+ │ └── Event coordination responsibilities
34
+
35
+ └── TARGET: Modular DDD Architecture
36
+ ├── core/domains/
37
+ │ ├── task-management/
38
+ │ ├── session-management/
39
+ │ ├── health-monitoring/
40
+ │ ├── lifecycle-management/
41
+ │ └── event-coordination/
42
+ └── core/shared/
43
+ ├── interfaces/
44
+ ├── value-objects/
45
+ └── domain-events/
46
+ ```
47
+
48
+ ### Domain Boundaries
49
+
50
+ #### 1. Task Management Domain
51
+ ```typescript
52
+ // core/domains/task-management/
53
+ interface TaskManagementDomain {
54
+ // Entities
55
+ Task: TaskEntity;
56
+ TaskQueue: TaskQueueEntity;
57
+
58
+ // Value Objects
59
+ TaskId: TaskIdVO;
60
+ TaskStatus: TaskStatusVO;
61
+ Priority: PriorityVO;
62
+
63
+ // Services
64
+ TaskScheduler: TaskSchedulingService;
65
+ TaskValidator: TaskValidationService;
66
+
67
+ // Repository
68
+ TaskRepository: ITaskRepository;
69
+ }
70
+ ```
71
+
72
+ #### 2. Session Management Domain
73
+ ```typescript
74
+ // core/domains/session-management/
75
+ interface SessionManagementDomain {
76
+ // Entities
77
+ Session: SessionEntity;
78
+ SessionState: SessionStateEntity;
79
+
80
+ // Value Objects
81
+ SessionId: SessionIdVO;
82
+ SessionStatus: SessionStatusVO;
83
+
84
+ // Services
85
+ SessionLifecycle: SessionLifecycleService;
86
+ SessionPersistence: SessionPersistenceService;
87
+
88
+ // Repository
89
+ SessionRepository: ISessionRepository;
90
+ }
91
+ ```
92
+
93
+ #### 3. Health Monitoring Domain
94
+ ```typescript
95
+ // core/domains/health-monitoring/
96
+ interface HealthMonitoringDomain {
97
+ // Entities
98
+ HealthCheck: HealthCheckEntity;
99
+ Metric: MetricEntity;
100
+
101
+ // Value Objects
102
+ HealthStatus: HealthStatusVO;
103
+ Threshold: ThresholdVO;
104
+
105
+ // Services
106
+ HealthCollector: HealthCollectionService;
107
+ AlertManager: AlertManagementService;
108
+
109
+ // Repository
110
+ MetricsRepository: IMetricsRepository;
111
+ }
112
+ ```
113
+
114
+ ## Microkernel Architecture Pattern
115
+
116
+ ### Core Kernel
117
+ ```typescript
118
+ // core/kernel/claude-flow-kernel.ts
119
+ export class ClaudeFlowKernel {
120
+ private domains: Map<string, Domain> = new Map();
121
+ private eventBus: DomainEventBus;
122
+ private dependencyContainer: Container;
123
+
124
+ async initialize(): Promise<void> {
125
+ // Load core domains
126
+ await this.loadDomain('task-management', new TaskManagementDomain());
127
+ await this.loadDomain('session-management', new SessionManagementDomain());
128
+ await this.loadDomain('health-monitoring', new HealthMonitoringDomain());
129
+
130
+ // Wire up domain events
131
+ this.setupDomainEventHandlers();
132
+ }
133
+
134
+ async loadDomain(name: string, domain: Domain): Promise<void> {
135
+ await domain.initialize(this.dependencyContainer);
136
+ this.domains.set(name, domain);
137
+ }
138
+
139
+ getDomain<T extends Domain>(name: string): T {
140
+ const domain = this.domains.get(name);
141
+ if (!domain) {
142
+ throw new DomainNotLoadedError(name);
143
+ }
144
+ return domain as T;
145
+ }
146
+ }
147
+ ```
148
+
149
+ ### Plugin Architecture
150
+ ```typescript
151
+ // core/plugins/
152
+ interface DomainPlugin {
153
+ name: string;
154
+ version: string;
155
+ dependencies: string[];
156
+
157
+ initialize(kernel: ClaudeFlowKernel): Promise<void>;
158
+ shutdown(): Promise<void>;
159
+ }
160
+
161
+ // Example: Swarm Coordination Plugin
162
+ export class SwarmCoordinationPlugin implements DomainPlugin {
163
+ name = 'swarm-coordination';
164
+ version = '3.0.0';
165
+ dependencies = ['task-management', 'session-management'];
166
+
167
+ async initialize(kernel: ClaudeFlowKernel): Promise<void> {
168
+ const taskDomain = kernel.getDomain<TaskManagementDomain>('task-management');
169
+ const sessionDomain = kernel.getDomain<SessionManagementDomain>('session-management');
170
+
171
+ // Register swarm coordination services
172
+ this.swarmCoordinator = new UnifiedSwarmCoordinator(taskDomain, sessionDomain);
173
+ kernel.registerService('swarm-coordinator', this.swarmCoordinator);
174
+ }
175
+ }
176
+ ```
177
+
178
+ ## Domain Events & Integration
179
+
180
+ ### Event-Driven Communication
181
+ ```typescript
182
+ // core/shared/domain-events/
183
+ abstract class DomainEvent {
184
+ public readonly eventId: string;
185
+ public readonly aggregateId: string;
186
+ public readonly occurredOn: Date;
187
+ public readonly eventVersion: number;
188
+
189
+ constructor(aggregateId: string) {
190
+ this.eventId = crypto.randomUUID();
191
+ this.aggregateId = aggregateId;
192
+ this.occurredOn = new Date();
193
+ this.eventVersion = 1;
194
+ }
195
+ }
196
+
197
+ // Task domain events
198
+ export class TaskAssignedEvent extends DomainEvent {
199
+ constructor(
200
+ taskId: string,
201
+ public readonly agentId: string,
202
+ public readonly priority: Priority
203
+ ) {
204
+ super(taskId);
205
+ }
206
+ }
207
+
208
+ export class TaskCompletedEvent extends DomainEvent {
209
+ constructor(
210
+ taskId: string,
211
+ public readonly result: TaskResult,
212
+ public readonly duration: number
213
+ ) {
214
+ super(taskId);
215
+ }
216
+ }
217
+
218
+ // Event handlers
219
+ @EventHandler(TaskCompletedEvent)
220
+ export class TaskCompletedHandler {
221
+ constructor(
222
+ private metricsRepository: IMetricsRepository,
223
+ private sessionService: SessionLifecycleService
224
+ ) {}
225
+
226
+ async handle(event: TaskCompletedEvent): Promise<void> {
227
+ // Update metrics
228
+ await this.metricsRepository.recordTaskCompletion(
229
+ event.aggregateId,
230
+ event.duration
231
+ );
232
+
233
+ // Update session state
234
+ await this.sessionService.markTaskCompleted(
235
+ event.aggregateId,
236
+ event.result
237
+ );
238
+ }
239
+ }
240
+ ```
241
+
242
+ ## Clean Architecture Layers
243
+
244
+ ```typescript
245
+ // Architecture layers
246
+ ┌─────────────────────────────────────────┐
247
+ │ Presentation │ ← CLI, API, UI
248
+ ├─────────────────────────────────────────┤
249
+ │ Application │ ← Use Cases, Commands
250
+ ├─────────────────────────────────────────┤
251
+ │ Domain │ ← Entities, Services, Events
252
+ ├─────────────────────────────────────────┤
253
+ │ Infrastructure │ ← DB, MCP, External APIs
254
+ └─────────────────────────────────────────┘
255
+
256
+ // Dependency direction: Outside → Inside
257
+ // Domain layer has NO external dependencies
258
+ ```
259
+
260
+ ### Application Layer (Use Cases)
261
+ ```typescript
262
+ // core/application/use-cases/
263
+ export class AssignTaskUseCase {
264
+ constructor(
265
+ private taskRepository: ITaskRepository,
266
+ private agentRepository: IAgentRepository,
267
+ private eventBus: DomainEventBus
268
+ ) {}
269
+
270
+ async execute(command: AssignTaskCommand): Promise<TaskResult> {
271
+ // 1. Validate command
272
+ await this.validateCommand(command);
273
+
274
+ // 2. Load aggregates
275
+ const task = await this.taskRepository.findById(command.taskId);
276
+ const agent = await this.agentRepository.findById(command.agentId);
277
+
278
+ // 3. Business logic (in domain)
279
+ task.assignTo(agent);
280
+
281
+ // 4. Persist changes
282
+ await this.taskRepository.save(task);
283
+
284
+ // 5. Publish domain events
285
+ task.getUncommittedEvents().forEach(event =>
286
+ this.eventBus.publish(event)
287
+ );
288
+
289
+ // 6. Return result
290
+ return TaskResult.success(task);
291
+ }
292
+ }
293
+ ```
294
+
295
+ ## Module Configuration
296
+
297
+ ### Bounded Context Modules
298
+ ```typescript
299
+ // core/domains/task-management/module.ts
300
+ export const taskManagementModule = {
301
+ name: 'task-management',
302
+
303
+ entities: [
304
+ TaskEntity,
305
+ TaskQueueEntity
306
+ ],
307
+
308
+ valueObjects: [
309
+ TaskIdVO,
310
+ TaskStatusVO,
311
+ PriorityVO
312
+ ],
313
+
314
+ services: [
315
+ TaskSchedulingService,
316
+ TaskValidationService
317
+ ],
318
+
319
+ repositories: [
320
+ { provide: ITaskRepository, useClass: SqliteTaskRepository }
321
+ ],
322
+
323
+ eventHandlers: [
324
+ TaskAssignedHandler,
325
+ TaskCompletedHandler
326
+ ]
327
+ };
328
+ ```
329
+
330
+ ## Migration Strategy
331
+
332
+ ### Phase 1: Extract Domain Services
333
+ ```typescript
334
+ // Extract services from orchestrator.ts
335
+ const extractionPlan = {
336
+ week1: [
337
+ 'TaskManager → task-management domain',
338
+ 'SessionManager → session-management domain'
339
+ ],
340
+ week2: [
341
+ 'HealthMonitor → health-monitoring domain',
342
+ 'LifecycleManager → lifecycle-management domain'
343
+ ],
344
+ week3: [
345
+ 'EventCoordinator → event-coordination domain',
346
+ 'Wire up domain events'
347
+ ]
348
+ };
349
+ ```
350
+
351
+ ### Phase 2: Implement Clean Interfaces
352
+ ```typescript
353
+ // Clean separation with dependency injection
354
+ export class TaskController {
355
+ constructor(
356
+ @Inject('AssignTaskUseCase') private assignTask: AssignTaskUseCase,
357
+ @Inject('CompleteTaskUseCase') private completeTask: CompleteTaskUseCase
358
+ ) {}
359
+
360
+ async assign(request: AssignTaskRequest): Promise<TaskResponse> {
361
+ const command = AssignTaskCommand.fromRequest(request);
362
+ const result = await this.assignTask.execute(command);
363
+ return TaskResponse.fromResult(result);
364
+ }
365
+ }
366
+ ```
367
+
368
+ ### Phase 3: Plugin System
369
+ ```typescript
370
+ // Enable plugin-based extensions
371
+ const pluginSystem = {
372
+ core: ['task-management', 'session-management', 'health-monitoring'],
373
+ optional: ['swarm-coordination', 'learning-integration', 'performance-monitoring']
374
+ };
375
+ ```
376
+
377
+ ## Testing Strategy
378
+
379
+ ### Domain Testing (London School TDD)
380
+ ```typescript
381
+ // Pure domain logic testing
382
+ describe('Task Entity', () => {
383
+ let task: TaskEntity;
384
+ let mockAgent: jest.Mocked<AgentEntity>;
385
+
386
+ beforeEach(() => {
387
+ task = new TaskEntity(TaskId.create(), 'Test task');
388
+ mockAgent = createMock<AgentEntity>();
389
+ });
390
+
391
+ it('should assign to agent when valid', () => {
392
+ mockAgent.canAcceptTask.mockReturnValue(true);
393
+
394
+ task.assignTo(mockAgent);
395
+
396
+ expect(task.assignedAgent).toBe(mockAgent);
397
+ expect(task.status.value).toBe('assigned');
398
+ });
399
+
400
+ it('should emit TaskAssignedEvent when assigned', () => {
401
+ mockAgent.canAcceptTask.mockReturnValue(true);
402
+
403
+ task.assignTo(mockAgent);
404
+
405
+ const events = task.getUncommittedEvents();
406
+ expect(events).toHaveLength(1);
407
+ expect(events[0]).toBeInstanceOf(TaskAssignedEvent);
408
+ });
409
+ });
410
+ ```
411
+
412
+ ## Success Metrics
413
+
414
+ - [ ] **God Object Elimination**: orchestrator.ts (1,440 lines) → 5 focused domains (<300 lines each)
415
+ - [ ] **Bounded Context Isolation**: 100% domain independence
416
+ - [ ] **Plugin Architecture**: Core + optional modules loading
417
+ - [ ] **Clean Architecture**: Dependency inversion maintained
418
+ - [ ] **Event-Driven Communication**: Loose coupling between domains
419
+ - [ ] **Test Coverage**: >90% domain logic coverage
420
+
421
+ ## Related V3 Skills
422
+
423
+ - `v3-core-implementation` - Implementation of DDD domains
424
+ - `v3-memory-unification` - AgentDB integration within bounded contexts
425
+ - `v3-swarm-coordination` - Swarm coordination as domain plugin
426
+ - `v3-performance-optimization` - Performance optimization across domains
427
+
428
+ ## Usage Examples
429
+
430
+ ### Complete Domain Extraction
431
+ ```bash
432
+ # Full DDD architecture implementation
433
+ Task("DDD architecture implementation",
434
+ "Extract orchestrator into DDD domains with clean architecture",
435
+ "core-architect")
436
+ ```
437
+
438
+ ### Plugin Development
439
+ ```bash
440
+ # Create domain plugin
441
+ npm run create:plugin -- --name swarm-coordination --template domain
442
442
  ```