claude-flow 3.42.3 → 3.42.4

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 (463) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  27. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +337 -337
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +550 -550
  48. package/.claude/agents/github/swarm-pr.md +401 -401
  49. package/.claude/agents/github/sync-coordinator.md +424 -424
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/.LOCKED +2 -2
  281. package/.claude/helpers/README.md +96 -96
  282. package/.claude/helpers/adr-compliance.sh +186 -186
  283. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  284. package/.claude/helpers/auto-commit.sh +178 -178
  285. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  286. package/.claude/helpers/checkpoint-manager.sh +251 -251
  287. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  288. package/.claude/helpers/daemon-manager.sh +252 -252
  289. package/.claude/helpers/ddd-tracker.sh +144 -144
  290. package/.claude/helpers/github-safe.js +156 -156
  291. package/.claude/helpers/github-setup.sh +45 -45
  292. package/.claude/helpers/guidance-hook.sh +13 -13
  293. package/.claude/helpers/guidance-hooks.sh +102 -102
  294. package/.claude/helpers/health-monitor.sh +108 -108
  295. package/.claude/helpers/hook-handler.cjs +606 -606
  296. package/.claude/helpers/intelligence.cjs +1169 -1169
  297. package/.claude/helpers/learning-hooks.sh +329 -329
  298. package/.claude/helpers/learning-optimizer.sh +127 -127
  299. package/.claude/helpers/learning-service.mjs +1144 -1144
  300. package/.claude/helpers/memory.cjs +84 -84
  301. package/.claude/helpers/metrics-db.mjs +503 -503
  302. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  303. package/.claude/helpers/pattern-consolidator.sh +86 -86
  304. package/.claude/helpers/perf-worker.sh +160 -160
  305. package/.claude/helpers/quick-start.sh +19 -19
  306. package/.claude/helpers/router.cjs +62 -62
  307. package/.claude/helpers/security-scanner.sh +127 -127
  308. package/.claude/helpers/session.cjs +125 -125
  309. package/.claude/helpers/setup-mcp.sh +18 -18
  310. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  311. package/.claude/helpers/statusline.cjs +0 -0
  312. package/.claude/helpers/swarm-comms.sh +353 -353
  313. package/.claude/helpers/swarm-hooks.sh +761 -761
  314. package/.claude/helpers/swarm-monitor.sh +210 -210
  315. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  316. package/.claude/helpers/update-v3-progress.sh +165 -165
  317. package/.claude/helpers/v3-quick-status.sh +57 -57
  318. package/.claude/helpers/v3.sh +110 -110
  319. package/.claude/helpers/validate-v3-config.sh +215 -215
  320. package/.claude/helpers/worker-manager.sh +170 -170
  321. package/.claude/mcp.json +12 -12
  322. package/.claude/settings.json +284 -284
  323. package/.claude/settings.json.bak +526 -526
  324. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  325. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  326. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  327. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  328. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  329. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  330. package/.claude/skills/browser/SKILL.md +204 -204
  331. package/.claude/skills/dual-mode/README.md +71 -71
  332. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  333. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  334. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  335. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  336. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  337. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  338. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  339. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  340. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  341. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  342. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  343. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  344. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  345. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  346. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  347. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  348. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  349. package/.claude/skills/skill-builder/SKILL.md +910 -910
  350. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  351. package/.claude/skills/stream-chain/SKILL.md +560 -560
  352. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  353. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  354. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  355. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  356. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  357. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  358. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  359. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  360. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  361. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  362. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  363. package/.claude/skills/verification-quality/SKILL.md +691 -691
  364. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  365. package/.claude/skills/worker-integration/SKILL.md +147 -147
  366. package/.claude/statusline-command.sh +176 -176
  367. package/.claude/statusline.mjs +109 -109
  368. package/.claude/statusline.sh +431 -431
  369. package/.claude/workflows/full-system-test.js +65 -65
  370. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  371. package/.claude/workflows/plugin-contract-audit.js +91 -91
  372. package/.claude-plugin/README.md +720 -720
  373. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  374. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  375. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  376. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  377. package/.claude-plugin/hooks/hooks.json +77 -77
  378. package/.claude-plugin/marketplace.json +204 -204
  379. package/.claude-plugin/plugin.json +71 -71
  380. package/.claude-plugin/scripts/install.sh +234 -234
  381. package/.claude-plugin/scripts/ruflo-hook.cjs +304 -304
  382. package/.claude-plugin/scripts/ruflo-hook.sh +52 -52
  383. package/.claude-plugin/scripts/uninstall.sh +36 -36
  384. package/.claude-plugin/scripts/verify.sh +108 -108
  385. package/LICENSE +21 -21
  386. package/README.md +422 -422
  387. package/bin/cli.js +11 -11
  388. package/bin/npx-repair.js +7 -7
  389. package/bin/npx-safe-launch.js +9 -9
  390. package/node_modules/@claude-flow/codex/.agents/skills/github-automation/SKILL.md +32 -32
  391. package/node_modules/@claude-flow/codex/.agents/skills/memory-management/SKILL.md +45 -45
  392. package/node_modules/@claude-flow/codex/.agents/skills/performance-analysis/SKILL.md +32 -32
  393. package/node_modules/@claude-flow/codex/.agents/skills/security-audit/SKILL.md +46 -46
  394. package/node_modules/@claude-flow/codex/.agents/skills/sparc-methodology/SKILL.md +46 -46
  395. package/node_modules/@claude-flow/codex/.agents/skills/swarm-orchestration/SKILL.md +53 -53
  396. package/node_modules/@claude-flow/codex/README.md +1044 -1044
  397. package/node_modules/@claude-flow/codex/dist/dual-mode/orchestrator.js +13 -13
  398. package/node_modules/@claude-flow/codex/dist/generators/agents-md.js +664 -664
  399. package/node_modules/@claude-flow/codex/dist/generators/config-toml.js +455 -455
  400. package/node_modules/@claude-flow/codex/dist/generators/skill-md.js +45 -45
  401. package/node_modules/@claude-flow/codex/dist/initializer.js +167 -167
  402. package/node_modules/@claude-flow/codex/dist/templates/index.js +15 -15
  403. package/node_modules/@claude-flow/mcp/README.md +429 -429
  404. package/node_modules/@claude-flow/plugin-agent-federation/README.md +49 -49
  405. package/node_modules/@claude-flow/security/README.md +292 -292
  406. package/node_modules/@claude-flow/security/dist/credential-generator.js +9 -9
  407. package/node_modules/@claude-flow/security/dist/input-validator.d.ts +6 -6
  408. package/node_modules/@claude-flow/security/dist/oauth/callback-server.js +9 -9
  409. package/package.json +222 -222
  410. package/v3/@claude-flow/cli/README.md +422 -422
  411. package/v3/@claude-flow/cli/bin/cli.js +338 -338
  412. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  413. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  414. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  415. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  416. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  417. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  418. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  419. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +4 -4
  420. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  421. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  422. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  423. package/v3/@claude-flow/cli/dist/src/commands/init.js +75 -75
  424. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  425. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  426. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  427. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  428. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  429. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  430. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  431. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  432. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  433. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +273 -273
  434. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  435. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +2 -2
  436. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +917 -917
  437. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +24 -24
  438. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  439. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  440. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +6 -4
  441. package/v3/@claude-flow/cli/dist/src/mcp-tools/seraphina-tools.js +4 -4
  442. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  443. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +114 -114
  444. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +416 -416
  445. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  446. package/v3/@claude-flow/cli/dist/src/proxy/verify.js +2 -2
  447. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  448. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  449. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  450. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +18 -18
  451. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  452. package/v3/@claude-flow/cli/package.json +181 -181
  453. package/v3/@claude-flow/guidance/README.md +1195 -1195
  454. package/v3/@claude-flow/guidance/package.json +198 -198
  455. package/v3/@claude-flow/shared/README.md +323 -323
  456. package/v3/@claude-flow/shared/dist/events/event-store.js +31 -31
  457. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  458. package/v3/@claude-flow/shared/package.json +43 -43
  459. package/v3/README.md +493 -493
  460. package/.claude/.proven-config-version +0 -1
  461. package/.claude/proven-config.json +0 -42
  462. package/v3/@claude-flow/cli/dist/src/ruvector/diskann-backend.d.ts +0 -78
  463. package/v3/@claude-flow/cli/dist/src/ruvector/diskann-backend.js +0 -310
