@claude-flow/cli 3.32.8 → 3.32.10

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 (448) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  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/planner.md +374 -374
  15. package/.claude/agents/custom/test-long-runner.md +44 -44
  16. package/.claude/agents/data/data-ml-model.md +444 -444
  17. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  18. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  19. package/.claude/agents/development/dev-backend-api.md +344 -344
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  21. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  23. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  24. package/.claude/agents/flow-nexus/app-store.md +87 -87
  25. package/.claude/agents/flow-nexus/authentication.md +68 -68
  26. package/.claude/agents/flow-nexus/challenges.md +80 -80
  27. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  28. package/.claude/agents/flow-nexus/payments.md +82 -82
  29. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  30. package/.claude/agents/flow-nexus/swarm.md +75 -75
  31. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  32. package/.claude/agents/flow-nexus/workflow.md +83 -83
  33. package/.claude/agents/github/code-review-swarm.md +377 -377
  34. package/.claude/agents/github/github-modes.md +172 -172
  35. package/.claude/agents/github/issue-tracker.md +575 -575
  36. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  37. package/.claude/agents/github/pr-manager.md +437 -437
  38. package/.claude/agents/github/project-board-sync.md +508 -508
  39. package/.claude/agents/github/release-manager.md +604 -604
  40. package/.claude/agents/github/release-swarm.md +582 -582
  41. package/.claude/agents/github/repo-architect.md +397 -397
  42. package/.claude/agents/github/swarm-issue.md +572 -572
  43. package/.claude/agents/github/swarm-pr.md +427 -427
  44. package/.claude/agents/github/sync-coordinator.md +451 -451
  45. package/.claude/agents/github/workflow-automation.md +902 -902
  46. package/.claude/agents/goal/agent.md +815 -815
  47. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  48. package/.claude/agents/optimization/load-balancer.md +430 -430
  49. package/.claude/agents/optimization/performance-monitor.md +671 -671
  50. package/.claude/agents/optimization/resource-allocator.md +673 -673
  51. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  52. package/.claude/agents/payments/agentic-payments.md +126 -126
  53. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  54. package/.claude/agents/sparc/architecture.md +698 -698
  55. package/.claude/agents/sparc/pseudocode.md +519 -519
  56. package/.claude/agents/sparc/refinement.md +801 -801
  57. package/.claude/agents/sparc/specification.md +477 -477
  58. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  59. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  60. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  61. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  62. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  63. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  64. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  65. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  66. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  67. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  68. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  69. package/.claude/agents/templates/base-template-generator.md +289 -289
  70. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  71. package/.claude/agents/templates/github-pr-manager.md +176 -176
  72. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  73. package/.claude/agents/templates/memory-coordinator.md +186 -186
  74. package/.claude/agents/templates/orchestrator-task.md +138 -138
  75. package/.claude/agents/templates/performance-analyzer.md +198 -198
  76. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  77. package/.claude/agents/testing/production-validator.md +394 -394
  78. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  79. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  80. package/.claude/agents/v3/claims-authorizer.md +208 -208
  81. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  82. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  83. package/.claude/agents/v3/injection-analyst.md +236 -236
  84. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  85. package/.claude/agents/v3/pii-detector.md +151 -151
  86. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  87. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  88. package/.claude/agents/v3/security-architect.md +867 -867
  89. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  90. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  91. package/.claude/commands/agents/README.md +50 -50
  92. package/.claude/commands/agents/agent-capabilities.md +140 -140
  93. package/.claude/commands/agents/agent-coordination.md +28 -28
  94. package/.claude/commands/agents/agent-spawning.md +28 -28
  95. package/.claude/commands/agents/agent-types.md +216 -216
  96. package/.claude/commands/agents/health.md +139 -139
  97. package/.claude/commands/agents/list.md +100 -100
  98. package/.claude/commands/agents/logs.md +130 -130
  99. package/.claude/commands/agents/metrics.md +122 -122
  100. package/.claude/commands/agents/pool.md +127 -127
  101. package/.claude/commands/agents/spawn.md +140 -140
  102. package/.claude/commands/agents/status.md +115 -115
  103. package/.claude/commands/agents/stop.md +102 -102
  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/github/README.md +11 -11
  129. package/.claude/commands/github/code-review-swarm.md +513 -513
  130. package/.claude/commands/github/code-review.md +25 -25
  131. package/.claude/commands/github/github-modes.md +146 -146
  132. package/.claude/commands/github/github-swarm.md +121 -121
  133. package/.claude/commands/github/issue-tracker.md +291 -291
  134. package/.claude/commands/github/issue-triage.md +25 -25
  135. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  136. package/.claude/commands/github/pr-enhance.md +26 -26
  137. package/.claude/commands/github/pr-manager.md +169 -169
  138. package/.claude/commands/github/project-board-sync.md +470 -470
  139. package/.claude/commands/github/release-manager.md +339 -339
  140. package/.claude/commands/github/release-swarm.md +543 -543
  141. package/.claude/commands/github/repo-analyze.md +25 -25
  142. package/.claude/commands/github/repo-architect.md +366 -366
  143. package/.claude/commands/github/swarm-issue.md +484 -484
  144. package/.claude/commands/github/swarm-pr.md +287 -287
  145. package/.claude/commands/github/sync-coordinator.md +302 -302
  146. package/.claude/commands/github/workflow-automation.md +441 -441
  147. package/.claude/commands/hive-mind/README.md +17 -17
  148. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  149. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  150. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  151. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  152. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  153. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  154. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  155. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  156. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  157. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  158. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  159. package/.claude/commands/hooks/README.md +11 -11
  160. package/.claude/commands/hooks/overview.md +57 -57
  161. package/.claude/commands/hooks/post-edit.md +117 -117
  162. package/.claude/commands/hooks/post-task.md +112 -112
  163. package/.claude/commands/hooks/pre-edit.md +113 -113
  164. package/.claude/commands/hooks/pre-task.md +111 -111
  165. package/.claude/commands/hooks/session-end.md +118 -118
  166. package/.claude/commands/hooks/setup.md +102 -102
  167. package/.claude/commands/memory/README.md +9 -9
  168. package/.claude/commands/memory/memory-persist.md +25 -25
  169. package/.claude/commands/memory/memory-search.md +25 -25
  170. package/.claude/commands/memory/memory-usage.md +25 -25
  171. package/.claude/commands/memory/neural.md +47 -47
  172. package/.claude/commands/monitoring/README.md +9 -9
  173. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  174. package/.claude/commands/monitoring/agents.md +44 -44
  175. package/.claude/commands/monitoring/real-time-view.md +25 -25
  176. package/.claude/commands/monitoring/status.md +46 -46
  177. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  178. package/.claude/commands/optimization/README.md +9 -9
  179. package/.claude/commands/optimization/auto-topology.md +61 -61
  180. package/.claude/commands/optimization/cache-manage.md +25 -25
  181. package/.claude/commands/optimization/parallel-execute.md +25 -25
  182. package/.claude/commands/optimization/parallel-execution.md +49 -49
  183. package/.claude/commands/optimization/topology-optimize.md +25 -25
  184. package/.claude/commands/pair/README.md +260 -260
  185. package/.claude/commands/pair/commands.md +545 -545
  186. package/.claude/commands/pair/config.md +509 -509
  187. package/.claude/commands/pair/examples.md +511 -511
  188. package/.claude/commands/pair/modes.md +347 -347
  189. package/.claude/commands/pair/session.md +406 -406
  190. package/.claude/commands/pair/start.md +208 -208
  191. package/.claude/commands/sparc/analyzer.md +51 -51
  192. package/.claude/commands/sparc/architect.md +53 -53
  193. package/.claude/commands/sparc/ask.md +97 -97
  194. package/.claude/commands/sparc/batch-executor.md +54 -54
  195. package/.claude/commands/sparc/code.md +89 -89
  196. package/.claude/commands/sparc/coder.md +54 -54
  197. package/.claude/commands/sparc/debug.md +83 -83
  198. package/.claude/commands/sparc/debugger.md +54 -54
  199. package/.claude/commands/sparc/designer.md +53 -53
  200. package/.claude/commands/sparc/devops.md +109 -109
  201. package/.claude/commands/sparc/docs-writer.md +80 -80
  202. package/.claude/commands/sparc/documenter.md +54 -54
  203. package/.claude/commands/sparc/innovator.md +54 -54
  204. package/.claude/commands/sparc/integration.md +83 -83
  205. package/.claude/commands/sparc/mcp.md +117 -117
  206. package/.claude/commands/sparc/memory-manager.md +54 -54
  207. package/.claude/commands/sparc/optimizer.md +54 -54
  208. package/.claude/commands/sparc/orchestrator.md +131 -131
  209. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  210. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  211. package/.claude/commands/sparc/researcher.md +54 -54
  212. package/.claude/commands/sparc/reviewer.md +54 -54
  213. package/.claude/commands/sparc/security-review.md +80 -80
  214. package/.claude/commands/sparc/sparc-modes.md +174 -174
  215. package/.claude/commands/sparc/sparc.md +111 -111
  216. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  217. package/.claude/commands/sparc/supabase-admin.md +348 -348
  218. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  219. package/.claude/commands/sparc/tdd.md +54 -54
  220. package/.claude/commands/sparc/tester.md +54 -54
  221. package/.claude/commands/sparc/tutorial.md +79 -79
  222. package/.claude/commands/sparc/workflow-manager.md +54 -54
  223. package/.claude/commands/sparc.md +166 -166
  224. package/.claude/commands/stream-chain/pipeline.md +120 -120
  225. package/.claude/commands/stream-chain/run.md +69 -69
  226. package/.claude/commands/swarm/README.md +15 -15
  227. package/.claude/commands/swarm/analysis.md +95 -95
  228. package/.claude/commands/swarm/development.md +96 -96
  229. package/.claude/commands/swarm/examples.md +168 -168
  230. package/.claude/commands/swarm/maintenance.md +102 -102
  231. package/.claude/commands/swarm/optimization.md +117 -117
  232. package/.claude/commands/swarm/research.md +136 -136
  233. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  234. package/.claude/commands/swarm/swarm-background.md +8 -8
  235. package/.claude/commands/swarm/swarm-init.md +19 -19
  236. package/.claude/commands/swarm/swarm-modes.md +8 -8
  237. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  238. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  239. package/.claude/commands/swarm/swarm-status.md +8 -8
  240. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  241. package/.claude/commands/swarm/swarm.md +87 -87
  242. package/.claude/commands/swarm/testing.md +131 -131
  243. package/.claude/commands/training/README.md +9 -9
  244. package/.claude/commands/training/model-update.md +25 -25
  245. package/.claude/commands/training/neural-patterns.md +107 -107
  246. package/.claude/commands/training/neural-train.md +75 -75
  247. package/.claude/commands/training/pattern-learn.md +25 -25
  248. package/.claude/commands/training/specialization.md +62 -62
  249. package/.claude/commands/truth/start.md +142 -142
  250. package/.claude/commands/verify/check.md +49 -49
  251. package/.claude/commands/verify/start.md +127 -127
  252. package/.claude/commands/workflows/README.md +9 -9
  253. package/.claude/commands/workflows/development.md +77 -77
  254. package/.claude/commands/workflows/research.md +62 -62
  255. package/.claude/commands/workflows/workflow-create.md +25 -25
  256. package/.claude/commands/workflows/workflow-execute.md +25 -25
  257. package/.claude/commands/workflows/workflow-export.md +25 -25
  258. package/.claude/eval/human-relevance-frozen-v1.json +17 -17
  259. package/.claude/evolve-proof/generation-0.json +211 -211
  260. package/.claude/evolve-proof/real-generation-0.json +406 -406
  261. package/.claude/evolve-proof/real-generation-1.json +406 -406
  262. package/.claude/helpers/README.md +96 -96
  263. package/.claude/helpers/adr-compliance.sh +186 -186
  264. package/.claude/helpers/auto-commit.sh +178 -178
  265. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  266. package/.claude/helpers/checkpoint-manager.sh +251 -251
  267. package/.claude/helpers/daemon-manager.sh +252 -252
  268. package/.claude/helpers/ddd-tracker.sh +144 -144
  269. package/.claude/helpers/github-safe.js +156 -156
  270. package/.claude/helpers/github-setup.sh +45 -45
  271. package/.claude/helpers/guidance-hook.sh +13 -13
  272. package/.claude/helpers/guidance-hooks.sh +102 -102
  273. package/.claude/helpers/health-monitor.sh +108 -108
  274. package/.claude/helpers/helpers.manifest.json +6 -6
  275. package/.claude/helpers/hook-handler.cjs +565 -565
  276. package/.claude/helpers/intelligence.cjs +1058 -1058
  277. package/.claude/helpers/learning-hooks.sh +329 -329
  278. package/.claude/helpers/learning-optimizer.sh +127 -127
  279. package/.claude/helpers/learning-service.mjs +1144 -1144
  280. package/.claude/helpers/memory.js +83 -83
  281. package/.claude/helpers/metrics-db.mjs +503 -503
  282. package/.claude/helpers/pattern-consolidator.sh +86 -86
  283. package/.claude/helpers/perf-worker.sh +160 -160
  284. package/.claude/helpers/post-commit +16 -16
  285. package/.claude/helpers/pre-commit +26 -26
  286. package/.claude/helpers/quick-start.sh +19 -19
  287. package/.claude/helpers/router.js +105 -105
  288. package/.claude/helpers/security-scanner.sh +127 -127
  289. package/.claude/helpers/session.js +157 -157
  290. package/.claude/helpers/setup-mcp.sh +18 -18
  291. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  292. package/.claude/helpers/statusline-hook.sh +21 -21
  293. package/.claude/helpers/statusline.cjs +1060 -1006
  294. package/.claude/helpers/statusline.js +340 -340
  295. package/.claude/helpers/swarm-comms.sh +353 -353
  296. package/.claude/helpers/swarm-hooks.sh +761 -761
  297. package/.claude/helpers/swarm-monitor.sh +210 -210
  298. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  299. package/.claude/helpers/update-v3-progress.sh +165 -165
  300. package/.claude/helpers/v3-quick-status.sh +57 -57
  301. package/.claude/helpers/v3.sh +110 -110
  302. package/.claude/helpers/validate-v3-config.sh +215 -215
  303. package/.claude/helpers/worker-manager.sh +170 -170
  304. package/.claude/proven-config.manifest.json +37 -37
  305. package/.claude/proven-config.signed.json +41 -41
  306. package/.claude/settings.json +182 -182
  307. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  308. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  309. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  310. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  311. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  312. package/.claude/skills/browser/SKILL.md +204 -204
  313. package/.claude/skills/dual-mode/README.md +71 -71
  314. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  315. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  316. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  317. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  318. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  319. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  320. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  321. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  322. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  323. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  324. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  325. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  326. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  327. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  328. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  329. package/.claude/skills/skill-builder/SKILL.md +910 -910
  330. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  331. package/.claude/skills/stream-chain/SKILL.md +560 -560
  332. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  333. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  334. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  335. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  336. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  337. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  338. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  339. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  340. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  341. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  342. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  343. package/.claude/skills/verification-quality/SKILL.md +691 -691
  344. package/README.md +419 -419
  345. package/bin/cli.js +314 -314
  346. package/bin/mcp-server.js +224 -224
  347. package/bin/preinstall.cjs +2 -2
  348. package/catalog-manifest.json +2 -2
  349. package/dist/src/autopilot-state.js +24 -7
  350. package/dist/src/benchmarks/gaia-critic.js +24 -24
  351. package/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  352. package/dist/src/commands/completions.js +409 -409
  353. package/dist/src/commands/daemon.js +44 -44
  354. package/dist/src/commands/doctor.js +267 -20
  355. package/dist/src/commands/embeddings.js +26 -26
  356. package/dist/src/commands/hive-mind.js +97 -97
  357. package/dist/src/commands/hooks.js +74 -11
  358. package/dist/src/commands/init.js +202 -34
  359. package/dist/src/commands/memory.js +12 -1
  360. package/dist/src/commands/ruvector/backup.js +23 -23
  361. package/dist/src/commands/ruvector/benchmark.js +31 -31
  362. package/dist/src/commands/ruvector/import.js +14 -14
  363. package/dist/src/commands/ruvector/init.js +115 -115
  364. package/dist/src/commands/ruvector/migrate.js +99 -99
  365. package/dist/src/commands/ruvector/optimize.js +51 -51
  366. package/dist/src/commands/ruvector/setup.js +624 -624
  367. package/dist/src/commands/ruvector/status.js +38 -38
  368. package/dist/src/config/proven-config.js +2 -2
  369. package/dist/src/funnel/disclosure.js +13 -2
  370. package/dist/src/funnel/message-transport.d.ts +11 -4
  371. package/dist/src/funnel/message-transport.js +11 -4
  372. package/dist/src/funnel/messages.d.ts +12 -10
  373. package/dist/src/funnel/messages.js +83 -11
  374. package/dist/src/init/claudemd-generator.js +231 -231
  375. package/dist/src/init/executor.js +453 -453
  376. package/dist/src/init/helper-signing.js +2 -2
  377. package/dist/src/init/helpers-generator.js +751 -751
  378. package/dist/src/init/statusline-generator.js +24 -24
  379. package/dist/src/mcp-tools/agentdb-tools.js +15 -15
  380. package/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  381. package/dist/src/mcp-tools/browser-tools.js +8 -0
  382. package/dist/src/mcp-tools/hooks-tools.js +21 -0
  383. package/dist/src/mcp-tools/memory-tools.js +4 -3
  384. package/dist/src/memory/graph-edge-writer.d.ts +9 -0
  385. package/dist/src/memory/graph-edge-writer.js +35 -22
  386. package/dist/src/memory/memory-bridge.js +189 -93
  387. package/dist/src/memory/memory-initializer.js +479 -407
  388. package/dist/src/memory/rabitq-index.js +5 -5
  389. package/dist/src/parser.js +25 -9
  390. package/dist/src/proxy/verify.js +2 -2
  391. package/dist/src/runtime/headless.js +28 -28
  392. package/dist/src/services/distill-tuning.js +7 -7
  393. package/dist/src/services/headless-worker-executor.js +84 -84
  394. package/dist/src/services/memory-distillation.js +4 -4
  395. package/dist/src/services/worker-daemon.js +7 -4
  396. package/dist/src/transfer/deploy-seraphine.js +23 -23
  397. package/package.json +137 -135
  398. package/plugins/ruflo-metaharness/.claude-plugin/plugin.json +32 -32
  399. package/plugins/ruflo-metaharness/README.md +72 -72
  400. package/plugins/ruflo-metaharness/agents/metaharness-architect.md +58 -58
  401. package/plugins/ruflo-metaharness/commands/ruflo-metaharness.md +48 -48
  402. package/plugins/ruflo-metaharness/scripts/_darwin.mjs +210 -210
  403. package/plugins/ruflo-metaharness/scripts/_harness.mjs +330 -330
  404. package/plugins/ruflo-metaharness/scripts/_invoke.mjs +231 -231
  405. package/plugins/ruflo-metaharness/scripts/_redblue.mjs +143 -143
  406. package/plugins/ruflo-metaharness/scripts/_similarity.mjs +161 -161
  407. package/plugins/ruflo-metaharness/scripts/_spike-similarity.mjs +223 -223
  408. package/plugins/ruflo-metaharness/scripts/audit-list.mjs +158 -158
  409. package/plugins/ruflo-metaharness/scripts/audit-trend.mjs +272 -272
  410. package/plugins/ruflo-metaharness/scripts/bench-parse-mcp-scan.mjs +146 -146
  411. package/plugins/ruflo-metaharness/scripts/bench-recordpair-overhead.mjs +186 -186
  412. package/plugins/ruflo-metaharness/scripts/bench-similarity.mjs +177 -177
  413. package/plugins/ruflo-metaharness/scripts/bench.mjs +95 -95
  414. package/plugins/ruflo-metaharness/scripts/drift-from-history.mjs +363 -363
  415. package/plugins/ruflo-metaharness/scripts/evolve.mjs +404 -404
  416. package/plugins/ruflo-metaharness/scripts/genome.mjs +80 -80
  417. package/plugins/ruflo-metaharness/scripts/gepa.mjs +153 -153
  418. package/plugins/ruflo-metaharness/scripts/learn.mjs +127 -127
  419. package/plugins/ruflo-metaharness/scripts/mcp-scan.mjs +111 -111
  420. package/plugins/ruflo-metaharness/scripts/mint.mjs +126 -126
  421. package/plugins/ruflo-metaharness/scripts/oia-audit.mjs +228 -228
  422. package/plugins/ruflo-metaharness/scripts/redblue.mjs +286 -286
  423. package/plugins/ruflo-metaharness/scripts/router-parallel-analyze.mjs +250 -250
  424. package/plugins/ruflo-metaharness/scripts/score.mjs +92 -92
  425. package/plugins/ruflo-metaharness/scripts/security-bench.mjs +174 -174
  426. package/plugins/ruflo-metaharness/scripts/similarity.mjs +158 -158
  427. package/plugins/ruflo-metaharness/scripts/smoke.sh +2356 -2356
  428. package/plugins/ruflo-metaharness/scripts/test-graceful-degradation.mjs +165 -165
  429. package/plugins/ruflo-metaharness/scripts/test-mcp-tools.mjs +472 -472
  430. package/plugins/ruflo-metaharness/scripts/test-parallel-pipeline.mjs +204 -204
  431. package/plugins/ruflo-metaharness/scripts/test-pipeline-roundtrip.mjs +586 -586
  432. package/plugins/ruflo-metaharness/scripts/test-similarity.mjs +334 -334
  433. package/plugins/ruflo-metaharness/scripts/test-with-openrouter.mjs +229 -229
  434. package/plugins/ruflo-metaharness/scripts/threat-model.mjs +59 -59
  435. package/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md +64 -64
  436. package/plugins/ruflo-metaharness/skills/harness-drift-from-history/SKILL.md +65 -65
  437. package/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md +131 -131
  438. package/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md +54 -54
  439. package/plugins/ruflo-metaharness/skills/harness-gepa/SKILL.md +65 -65
  440. package/plugins/ruflo-metaharness/skills/harness-learn/SKILL.md +65 -65
  441. package/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md +49 -49
  442. package/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md +72 -72
  443. package/plugins/ruflo-metaharness/skills/harness-oia-audit/SKILL.md +79 -79
  444. package/plugins/ruflo-metaharness/skills/harness-score/SKILL.md +66 -66
  445. package/plugins/ruflo-metaharness/skills/harness-security-bench/SKILL.md +101 -101
  446. package/plugins/ruflo-metaharness/skills/harness-similarity/SKILL.md +67 -67
  447. package/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md +41 -41
  448. package/scripts/postinstall.cjs +153 -153