@@ -7,321 +7,321 @@
7
7
  */
8
8
  // --- Section Generators ---
9
9
  function behavioralRules() {
10
- return `## Rules
11
-
12
- - Do what has been asked; nothing more, nothing less
13
- - NEVER create files unless absolutely necessary — prefer editing existing files
14
- - NEVER create documentation files unless explicitly requested
15
- - NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
16
- - ALWAYS read a file before editing it
17
- - NEVER commit secrets, credentials, or .env files
18
- - NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
19
- - Keep files under 500 lines
10
+ return `## Rules
11
+
12
+ - Do what has been asked; nothing more, nothing less
13
+ - NEVER create files unless absolutely necessary — prefer editing existing files
14
+ - NEVER create documentation files unless explicitly requested
15
+ - NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
16
+ - ALWAYS read a file before editing it
17
+ - NEVER commit secrets, credentials, or .env files
18
+ - NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
19
+ - Keep files under 500 lines
20
20
  - Validate input at system boundaries`;
21
21
  }
22
22
  function policyGovernedWorkflow() {
23
- return `## Ruflo Capability Brain & Implementation Loop
24
-
25
- Ruflo is the coordination ledger and policy decision point. Claude Code is the
26
- executor: after a Ruflo coordination call, continue implementing the task.
27
-
28
- When it is registered, call
29
- \`guidance_brain({ mode: "recommend", task: "..." })\` before complex Ruflo
30
- work. Use its live registry instead of guessing tool names. Treat
31
- \`registered\`, \`configured\`, \`reachable\`, \`healthy\`, and \`authorized\`
32
- as separate facts. If the brain is unavailable, continue with the compatible
33
- \`guidance_recommend\` tool, CLI discovery, and repository instructions.
34
-
35
- Follow the returned loop:
36
-
37
- 1. Recall memory and ADR constraints.
38
- 2. Inspect source, runtime, dependencies, policy, and health.
39
- 3. Route to the smallest capable topology, agents, skills, and tools.
40
- 4. Plan acceptance criteria, safety envelope, ownership, and validation.
41
- 5. Execute in isolated scopes; the coding agent performs the work.
42
- 6. Test focused, regression, and failure paths.
43
- 7. Validate types, security, policy, compatibility, and artifacts.
44
- 8. Benchmark a source-bound candidate against a source-bound baseline.
45
- 9. Optimize measured bottlenecks without weakening safety.
46
- 10. Bind claims and evidence to exact source/build receipts.
47
- 11. Reconcile concurrent handoffs and disclose limitations.
48
- 12. Publish only through a separately authorized release gate.
49
-
50
- ### Concurrency and authority
51
-
52
- - Never allow two writers in one worktree; give each writing agent an isolated
53
- worktree and explicit file ownership.
54
- - Read-only research may run concurrently and report findings to the owner.
55
- - Only the integration owner edits shared manifests and lockfiles or reconciles
56
- overlapping changes.
57
- - A child may drop capabilities but cannot add tools, network, secrets, spend,
58
- concurrency, namespaces, or delegation depth.
59
- - A lease or claim coordinates ownership; it does not authorize a side effect.
60
- - Darwin, Flywheel, MetaHarness, memory, and neural systems may propose or
61
- evaluate candidates but cannot self-promote or expand their SafetyEnvelope.
62
- - Bind tests, benchmarks, policy decisions, and release evidence to an exact
23
+ return `## Ruflo Capability Brain & Implementation Loop
24
+
25
+ Ruflo is the coordination ledger and policy decision point. Claude Code is the
26
+ executor: after a Ruflo coordination call, continue implementing the task.
27
+
28
+ When it is registered, call
29
+ \`guidance_brain({ mode: "recommend", task: "..." })\` before complex Ruflo
30
+ work. Use its live registry instead of guessing tool names. Treat
31
+ \`registered\`, \`configured\`, \`reachable\`, \`healthy\`, and \`authorized\`
32
+ as separate facts. If the brain is unavailable, continue with the compatible
33
+ \`guidance_recommend\` tool, CLI discovery, and repository instructions.
34
+
35
+ Follow the returned loop:
36
+
37
+ 1. Recall memory and ADR constraints.
38
+ 2. Inspect source, runtime, dependencies, policy, and health.
39
+ 3. Route to the smallest capable topology, agents, skills, and tools.
40
+ 4. Plan acceptance criteria, safety envelope, ownership, and validation.
41
+ 5. Execute in isolated scopes; the coding agent performs the work.
42
+ 6. Test focused, regression, and failure paths.
43
+ 7. Validate types, security, policy, compatibility, and artifacts.
44
+ 8. Benchmark a source-bound candidate against a source-bound baseline.
45
+ 9. Optimize measured bottlenecks without weakening safety.
46
+ 10. Bind claims and evidence to exact source/build receipts.
47
+ 11. Reconcile concurrent handoffs and disclose limitations.
48
+ 12. Publish only through a separately authorized release gate.
49
+
50
+ ### Concurrency and authority
51
+
52
+ - Never allow two writers in one worktree; give each writing agent an isolated
53
+ worktree and explicit file ownership.
54
+ - Read-only research may run concurrently and report findings to the owner.
55
+ - Only the integration owner edits shared manifests and lockfiles or reconciles
56
+ overlapping changes.
57
+ - A child may drop capabilities but cannot add tools, network, secrets, spend,
58
+ concurrency, namespaces, or delegation depth.
59
+ - A lease or claim coordinates ownership; it does not authorize a side effect.
60
+ - Darwin, Flywheel, MetaHarness, memory, and neural systems may propose or
61
+ evaluate candidates but cannot self-promote or expand their SafetyEnvelope.
62
+ - Bind tests, benchmarks, policy decisions, and release evidence to an exact
63
63
  commit or immutable dirty-worktree snapshot.`;
64
64
  }
65
65
  function agentComms() {
66
- return `## Agent Comms (SendMessage-First Coordination)
67
-
68
- Named agents coordinate via \`SendMessage\`, not polling or shared state.
69
-
70
- \`\`\`
71
- Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
72
- (named agents message each other directly)
73
- \`\`\`
74
-
75
- ### Spawning a Coordinated Team
76
-
77
- \`\`\`javascript
78
- // ALL agents in ONE message, each knows WHO to message next
79
- Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
80
- subagent_type: "researcher", name: "researcher", run_in_background: true })
81
- Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
82
- subagent_type: "system-architect", name: "architect", run_in_background: true })
83
- Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
84
- subagent_type: "coder", name: "coder", run_in_background: true })
85
- Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
86
- subagent_type: "tester", name: "tester", run_in_background: true })
87
- Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
88
- subagent_type: "reviewer", name: "reviewer", run_in_background: true })
89
-
90
- // Kick off the pipeline
91
- SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
92
- \`\`\`
93
-
94
- ### Patterns
95
-
96
- | Pattern | Flow | Use When |
97
- |---------|------|----------|
98
- | **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
99
- | **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
100
- | **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
101
-
102
- ### Rules
103
-
104
- - ALWAYS name agents — \`name: "role"\` makes them addressable
105
- - ALWAYS include comms instructions in prompts — who to message, what to send
106
- - Spawn ALL agents in ONE message with \`run_in_background: true\`
107
- - After spawning, continue independent local work; wait only when a dependency
108
- genuinely blocks progress
109
- - Do not poll repeatedly — agents message back or complete automatically
66
+ return `## Agent Comms (SendMessage-First Coordination)
67
+
68
+ Named agents coordinate via \`SendMessage\`, not polling or shared state.
69
+
70
+ \`\`\`
71
+ Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
72
+ (named agents message each other directly)
73
+ \`\`\`
74
+
75
+ ### Spawning a Coordinated Team
76
+
77
+ \`\`\`javascript
78
+ // ALL agents in ONE message, each knows WHO to message next
79
+ Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
80
+ subagent_type: "researcher", name: "researcher", run_in_background: true })
81
+ Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
82
+ subagent_type: "system-architect", name: "architect", run_in_background: true })
83
+ Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
84
+ subagent_type: "coder", name: "coder", run_in_background: true })
85
+ Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
86
+ subagent_type: "tester", name: "tester", run_in_background: true })
87
+ Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
88
+ subagent_type: "reviewer", name: "reviewer", run_in_background: true })
89
+
90
+ // Kick off the pipeline
91
+ SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
92
+ \`\`\`
93
+
94
+ ### Patterns
95
+
96
+ | Pattern | Flow | Use When |
97
+ |---------|------|----------|
98
+ | **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
99
+ | **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
100
+ | **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
101
+
102
+ ### Rules
103
+
104
+ - ALWAYS name agents — \`name: "role"\` makes them addressable
105
+ - ALWAYS include comms instructions in prompts — who to message, what to send
106
+ - Spawn ALL agents in ONE message with \`run_in_background: true\`
107
+ - After spawning, continue independent local work; wait only when a dependency
108
+ genuinely blocks progress
109
+ - Do not poll repeatedly — agents message back or complete automatically
110
110
  - Give every writing agent an isolated worktree and a non-overlapping file scope`;
111
111
  }