@@ -1,560 +1,560 @@
1
- ---
2
- name: stream-chain
3
- description: Stream-JSON chaining for multi-agent pipelines, data transformation, and sequential workflows
4
- ---
5
-
6
- # Stream-Chain Skill
7
-
8
- Execute sophisticated multi-step workflows where each agent's output flows into the next, enabling complex data transformations and sequential processing pipelines.
9
-
10
- ## Overview
11
-
12
- Stream-Chain provides two powerful modes for orchestrating multi-agent workflows:
13
-
14
- 1. **Custom Chains** (`run`): Execute custom prompt sequences with full control
15
- 2. **Predefined Pipelines** (`pipeline`): Use battle-tested workflows for common tasks
16
-
17
- Each step in a chain receives the complete output from the previous step, enabling sophisticated multi-agent coordination through streaming data flow.
18
-
19
- ---
20
-
21
- ## Quick Start
22
-
23
- ### Run a Custom Chain
24
-
25
- ```bash
26
- claude-flow stream-chain run \
27
- "Analyze codebase structure" \
28
- "Identify improvement areas" \
29
- "Generate action plan"
30
- ```
31
-
32
- ### Execute a Pipeline
33
-
34
- ```bash
35
- claude-flow stream-chain pipeline analysis
36
- ```
37
-
38
- ---
39
-
40
- ## Custom Chains (`run`)
41
-
42
- Execute custom stream chains with your own prompts for maximum flexibility.
43
-
44
- ### Syntax
45
-
46
- ```bash
47
- claude-flow stream-chain run <prompt1> <prompt2> [...] [options]
48
- ```
49
-
50
- **Requirements:**
51
- - Minimum 2 prompts required
52
- - Each prompt becomes a step in the chain
53
- - Output flows sequentially through all steps
54
-
55
- ### Options
56
-
57
- | Option | Description | Default |
58
- |--------|-------------|---------|
59
- | `--verbose` | Show detailed execution information | `false` |
60
- | `--timeout <seconds>` | Timeout per step | `30` |
61
- | `--debug` | Enable debug mode with full logging | `false` |
62
-
63
- ### How Context Flows
64
-
65
- Each step receives the previous output as context:
66
-
67
- ```
68
- Step 1: "Write a sorting function"
69
- Output: [function implementation]
70
-
71
- Step 2 receives:
72
- "Previous step output:
73
- [function implementation]
74
-
75
- Next task: Add comprehensive tests"
76
-
77
- Step 3 receives:
78
- "Previous steps output:
79
- [function + tests]
80
-
81
- Next task: Optimize performance"
82
- ```
83
-
84
- ### Examples
85
-
86
- #### Basic Development Chain
87
-
88
- ```bash
89
- claude-flow stream-chain run \
90
- "Write a user authentication function" \
91
- "Add input validation and error handling" \
92
- "Create unit tests with edge cases"
93
- ```
94
-
95
- #### Security Audit Workflow
96
-
97
- ```bash
98
- claude-flow stream-chain run \
99
- "Analyze authentication system for vulnerabilities" \
100
- "Identify and categorize security issues by severity" \
101
- "Propose fixes with implementation priority" \
102
- "Generate security test cases" \
103
- --timeout 45 \
104
- --verbose
105
- ```
106
-
107
- #### Code Refactoring Chain
108
-
109
- ```bash
110
- claude-flow stream-chain run \
111
- "Identify code smells in src/ directory" \
112
- "Create refactoring plan with specific changes" \
113
- "Apply refactoring to top 3 priority items" \
114
- "Verify refactored code maintains behavior" \
115
- --debug
116
- ```
117
-
118
- #### Data Processing Pipeline
119
-
120
- ```bash
121
- claude-flow stream-chain run \
122
- "Extract data from API responses" \
123
- "Transform data into normalized format" \
124
- "Validate data against schema" \
125
- "Generate data quality report"
126
- ```
127
-
128
- ---
129
-
130
- ## Predefined Pipelines (`pipeline`)
131
-
132
- Execute battle-tested workflows optimized for common development tasks.
133
-
134
- ### Syntax
135
-
136
- ```bash
137
- claude-flow stream-chain pipeline <type> [options]
138
- ```
139
-
140
- ### Available Pipelines
141
-
142
- #### 1. Analysis Pipeline
143
-
144
- Comprehensive codebase analysis and improvement identification.
145
-
146
- ```bash
147
- claude-flow stream-chain pipeline analysis
148
- ```
149
-
150
- **Workflow Steps:**
151
- 1. **Structure Analysis**: Map directory structure and identify components
152
- 2. **Issue Detection**: Find potential improvements and problems
153
- 3. **Recommendations**: Generate actionable improvement report
154
-
155
- **Use Cases:**
156
- - New codebase onboarding
157
- - Technical debt assessment
158
- - Architecture review
159
- - Code quality audits
160
-
161
- #### 2. Refactor Pipeline
162
-
163
- Systematic code refactoring with prioritization.
164
-
165
- ```bash
166
- claude-flow stream-chain pipeline refactor
167
- ```
168
-
169
- **Workflow Steps:**
170
- 1. **Candidate Identification**: Find code needing refactoring
171
- 2. **Prioritization**: Create ranked refactoring plan
172
- 3. **Implementation**: Provide refactored code for top priorities
173
-
174
- **Use Cases:**
175
- - Technical debt reduction
176
- - Code quality improvement
177
- - Legacy code modernization
178
- - Design pattern implementation
179
-
180
- #### 3. Test Pipeline
181
-
182
- Comprehensive test generation with coverage analysis.
183
-
184
- ```bash
185
- claude-flow stream-chain pipeline test
186
- ```
187
-
188
- **Workflow Steps:**
189
- 1. **Coverage Analysis**: Identify areas lacking tests
190
- 2. **Test Design**: Create test cases for critical functions
191
- 3. **Implementation**: Generate unit tests with assertions
192
-
193
- **Use Cases:**
194
- - Increasing test coverage
195
- - TDD workflow support
196
- - Regression test creation
197
- - Quality assurance
198
-
199
- #### 4. Optimize Pipeline
200
-
201
- Performance optimization with profiling and implementation.
202
-
203
- ```bash
204
- claude-flow stream-chain pipeline optimize
205
- ```
206
-
207
- **Workflow Steps:**
208
- 1. **Profiling**: Identify performance bottlenecks
209
- 2. **Strategy**: Analyze and suggest optimization approaches
210
- 3. **Implementation**: Provide optimized code
211
-
212
- **Use Cases:**
213
- - Performance improvement
214
- - Resource optimization
215
- - Scalability enhancement
216
- - Latency reduction
217
-
218
- ### Pipeline Options
219
-
220
- | Option | Description | Default |
221
- |--------|-------------|---------|
222
- | `--verbose` | Show detailed execution | `false` |
223
- | `--timeout <seconds>` | Timeout per step | `30` |
224
- | `--debug` | Enable debug mode | `false` |
225
-
226
- ### Pipeline Examples
227
-
228
- #### Quick Analysis
229
-
230
- ```bash
231
- claude-flow stream-chain pipeline analysis
232
- ```
233
-
234
- #### Extended Refactoring
235
-
236
- ```bash
237
- claude-flow stream-chain pipeline refactor --timeout 60 --verbose
238
- ```
239
-
240
- #### Debug Test Generation
241
-
242
- ```bash
243
- claude-flow stream-chain pipeline test --debug
244
- ```
245
-
246
- #### Comprehensive Optimization
247
-
248
- ```bash
249
- claude-flow stream-chain pipeline optimize --timeout 90 --verbose
250
- ```
251
-
252
- ### Pipeline Output
253
-
254
- Each pipeline execution provides:
255
-
256
- - **Progress**: Step-by-step execution status
257
- - **Results**: Success/failure per step
258
- - **Timing**: Total and per-step execution time
259
- - **Summary**: Consolidated results and recommendations
260
-
261
- ---
262
-
263
- ## Custom Pipeline Definitions
264
-
265
- Define reusable pipelines in `.claude-flow/config.json`:
266
-
267
- ### Configuration Format
268
-
269
- ```json
270
- {
271
- "streamChain": {
272
- "pipelines": {
273
- "security": {
274
- "name": "Security Audit Pipeline",
275
- "description": "Comprehensive security analysis",
276
- "prompts": [
277
- "Scan codebase for security vulnerabilities",
278
- "Categorize issues by severity (critical/high/medium/low)",
279
- "Generate fixes with priority and implementation steps",
280
- "Create security test suite"
281
- ],
282
- "timeout": 45
283
- },
284
- "documentation": {
285
- "name": "Documentation Generation Pipeline",
286
- "prompts": [
287
- "Analyze code structure and identify undocumented areas",
288
- "Generate API documentation with examples",
289
- "Create usage guides and tutorials",
290
- "Build architecture diagrams and flow charts"
291
- ]
292
- }
293
- }
294
- }
295
- }
296
- ```
297
-
298
- ### Execute Custom Pipeline
299
-
300
- ```bash
301
- claude-flow stream-chain pipeline security
302
- claude-flow stream-chain pipeline documentation
303
- ```
304
-
305
- ---
306
-
307
- ## Advanced Use Cases
308
-
309
- ### Multi-Agent Coordination
310
-
311
- Chain different agent types for complex workflows:
312
-
313
- ```bash
314
- claude-flow stream-chain run \
315
- "Research best practices for API design" \
316
- "Design REST API with discovered patterns" \
317
- "Implement API endpoints with validation" \
318
- "Generate OpenAPI specification" \
319
- "Create integration tests" \
320
- "Write deployment documentation"
321
- ```
322
-
323
- ### Data Transformation Pipeline
324
-
325
- Process and transform data through multiple stages:
326
-
327
- ```bash
328
- claude-flow stream-chain run \
329
- "Extract user data from CSV files" \
330
- "Normalize and validate data format" \
331
- "Enrich data with external API calls" \
332
- "Generate analytics report" \
333
- "Create visualization code"
334
- ```
335
-
336
- ### Code Migration Workflow
337
-
338
- Systematic code migration with validation:
339
-
340
- ```bash
341
- claude-flow stream-chain run \
342
- "Analyze legacy codebase dependencies" \
343
- "Create migration plan with risk assessment" \
344
- "Generate modernized code for high-priority modules" \
345
- "Create migration tests" \
346
- "Document migration steps and rollback procedures"
347
- ```
348
-
349
- ### Quality Assurance Chain
350
-
351
- Comprehensive code quality workflow:
352
-
353
- ```bash
354
- claude-flow stream-chain pipeline analysis
355
- claude-flow stream-chain pipeline refactor
356
- claude-flow stream-chain pipeline test
357
- claude-flow stream-chain pipeline optimize
358
- ```
359
-
360
- ---
361
-
362
- ## Best Practices
363
-
364
- ### 1. Clear and Specific Prompts
365
-
366
- **Good:**
367
- ```bash
368
- "Analyze authentication.js for SQL injection vulnerabilities"
369
- ```
370
-
371
- **Avoid:**
372
- ```bash
373
- "Check security"
374
- ```
375
-
376
- ### 2. Logical Progression
377
-
378
- Order prompts to build on previous outputs:
379
- ```bash
380
- 1. "Identify the problem"
381
- 2. "Analyze root causes"
382
- 3. "Design solution"
383
- 4. "Implement solution"
384
- 5. "Verify implementation"
385
- ```
386
-
387
- ### 3. Appropriate Timeouts
388
-
389
- - Simple tasks: 30 seconds (default)
390
- - Analysis tasks: 45-60 seconds
391
- - Implementation tasks: 60-90 seconds
392
- - Complex workflows: 90-120 seconds
393
-
394
- ### 4. Verification Steps
395
-
396
- Include validation in your chains:
397
- ```bash
398
- claude-flow stream-chain run \
399
- "Implement feature X" \
400
- "Write tests for feature X" \
401
- "Verify tests pass and cover edge cases"
402
- ```
403
-
404
- ### 5. Iterative Refinement
405
-
406
- Use chains for iterative improvement:
407
- ```bash
408
- claude-flow stream-chain run \
409
- "Generate initial implementation" \
410
- "Review and identify issues" \
411
- "Refine based on issues found" \
412
- "Final quality check"
413
- ```
414
-
415
- ---
416
-
417
- ## Integration with Claude Flow
418
-
419
- ### Combine with Swarm Coordination
420
-
421
- ```bash
422
- # Initialize swarm for coordination
423
- claude-flow swarm init --topology mesh
424
-
425
- # Execute stream chain with swarm agents
426
- claude-flow stream-chain run \
427
- "Agent 1: Research task" \
428
- "Agent 2: Implement solution" \
429
- "Agent 3: Test implementation" \
430
- "Agent 4: Review and refine"
431
- ```
432
-
433
- ### Memory Integration
434
-
435
- Stream chains automatically store context in memory for cross-session persistence:
436
-
437
- ```bash
438
- # Execute chain with memory
439
- claude-flow stream-chain run \
440
- "Analyze requirements" \
441
- "Design architecture" \
442
- --verbose
443
-
444
- # Results stored in .claude-flow/memory/stream-chain/
445
- ```
446
-
447
- ### Neural Pattern Training
448
-
449
- Successful chains train neural patterns for improved performance:
450
-
451
- ```bash
452
- # Enable neural training
453
- claude-flow stream-chain pipeline optimize --debug
454
-
455
- # Patterns learned and stored for future optimizations
456
- ```
457
-
458
- ---
459
-
460
- ## Troubleshooting
461
-
462
- ### Chain Timeout
463
-
464
- If steps timeout, increase timeout value:
465
-
466
- ```bash
467
- claude-flow stream-chain run "complex task" --timeout 120
468
- ```
469
-
470
- ### Context Loss
471
-
472
- If context not flowing properly, use `--debug`:
473
-
474
- ```bash
475
- claude-flow stream-chain run "step 1" "step 2" --debug
476
- ```
477
-
478
- ### Pipeline Not Found
479
-
480
- Verify pipeline name and custom definitions:
481
-
482
- ```bash
483
- # Check available pipelines
484
- cat .claude-flow/config.json | grep -A 10 "streamChain"
485
- ```
486
-
487
- ---
488
-
489
- ## Performance Characteristics
490
-
491
- - **Throughput**: 2-5 steps per minute (varies by complexity)
492
- - **Context Size**: Up to 100K tokens per step
493
- - **Memory Usage**: ~50MB per active chain
494
- - **Concurrency**: Supports parallel chain execution
495
-
496
- ---
497
-
498
- ## Related Skills
499
-
500
- - **SPARC Methodology**: Systematic development workflow
501
- - **Swarm Coordination**: Multi-agent orchestration
502
- - **Memory Management**: Persistent context storage
503
- - **Neural Patterns**: Adaptive learning
504
-
505
- ---
506
-
507
- ## Examples Repository
508
-
509
- ### Complete Development Workflow
510
-
511
- ```bash
512
- # Full feature development chain
513
- claude-flow stream-chain run \
514
- "Analyze requirements for user profile feature" \
515
- "Design database schema and API endpoints" \
516
- "Implement backend with validation" \
517
- "Create frontend components" \
518
- "Write comprehensive tests" \
519
- "Generate API documentation" \
520
- --timeout 60 \
521
- --verbose
522
- ```
523
-
524
- ### Code Review Pipeline
525
-
526
- ```bash
527
- # Automated code review workflow
528
- claude-flow stream-chain run \
529
- "Analyze recent git changes" \
530
- "Identify code quality issues" \
531
- "Check for security vulnerabilities" \
532
- "Verify test coverage" \
533
- "Generate code review report with recommendations"
534
- ```
535
-
536
- ### Migration Assistant
537
-
538
- ```bash
539
- # Framework migration helper
540
- claude-flow stream-chain run \
541
- "Analyze current Vue 2 codebase" \
542
- "Identify Vue 3 breaking changes" \
543
- "Create migration checklist" \
544
- "Generate migration scripts" \
545
- "Provide updated code examples"
546
- ```
547
-
548
- ---
549
-
550
- ## Conclusion
551
-
552
- Stream-Chain enables sophisticated multi-step workflows by:
553
-
554
- - **Sequential Processing**: Each step builds on previous results
555
- - **Context Preservation**: Full output history flows through chain
556
- - **Flexible Orchestration**: Custom chains or predefined pipelines
557
- - **Agent Coordination**: Natural multi-agent collaboration pattern
558
- - **Data Transformation**: Complex processing through simple steps
559
-
560
- Use `run` for custom workflows and `pipeline` for battle-tested solutions.
1
+ ---
2
+ name: stream-chain
3
+ description: Stream-JSON chaining for multi-agent pipelines, data transformation, and sequential workflows
4
+ ---
5
+
6
+ # Stream-Chain Skill
7
+
8
+ Execute sophisticated multi-step workflows where each agent's output flows into the next, enabling complex data transformations and sequential processing pipelines.
9
+
10
+ ## Overview
11
+
12
+ Stream-Chain provides two powerful modes for orchestrating multi-agent workflows:
13
+
14
+ 1. **Custom Chains** (`run`): Execute custom prompt sequences with full control
15
+ 2. **Predefined Pipelines** (`pipeline`): Use battle-tested workflows for common tasks
16
+
17
+ Each step in a chain receives the complete output from the previous step, enabling sophisticated multi-agent coordination through streaming data flow.
18
+
19
+ ---
20
+
21
+ ## Quick Start
22
+
23
+ ### Run a Custom Chain
24
+
25
+ ```bash
26
+ claude-flow stream-chain run \
27
+ "Analyze codebase structure" \
28
+ "Identify improvement areas" \
29
+ "Generate action plan"
30
+ ```
31
+
32
+ ### Execute a Pipeline
33
+
34
+ ```bash
35
+ claude-flow stream-chain pipeline analysis
36
+ ```
37
+
38
+ ---
39
+
40
+ ## Custom Chains (`run`)
41
+
42
+ Execute custom stream chains with your own prompts for maximum flexibility.
43
+
44
+ ### Syntax
45
+
46
+ ```bash
47
+ claude-flow stream-chain run <prompt1> <prompt2> [...] [options]
48
+ ```
49
+
50
+ **Requirements:**
51
+ - Minimum 2 prompts required
52
+ - Each prompt becomes a step in the chain
53
+ - Output flows sequentially through all steps
54
+
55
+ ### Options
56
+
57
+ | Option | Description | Default |
58
+ |--------|-------------|---------|
59
+ | `--verbose` | Show detailed execution information | `false` |
60
+ | `--timeout <seconds>` | Timeout per step | `30` |
61
+ | `--debug` | Enable debug mode with full logging | `false` |
62
+
63
+ ### How Context Flows
64
+
65
+ Each step receives the previous output as context:
66
+
67
+ ```
68
+ Step 1: "Write a sorting function"
69
+ Output: [function implementation]
70
+
71
+ Step 2 receives:
72
+ "Previous step output:
73
+ [function implementation]
74
+
75
+ Next task: Add comprehensive tests"
76
+
77
+ Step 3 receives:
78
+ "Previous steps output:
79
+ [function + tests]
80
+
81
+ Next task: Optimize performance"
82
+ ```
83
+
84
+ ### Examples
85
+
86
+ #### Basic Development Chain
87
+
88
+ ```bash
89
+ claude-flow stream-chain run \
90
+ "Write a user authentication function" \
91
+ "Add input validation and error handling" \
92
+ "Create unit tests with edge cases"
93
+ ```
94
+
95
+ #### Security Audit Workflow
96
+
97
+ ```bash
98
+ claude-flow stream-chain run \
99
+ "Analyze authentication system for vulnerabilities" \
100
+ "Identify and categorize security issues by severity" \
101
+ "Propose fixes with implementation priority" \
102
+ "Generate security test cases" \
103
+ --timeout 45 \
104
+ --verbose
105
+ ```
106
+
107
+ #### Code Refactoring Chain
108
+
109
+ ```bash
110
+ claude-flow stream-chain run \
111
+ "Identify code smells in src/ directory" \
112
+ "Create refactoring plan with specific changes" \
113
+ "Apply refactoring to top 3 priority items" \
114
+ "Verify refactored code maintains behavior" \
115
+ --debug
116
+ ```
117
+
118
+ #### Data Processing Pipeline
119
+
120
+ ```bash
121
+ claude-flow stream-chain run \
122
+ "Extract data from API responses" \
123
+ "Transform data into normalized format" \
124
+ "Validate data against schema" \
125
+ "Generate data quality report"
126
+ ```
127
+
128
+ ---
129
+
130
+ ## Predefined Pipelines (`pipeline`)
131
+
132
+ Execute battle-tested workflows optimized for common development tasks.
133
+
134
+ ### Syntax
135
+
136
+ ```bash
137
+ claude-flow stream-chain pipeline <type> [options]
138
+ ```
139
+
140
+ ### Available Pipelines
141
+
142
+ #### 1. Analysis Pipeline
143
+
144
+ Comprehensive codebase analysis and improvement identification.
145
+
146
+ ```bash
147
+ claude-flow stream-chain pipeline analysis
148
+ ```
149
+
150
+ **Workflow Steps:**
151
+ 1. **Structure Analysis**: Map directory structure and identify components
152
+ 2. **Issue Detection**: Find potential improvements and problems
153
+ 3. **Recommendations**: Generate actionable improvement report
154
+
155
+ **Use Cases:**
156
+ - New codebase onboarding
157
+ - Technical debt assessment
158
+ - Architecture review
159
+ - Code quality audits
160
+
161
+ #### 2. Refactor Pipeline
162
+
163
+ Systematic code refactoring with prioritization.
164
+
165
+ ```bash
166
+ claude-flow stream-chain pipeline refactor
167
+ ```
168
+
169
+ **Workflow Steps:**
170
+ 1. **Candidate Identification**: Find code needing refactoring
171
+ 2. **Prioritization**: Create ranked refactoring plan
172
+ 3. **Implementation**: Provide refactored code for top priorities
173
+
174
+ **Use Cases:**
175
+ - Technical debt reduction
176
+ - Code quality improvement
177
+ - Legacy code modernization
178
+ - Design pattern implementation
179
+
180
+ #### 3. Test Pipeline
181
+
182
+ Comprehensive test generation with coverage analysis.
183
+
184
+ ```bash
185
+ claude-flow stream-chain pipeline test
186
+ ```
187
+
188
+ **Workflow Steps:**
189
+ 1. **Coverage Analysis**: Identify areas lacking tests
190
+ 2. **Test Design**: Create test cases for critical functions
191
+ 3. **Implementation**: Generate unit tests with assertions
192
+
193
+ **Use Cases:**
194
+ - Increasing test coverage
195
+ - TDD workflow support
196
+ - Regression test creation
197
+ - Quality assurance
198
+
199
+ #### 4. Optimize Pipeline
200
+
201
+ Performance optimization with profiling and implementation.
202
+
203
+ ```bash
204
+ claude-flow stream-chain pipeline optimize
205
+ ```
206
+
207
+ **Workflow Steps:**
208
+ 1. **Profiling**: Identify performance bottlenecks
209
+ 2. **Strategy**: Analyze and suggest optimization approaches
210
+ 3. **Implementation**: Provide optimized code
211
+
212
+ **Use Cases:**
213
+ - Performance improvement
214
+ - Resource optimization
215
+ - Scalability enhancement
216
+ - Latency reduction
217
+
218
+ ### Pipeline Options
219
+
220
+ | Option | Description | Default |
221
+ |--------|-------------|---------|
222
+ | `--verbose` | Show detailed execution | `false` |
223
+ | `--timeout <seconds>` | Timeout per step | `30` |
224
+ | `--debug` | Enable debug mode | `false` |
225
+
226
+ ### Pipeline Examples
227
+
228
+ #### Quick Analysis
229
+
230
+ ```bash
231
+ claude-flow stream-chain pipeline analysis
232
+ ```
233
+
234
+ #### Extended Refactoring
235
+
236
+ ```bash
237
+ claude-flow stream-chain pipeline refactor --timeout 60 --verbose
238
+ ```
239
+
240
+ #### Debug Test Generation
241
+
242
+ ```bash
243
+ claude-flow stream-chain pipeline test --debug
244
+ ```
245
+
246
+ #### Comprehensive Optimization
247
+
248
+ ```bash
249
+ claude-flow stream-chain pipeline optimize --timeout 90 --verbose
250
+ ```
251
+
252
+ ### Pipeline Output
253
+
254
+ Each pipeline execution provides:
255
+
256
+ - **Progress**: Step-by-step execution status
257
+ - **Results**: Success/failure per step
258
+ - **Timing**: Total and per-step execution time
259
+ - **Summary**: Consolidated results and recommendations
260
+
261
+ ---
262
+
263
+ ## Custom Pipeline Definitions
264
+
265
+ Define reusable pipelines in `.claude-flow/config.json`:
266
+
267
+ ### Configuration Format
268
+
269
+ ```json
270
+ {
271
+ "streamChain": {
272
+ "pipelines": {
273
+ "security": {
274
+ "name": "Security Audit Pipeline",
275
+ "description": "Comprehensive security analysis",
276
+ "prompts": [
277
+ "Scan codebase for security vulnerabilities",
278
+ "Categorize issues by severity (critical/high/medium/low)",
279
+ "Generate fixes with priority and implementation steps",
280
+ "Create security test suite"
281
+ ],
282
+ "timeout": 45
283
+ },
284
+ "documentation": {
285
+ "name": "Documentation Generation Pipeline",
286
+ "prompts": [
287
+ "Analyze code structure and identify undocumented areas",
288
+ "Generate API documentation with examples",
289
+ "Create usage guides and tutorials",
290
+ "Build architecture diagrams and flow charts"
291
+ ]
292
+ }
293
+ }
294
+ }
295
+ }
296
+ ```
297
+
298
+ ### Execute Custom Pipeline
299
+
300
+ ```bash
301
+ claude-flow stream-chain pipeline security
302
+ claude-flow stream-chain pipeline documentation
303
+ ```
304
+
305
+ ---
306
+
307
+ ## Advanced Use Cases
308
+
309
+ ### Multi-Agent Coordination
310
+
311
+ Chain different agent types for complex workflows:
312
+
313
+ ```bash
314
+ claude-flow stream-chain run \
315
+ "Research best practices for API design" \
316
+ "Design REST API with discovered patterns" \
317
+ "Implement API endpoints with validation" \
318
+ "Generate OpenAPI specification" \
319
+ "Create integration tests" \
320
+ "Write deployment documentation"
321
+ ```
322
+
323
+ ### Data Transformation Pipeline
324
+
325
+ Process and transform data through multiple stages:
326
+
327
+ ```bash
328
+ claude-flow stream-chain run \
329
+ "Extract user data from CSV files" \
330
+ "Normalize and validate data format" \
331
+ "Enrich data with external API calls" \
332
+ "Generate analytics report" \
333
+ "Create visualization code"
334
+ ```
335
+
336
+ ### Code Migration Workflow
337
+
338
+ Systematic code migration with validation:
339
+
340
+ ```bash
341
+ claude-flow stream-chain run \
342
+ "Analyze legacy codebase dependencies" \
343
+ "Create migration plan with risk assessment" \
344
+ "Generate modernized code for high-priority modules" \
345
+ "Create migration tests" \
346
+ "Document migration steps and rollback procedures"
347
+ ```
348
+
349
+ ### Quality Assurance Chain
350
+
351
+ Comprehensive code quality workflow:
352
+
353
+ ```bash
354
+ claude-flow stream-chain pipeline analysis
355
+ claude-flow stream-chain pipeline refactor
356
+ claude-flow stream-chain pipeline test
357
+ claude-flow stream-chain pipeline optimize
358
+ ```
359
+
360
+ ---
361
+
362
+ ## Best Practices
363
+
364
+ ### 1. Clear and Specific Prompts
365
+
366
+ **Good:**
367
+ ```bash
368
+ "Analyze authentication.js for SQL injection vulnerabilities"
369
+ ```
370
+
371
+ **Avoid:**
372
+ ```bash
373
+ "Check security"
374
+ ```
375
+
376
+ ### 2. Logical Progression
377
+
378
+ Order prompts to build on previous outputs:
379
+ ```bash
380
+ 1. "Identify the problem"
381
+ 2. "Analyze root causes"
382
+ 3. "Design solution"
383
+ 4. "Implement solution"
384
+ 5. "Verify implementation"
385
+ ```
386
+
387
+ ### 3. Appropriate Timeouts
388
+
389
+ - Simple tasks: 30 seconds (default)
390
+ - Analysis tasks: 45-60 seconds
391
+ - Implementation tasks: 60-90 seconds
392
+ - Complex workflows: 90-120 seconds
393
+
394
+ ### 4. Verification Steps
395
+
396
+ Include validation in your chains:
397
+ ```bash
398
+ claude-flow stream-chain run \
399
+ "Implement feature X" \
400
+ "Write tests for feature X" \
401
+ "Verify tests pass and cover edge cases"
402
+ ```
403
+
404
+ ### 5. Iterative Refinement
405
+
406
+ Use chains for iterative improvement:
407
+ ```bash
408
+ claude-flow stream-chain run \
409
+ "Generate initial implementation" \
410
+ "Review and identify issues" \
411
+ "Refine based on issues found" \
412
+ "Final quality check"
413
+ ```
414
+
415
+ ---
416
+
417
+ ## Integration with Claude Flow
418
+
419
+ ### Combine with Swarm Coordination
420
+
421
+ ```bash
422
+ # Initialize swarm for coordination
423
+ claude-flow swarm init --topology mesh
424
+
425
+ # Execute stream chain with swarm agents
426
+ claude-flow stream-chain run \
427
+ "Agent 1: Research task" \
428
+ "Agent 2: Implement solution" \
429
+ "Agent 3: Test implementation" \
430
+ "Agent 4: Review and refine"
431
+ ```
432
+
433
+ ### Memory Integration
434
+
435
+ Stream chains automatically store context in memory for cross-session persistence:
436
+
437
+ ```bash
438
+ # Execute chain with memory
439
+ claude-flow stream-chain run \
440
+ "Analyze requirements" \
441
+ "Design architecture" \
442
+ --verbose
443
+
444
+ # Results stored in .claude-flow/memory/stream-chain/
445
+ ```
446
+
447
+ ### Neural Pattern Training
448
+
449
+ Successful chains train neural patterns for improved performance:
450
+
451
+ ```bash
452
+ # Enable neural training
453
+ claude-flow stream-chain pipeline optimize --debug
454
+
455
+ # Patterns learned and stored for future optimizations
456
+ ```
457
+
458
+ ---
459
+
460
+ ## Troubleshooting
461
+
462
+ ### Chain Timeout
463
+
464
+ If steps timeout, increase timeout value:
465
+
466
+ ```bash
467
+ claude-flow stream-chain run "complex task" --timeout 120
468
+ ```
469
+
470
+ ### Context Loss
471
+
472
+ If context not flowing properly, use `--debug`:
473
+
474
+ ```bash
475
+ claude-flow stream-chain run "step 1" "step 2" --debug
476
+ ```
477
+
478
+ ### Pipeline Not Found
479
+
480
+ Verify pipeline name and custom definitions:
481
+
482
+ ```bash
483
+ # Check available pipelines
484
+ cat .claude-flow/config.json | grep -A 10 "streamChain"
485
+ ```
486
+
487
+ ---
488
+
489
+ ## Performance Characteristics
490
+
491
+ - **Throughput**: 2-5 steps per minute (varies by complexity)
492
+ - **Context Size**: Up to 100K tokens per step
493
+ - **Memory Usage**: ~50MB per active chain
494
+ - **Concurrency**: Supports parallel chain execution
495
+
496
+ ---
497
+
498
+ ## Related Skills
499
+
500
+ - **SPARC Methodology**: Systematic development workflow
501
+ - **Swarm Coordination**: Multi-agent orchestration
502
+ - **Memory Management**: Persistent context storage
503
+ - **Neural Patterns**: Adaptive learning
504
+
505
+ ---
506
+
507
+ ## Examples Repository
508
+
509
+ ### Complete Development Workflow
510
+
511
+ ```bash
512
+ # Full feature development chain
513
+ claude-flow stream-chain run \
514
+ "Analyze requirements for user profile feature" \
515
+ "Design database schema and API endpoints" \
516
+ "Implement backend with validation" \
517
+ "Create frontend components" \
518
+ "Write comprehensive tests" \
519
+ "Generate API documentation" \
520
+ --timeout 60 \
521
+ --verbose
522
+ ```
523
+
524
+ ### Code Review Pipeline
525
+
526
+ ```bash
527
+ # Automated code review workflow
528
+ claude-flow stream-chain run \
529
+ "Analyze recent git changes" \
530
+ "Identify code quality issues" \
531
+ "Check for security vulnerabilities" \
532
+ "Verify test coverage" \
533
+ "Generate code review report with recommendations"
534
+ ```
535
+
536
+ ### Migration Assistant
537
+
538
+ ```bash
539
+ # Framework migration helper
540
+ claude-flow stream-chain run \
541
+ "Analyze current Vue 2 codebase" \
542
+ "Identify Vue 3 breaking changes" \
543
+ "Create migration checklist" \
544
+ "Generate migration scripts" \
545
+ "Provide updated code examples"
546
+ ```
547
+
548
+ ---
549
+
550
+ ## Conclusion
551
+
552
+ Stream-Chain enables sophisticated multi-step workflows by:
553
+
554
+ - **Sequential Processing**: Each step builds on previous results
555
+ - **Context Preservation**: Full output history flows through chain
556
+ - **Flexible Orchestration**: Custom chains or predefined pipelines
557
+ - **Agent Coordination**: Natural multi-agent collaboration pattern
558
+ - **Data Transformation**: Complex processing through simple steps
559
+
560
+ Use `run` for custom workflows and `pipeline` for battle-tested solutions.