112
112
  function swarmConfig(options) {
113
- return `## Swarm & Routing
114
-
115
- ### Config
116
- - **Topology**: ${options.runtime.topology} (anti-drift)
117
- - **Max Agents**: ${options.runtime.maxAgents}
118
- - **Memory**: ${options.runtime.memoryBackend}
119
- - **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
120
- - **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
121
-
122
- \`\`\`bash
123
- npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
124
- \`\`\`
125
-
126
- ### Agent Routing
127
-
128
- | Task | Agents | Topology |
129
- |------|--------|----------|
130
- | Bug Fix | researcher, coder, tester | hierarchical |
131
- | Feature | architect, coder, tester, reviewer | hierarchical |
132
- | Refactor | architect, coder, reviewer | hierarchical |
133
- | Performance | perf-engineer, coder | hierarchical |
134
- | Security | security-architect, auditor | hierarchical |
135
-
136
- ### When to Swarm
137
- - **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
138
- - **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
139
-
140
- ### 3-Tier Model Routing
141
-
142
- | Tier | Handler | Use Cases |
143
- |------|---------|-----------|
144
- | 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
145
- | 2 | Haiku | Simple tasks, low complexity |
113
+ return `## Swarm & Routing
114
+
115
+ ### Config
116
+ - **Topology**: ${options.runtime.topology} (anti-drift)
117
+ - **Max Agents**: ${options.runtime.maxAgents}
118
+ - **Memory**: ${options.runtime.memoryBackend}
119
+ - **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
120
+ - **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
121
+
122
+ \`\`\`bash
123
+ npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
124
+ \`\`\`
125
+
126
+ ### Agent Routing
127
+
128
+ | Task | Agents | Topology |
129
+ |------|--------|----------|
130
+ | Bug Fix | researcher, coder, tester | hierarchical |
131
+ | Feature | architect, coder, tester, reviewer | hierarchical |
132
+ | Refactor | architect, coder, reviewer | hierarchical |
133
+ | Performance | perf-engineer, coder | hierarchical |
134
+ | Security | security-architect, auditor | hierarchical |
135
+
136
+ ### When to Swarm
137
+ - **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
138
+ - **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
139
+
140
+ ### 3-Tier Model Routing
141
+
142
+ | Tier | Handler | Use Cases |
143
+ |------|---------|-----------|
144
+ | 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
145
+ | 2 | Haiku | Simple tasks, low complexity |
146
146
  | 3 | Sonnet/Opus | Architecture, security, complex reasoning |`;
147
147
  }
148
148
  function memoryAndLearning() {
149
- return `## Memory & Learning
150
-
151
- ### Before Any Task
152
- \`\`\`bash
153
- npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
154
- npx @claude-flow/cli@latest hooks route --task "[task description]"
155
- \`\`\`
156
-
157
- ### After Success
158
- \`\`\`bash
159
- npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
160
- npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
161
- \`\`\`
162
-
163
- ### MCP Tools (use \`ToolSearch("keyword")\` to discover)
164
-
165
- | Category | Key Tools |
166
- |----------|-----------|
167
- | **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
168
- | **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
169
- | **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
170
- | **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
171
- | **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
172
- | **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
173
- | **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
174
-
175
- ### Background Workers
176
-
177
- | Worker | When |
178
- |--------|------|
179
- | \`audit\` | After security changes |
180
- | \`optimize\` | After performance work |
181
- | \`testgaps\` | After adding features |
182
- | \`map\` | Every 5+ file changes |
183
- | \`document\` | After API changes |
184
-
185
- \`\`\`bash
186
- npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
149
+ return `## Memory & Learning
150
+
151
+ ### Before Any Task
152
+ \`\`\`bash
153
+ npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
154
+ npx @claude-flow/cli@latest hooks route --task "[task description]"
155
+ \`\`\`
156
+
157
+ ### After Success
158
+ \`\`\`bash
159
+ npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
160
+ npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
161
+ \`\`\`
162
+
163
+ ### MCP Tools (use \`ToolSearch("keyword")\` to discover)
164
+
165
+ | Category | Key Tools |
166
+ |----------|-----------|
167
+ | **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
168
+ | **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
169
+ | **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
170
+ | **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
171
+ | **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
172
+ | **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
173
+ | **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
174
+
175
+ ### Background Workers
176
+
177
+ | Worker | When |
178
+ |--------|------|
179
+ | \`audit\` | After security changes |
180
+ | \`optimize\` | After performance work |
181
+ | \`testgaps\` | After adding features |
182
+ | \`map\` | Every 5+ file changes |
183
+ | \`document\` | After API changes |
184
+
185
+ \`\`\`bash
186
+ npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
187
187
  \`\`\``;
188
188
  }
189
189
  function agentTypes() {
190
- return `## Agents
191
-
192
- **Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
193
- **Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
194
- **Security**: \`security-architect\`, \`security-auditor\`
195
- **Performance**: \`performance-engineer\`, \`perf-analyzer\`
196
- **Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
197
- **GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
198
-
190
+ return `## Agents
191
+
192
+ **Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
193
+ **Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
194
+ **Security**: \`security-architect\`, \`security-auditor\`
195
+ **Performance**: \`performance-engineer\`, \`perf-analyzer\`
196
+ **Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
197
+ **GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
198
+
199
199
  Any string works as a custom agent type.`;
200
200
  }
201
201
  function cliQuickRef() {
202
- return `## CLI Quick Reference
203
-
204
- \`\`\`bash
205
- npx @claude-flow/cli@latest init --wizard # Setup
206
- npx @claude-flow/cli@latest swarm init --v3-mode # Start swarm
207
- npx @claude-flow/cli@latest memory search --query "" # Vector search
208
- npx @claude-flow/cli@latest hooks route --task "" # Route to agent
209
- npx @claude-flow/cli@latest doctor --fix # Diagnostics
210
- npx @claude-flow/cli@latest security scan # Security scan
211
- npx @claude-flow/cli@latest performance benchmark # Benchmarks
212
- \`\`\`
213
-
202
+ return `## CLI Quick Reference
203
+
204
+ \`\`\`bash
205
+ npx @claude-flow/cli@latest init --wizard # Setup
206
+ npx @claude-flow/cli@latest swarm init --v3-mode # Start swarm
207
+ npx @claude-flow/cli@latest memory search --query "" # Vector search
208
+ npx @claude-flow/cli@latest hooks route --task "" # Route to agent
209
+ npx @claude-flow/cli@latest doctor --fix # Diagnostics
210
+ npx @claude-flow/cli@latest security scan # Security scan
211
+ npx @claude-flow/cli@latest performance benchmark # Benchmarks
212
+ \`\`\`
213
+
214
214
  26 commands, 140+ subcommands. Use \`--help\` on any command for details.`;
215
215
  }
216
216
  function setupAndBoundary() {
217
- return `## Setup
218
-
219
- \`\`\`bash
220
- claude mcp add claude-flow -- npx -y ruflo@latest mcp start
221
- npx ruflo@latest doctor --fix
222
- \`\`\`
223
-
224
- > The background \`daemon\` is optional. It runs interval workers that each spawn
225
- > a headless \`claude\` session, so it consumes tokens continuously. Start it only
226
- > if you want those sweeps: \`npx ruflo@latest daemon start\` (self-stops after 12h
227
- > by default; \`--ttl 0\` to disable, \`daemon status --all\` to audit running daemons).
228
-
217
+ return `## Setup
218
+
219
+ \`\`\`bash
220
+ claude mcp add claude-flow -- npx -y ruflo@latest mcp start
221
+ npx ruflo@latest doctor --fix
222
+ \`\`\`
223
+
224
+ > The background \`daemon\` is optional. It runs interval workers that each spawn
225
+ > a headless \`claude\` session, so it consumes tokens continuously. Start it only
226
+ > if you want those sweeps: \`npx ruflo@latest daemon start\` (self-stops after 12h
227
+ > by default; \`--ttl 0\` to disable, \`daemon status --all\` to audit running daemons).
228
+
229
229
  **Agent tool** handles execution (agents, files, code, git). **MCP tools** handle coordination (swarm, memory, hooks). **CLI** is the same via Bash.`;
230
230
  }
231
231
  function buildAndTest() {
232
- return `## Build & Test
233
-
234
- - ALWAYS run tests after code changes
235
- - ALWAYS verify build succeeds before committing
236
-
237
- \`\`\`bash
238
- npm run build && npm test
232
+ return `## Build & Test
233
+
234
+ - ALWAYS run tests after code changes
235
+ - ALWAYS verify build succeeds before committing
236
+
237
+ \`\`\`bash
238
+ npm run build && npm test
239
239
  \`\`\``;
240
240
  }
241
241
  function securitySection() {
242
- return `## Security
243
-
244
- - NEVER hardcode secrets in source — use environment variables
245
- - Always validate input at boundaries (Zod schemas)
246
- - Always sanitize file paths (prevent traversal)
247
- - Always use parameterized queries (prevent injection)
248
-
249
- \`\`\`bash
250
- npx @claude-flow/cli@latest security scan --depth deep
251
- npx @claude-flow/cli@latest security audit --report
252
- \`\`\`
253
-
242
+ return `## Security
243
+
244
+ - NEVER hardcode secrets in source — use environment variables
245
+ - Always validate input at boundaries (Zod schemas)
246
+ - Always sanitize file paths (prevent traversal)
247
+ - Always use parameterized queries (prevent injection)
248
+
249
+ \`\`\`bash
250
+ npx @claude-flow/cli@latest security scan --depth deep
251
+ npx @claude-flow/cli@latest security audit --report
252
+ \`\`\`
253
+
254
254
  Agents: \`security-architect\` (threat modeling), \`security-auditor\` (vulnerability detection)`;
255
255
  }
256
256
  function performanceSection() {
257
- return `## Performance
258
-
259
- - Always benchmark before AND after optimization
260
- - Always profile before optimizing — never guess bottlenecks
261
- - Use HNSW for vector search, Int8 quantization for memory reduction — measure the actual speedup/recall on your own corpus via \`node scripts/benchmark-intelligence.mjs --only=hnsw\` rather than trusting a hardcoded multiplier (recall@10 varies by corpus size — 0.99 at N=5k, 0.92 at N=20k on the reference host, dream-cycle 2026-08-30)
262
-
263
- \`\`\`bash
264
- npx @claude-flow/cli@latest performance benchmark --suite all
265
- npx @claude-flow/cli@latest performance profile --target "[component]"
266
- \`\`\`
267
-
257
+ return `## Performance
258
+
259
+ - Always benchmark before AND after optimization
260
+ - Always profile before optimizing — never guess bottlenecks
261
+ - Use HNSW for vector search, Int8 quantization for memory reduction — measure the actual speedup/recall on your own corpus via \`node scripts/benchmark-intelligence.mjs --only=hnsw\` rather than trusting a hardcoded multiplier (recall@10 varies by corpus size — 0.99 at N=5k, 0.92 at N=20k on the reference host, dream-cycle 2026-08-30)
262
+
263
+ \`\`\`bash
264
+ npx @claude-flow/cli@latest performance benchmark --suite all
265
+ npx @claude-flow/cli@latest performance profile --target "[component]"
266
+ \`\`\`
267
+
268
268
  Agents: \`performance-engineer\` (profiling), \`perf-analyzer\` (bottleneck detection)`;
269
269
  }
270
270
  function hooksRef() {
271
- return `## Hooks
272
-
273
- | Hook | Purpose |
274
- |------|---------|
275
- | \`pre-task\` / \`post-task\` | Task lifecycle + learning |
276
- | \`pre-edit\` / \`post-edit\` | File editing + neural training |
277
- | \`session-start\` / \`session-end\` | Session persistence |
278
- | \`route\` | Route to optimal agent |
279
- | \`intelligence\` | Pattern learning (SONA) |
280
- | \`worker\` | Background worker dispatch |
281
-
282
- \`\`\`bash
283
- npx @claude-flow/cli@latest hooks pre-task --description "[task]"
284
- npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
285
- npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
286
- npx @claude-flow/cli@latest hooks route --task "[task]"
287
- npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
271
+ return `## Hooks
272
+
273
+ | Hook | Purpose |
274
+ |------|---------|
275
+ | \`pre-task\` / \`post-task\` | Task lifecycle + learning |
276
+ | \`pre-edit\` / \`post-edit\` | File editing + neural training |
277
+ | \`session-start\` / \`session-end\` | Session persistence |
278
+ | \`route\` | Route to optimal agent |
279
+ | \`intelligence\` | Pattern learning (SONA) |
280
+ | \`worker\` | Background worker dispatch |
281
+
282
+ \`\`\`bash
283
+ npx @claude-flow/cli@latest hooks pre-task --description "[task]"
284
+ npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
285
+ npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
286
+ npx @claude-flow/cli@latest hooks route --task "[task]"
287
+ npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
288
288
  \`\`\``;
289
289
  }
290
290
  function intelligenceSystem() {
291
- return `## Intelligence (SONA + HNSW)
292
-
293
- Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
294
-
295
- - **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
296
- - **HNSW**: faster than brute-force search, magnitude scales with corpus size — reproduce with \`node scripts/benchmark-intelligence.mjs --only=hnsw\` rather than a hardcoded multiplier
297
- - **SONA**: Sub-millisecond pattern adaptation
291
+ return `## Intelligence (SONA + HNSW)
292
+
293
+ Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
294
+
295
+ - **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
296
+ - **HNSW**: faster than brute-force search, magnitude scales with corpus size — reproduce with \`node scripts/benchmark-intelligence.mjs --only=hnsw\` rather than a hardcoded multiplier
297
+ - **SONA**: Sub-millisecond pattern adaptation
298
298
  - **Claude Bridge**: Auto-imports \`~/.claude/projects/*/memory/*.md\` into AgentDB`;
299
299
  }
300
300
  function federationRef() {
301
- return `## Federation
302
-
303
- Cross-installation agent collaboration with zero-trust security.
304
-
305
- \`\`\`bash
306
- npx @claude-flow/cli@latest federation init
307
- npx @claude-flow/cli@latest federation join wss://peer:8443
308
- npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
309
- npx @claude-flow/cli@latest federation status
310
- \`\`\`
311
-
312
- - 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
313
- - PII pipeline: 14 types auto-stripped before data leaves your node
314
- - mTLS + ed25519 handshake, HMAC-signed envelopes
301
+ return `## Federation
302
+
303
+ Cross-installation agent collaboration with zero-trust security.
304
+
305
+ \`\`\`bash
306
+ npx @claude-flow/cli@latest federation init
307
+ npx @claude-flow/cli@latest federation join wss://peer:8443
308
+ npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
309
+ npx @claude-flow/cli@latest federation status
310
+ \`\`\`
311
+
312
+ - 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
313
+ - PII pipeline: 14 types auto-stripped before data leaves your node
314
+ - mTLS + ed25519 handshake, HMAC-signed envelopes
315
315
  - Compliance: HIPAA, SOC2, GDPR audit modes`;
316
316
  }
317
317
  function envVars() {
318
- return `## Environment
319
-
320
- \`\`\`bash
321
- CLAUDE_FLOW_CONFIG=./claude-flow.config.json
322
- CLAUDE_FLOW_LOG_LEVEL=info
323
- CLAUDE_FLOW_MEMORY_BACKEND=hybrid
324
- CLAUDE_FLOW_MEMORY_PATH=./data/memory
318
+ return `## Environment
319
+
320
+ \`\`\`bash
321
+ CLAUDE_FLOW_CONFIG=./claude-flow.config.json
322
+ CLAUDE_FLOW_LOG_LEVEL=info
323
+ CLAUDE_FLOW_MEMORY_BACKEND=hybrid
324
+ CLAUDE_FLOW_MEMORY_PATH=./data/memory
325
325
  \`\`\``;
326
326
  }
327
327
  // --- Template Composers ---