claude-flow 3.6.30 → 3.7.0-alpha.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 (453) 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 +201 -201
  27. package/.claude/agents/dual-mode/codex-worker.md +183 -183
  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 +335 -335
  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 +547 -547
  48. package/.claude/agents/github/swarm-pr.md +398 -398
  49. package/.claude/agents/github/sync-coordinator.md +422 -422
  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/README.md +96 -96
  281. package/.claude/helpers/adr-compliance.sh +186 -186
  282. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  283. package/.claude/helpers/auto-commit.sh +178 -178
  284. package/.claude/helpers/auto-memory-hook.mjs +564 -564
  285. package/.claude/helpers/checkpoint-manager.sh +251 -251
  286. package/.claude/helpers/context-persistence-hook.mjs +1979 -1979
  287. package/.claude/helpers/daemon-manager.sh +252 -252
  288. package/.claude/helpers/ddd-tracker.sh +144 -144
  289. package/.claude/helpers/github-safe.js +106 -106
  290. package/.claude/helpers/github-setup.sh +28 -28
  291. package/.claude/helpers/guidance-hook.sh +13 -13
  292. package/.claude/helpers/guidance-hooks.sh +102 -102
  293. package/.claude/helpers/health-monitor.sh +108 -108
  294. package/.claude/helpers/hook-handler.cjs +263 -263
  295. package/.claude/helpers/intelligence.cjs +230 -230
  296. package/.claude/helpers/learning-hooks.sh +329 -329
  297. package/.claude/helpers/learning-optimizer.sh +127 -127
  298. package/.claude/helpers/learning-service.mjs +1144 -1144
  299. package/.claude/helpers/memory.cjs +84 -84
  300. package/.claude/helpers/metrics-db.mjs +488 -488
  301. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  302. package/.claude/helpers/pattern-consolidator.sh +86 -86
  303. package/.claude/helpers/perf-worker.sh +160 -160
  304. package/.claude/helpers/quick-start.sh +19 -19
  305. package/.claude/helpers/router.cjs +62 -62
  306. package/.claude/helpers/security-scanner.sh +127 -127
  307. package/.claude/helpers/session.cjs +125 -125
  308. package/.claude/helpers/setup-mcp.sh +18 -18
  309. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  310. package/.claude/helpers/statusline.cjs +819 -809
  311. package/.claude/helpers/swarm-comms.sh +353 -353
  312. package/.claude/helpers/swarm-hooks.sh +761 -761
  313. package/.claude/helpers/swarm-monitor.sh +210 -210
  314. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  315. package/.claude/helpers/update-v3-progress.sh +165 -165
  316. package/.claude/helpers/v3-quick-status.sh +57 -57
  317. package/.claude/helpers/v3.sh +110 -110
  318. package/.claude/helpers/validate-v3-config.sh +215 -215
  319. package/.claude/helpers/worker-manager.sh +170 -170
  320. package/.claude/mcp.json +12 -12
  321. package/.claude/scheduled_tasks.lock +1 -1
  322. package/.claude/settings.json +283 -283
  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/dual-mode/README.md +71 -71
  331. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  332. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  333. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  334. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  335. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  336. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  337. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  338. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  339. package/.claude/skills/github-project-management/SKILL.md +1263 -1250
  340. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  341. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  342. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  343. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  344. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  345. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  346. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  347. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  348. package/.claude/skills/skill-builder/SKILL.md +910 -910
  349. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  350. package/.claude/skills/stream-chain/SKILL.md +560 -560
  351. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  352. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  353. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  354. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  355. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  356. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  357. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  358. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  359. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  360. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  361. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  362. package/.claude/skills/verification-quality/SKILL.md +647 -647
  363. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  364. package/.claude/skills/worker-integration/SKILL.md +147 -147
  365. package/.claude/statusline-command.sh +176 -176
  366. package/.claude/statusline.mjs +109 -109
  367. package/.claude/statusline.sh +431 -431
  368. package/.claude-plugin/README.md +720 -720
  369. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  370. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  371. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  372. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  373. package/.claude-plugin/hooks/hooks.json +74 -74
  374. package/.claude-plugin/marketplace.json +170 -170
  375. package/.claude-plugin/plugin.json +71 -71
  376. package/.claude-plugin/scripts/install.sh +234 -234
  377. package/.claude-plugin/scripts/uninstall.sh +36 -36
  378. package/.claude-plugin/scripts/verify.sh +108 -108
  379. package/LICENSE +21 -21
  380. package/README.md +393 -391
  381. package/bin/cli.js +11 -11
  382. package/bin/npx-repair.js +7 -7
  383. package/bin/npx-safe-launch.js +9 -9
  384. package/package.json +7 -1
  385. package/v3/@claude-flow/cli/README.md +393 -391
  386. package/v3/@claude-flow/cli/bin/cli.js +220 -220
  387. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  388. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  389. package/v3/@claude-flow/cli/dist/src/commands/agent-wasm.js +2 -2
  390. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  391. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +19 -3
  392. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +105 -23
  393. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  394. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +122 -104
  395. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +34 -21
  396. package/v3/@claude-flow/cli/dist/src/commands/memory.js +68 -0
  397. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  398. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  399. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  400. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  401. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  402. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  403. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  404. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  405. package/v3/@claude-flow/cli/dist/src/index.d.ts +5 -1
  406. package/v3/@claude-flow/cli/dist/src/index.js +59 -18
  407. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +226 -226
  408. package/v3/@claude-flow/cli/dist/src/init/executor.js +511 -453
  409. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +645 -645
  410. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +11 -5
  411. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +858 -858
  412. package/v3/@claude-flow/cli/dist/src/init/types.d.ts +7 -0
  413. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  414. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +108 -0
  415. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +4 -2
  416. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +19 -0
  417. package/v3/@claude-flow/cli/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +28 -3
  419. package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js +72 -3
  420. package/v3/@claude-flow/cli/dist/src/mcp-tools/types.d.ts +4 -33
  421. package/v3/@claude-flow/cli/dist/src/mcp-tools/types.js +4 -14
  422. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.d.ts +5 -57
  423. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.js +5 -233
  424. package/v3/@claude-flow/cli/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  425. package/v3/@claude-flow/cli/dist/src/memory/intelligence.js +28 -3
  426. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +69 -0
  427. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +319 -66
  428. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +5 -0
  429. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +369 -363
  430. package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.d.ts +48 -0
  431. package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.js +87 -0
  432. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  433. package/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js +1 -0
  434. package/v3/@claude-flow/cli/dist/src/output.d.ts +6 -130
  435. package/v3/@claude-flow/cli/dist/src/output.js +6 -511
  436. package/v3/@claude-flow/cli/dist/src/parser.d.ts +9 -0
  437. package/v3/@claude-flow/cli/dist/src/parser.js +11 -0
  438. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  439. package/v3/@claude-flow/cli/dist/src/ruvector/agent-wasm.js +4 -1
  440. package/v3/@claude-flow/cli/dist/src/ruvector/index.d.ts +0 -2
  441. package/v3/@claude-flow/cli/dist/src/ruvector/index.js +8 -2
  442. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.d.ts +22 -1
  443. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.js +125 -5
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  446. package/v3/@claude-flow/cli/dist/src/types.d.ts +10 -195
  447. package/v3/@claude-flow/cli/dist/src/types.js +10 -35
  448. package/v3/@claude-flow/cli/package.json +6 -4
  449. package/v3/@claude-flow/guidance/README.md +1195 -1195
  450. package/v3/@claude-flow/guidance/package.json +198 -198
  451. package/v3/@claude-flow/shared/README.md +323 -323
  452. package/v3/@claude-flow/shared/package.json +43 -43
  453. package/v3/README.md +493 -493
@@ -1,399 +1,399 @@
1
- ---
2
- name: swarm-pr
3
- description: |
4
- Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
5
- tools: mcp__github__get_pull_request, mcp__github__create_pull_request, mcp__github__update_pull_request, mcp__github__list_pull_requests, mcp__github__create_pr_comment, mcp__github__get_pr_diff, mcp__github__merge_pull_request, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, mcp__claude-flow__coordination_sync, TodoWrite, TodoRead, Bash, Grep, Read, Write, Edit
6
- ---
7
-
8
- # Swarm PR - Managing Swarms through Pull Requests
9
-
10
- ## Overview
11
- Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
12
-
13
- ## Core Features
14
-
15
- ### 1. PR-Based Swarm Creation
16
- ```bash
17
- # Create swarm from PR description using gh CLI
18
- gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
19
-
20
- # Auto-spawn agents based on PR labels
21
- gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
22
-
23
- # Create swarm with PR context
24
- gh pr view 123 --json body,labels,author,assignees | \
25
- npx ruv-swarm swarm init --from-pr-data
26
- ```
27
-
28
- ### 2. PR Comment Commands
29
- Execute swarm commands via PR comments:
30
-
31
- ```markdown
32
- <!-- In PR comment -->
33
- /swarm init mesh 6
34
- /swarm spawn coder "Implement authentication"
35
- /swarm spawn tester "Write unit tests"
36
- /swarm status
37
- ```
38
-
39
- ### 3. Automated PR Workflows
40
-
41
- ```yaml
42
- # .github/workflows/swarm-pr.yml
43
- name: Swarm PR Handler
44
- on:
45
- pull_request:
46
- types: [opened, labeled]
47
- issue_comment:
48
- types: [created]
49
-
50
- jobs:
51
- swarm-handler:
52
- runs-on: ubuntu-latest
53
- steps:
54
- - uses: actions/checkout@v3
55
- - name: Handle Swarm Command
56
- run: |
57
- if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
58
- npx ruv-swarm github handle-comment \
59
- --pr ${{ github.event.pull_request.number }} \
60
- --comment "${{ github.event.comment.body }}"
61
- fi
62
- ```
63
-
64
- ## PR Label Integration
65
-
66
- ### Automatic Agent Assignment
67
- Map PR labels to agent types:
68
-
69
- ```json
70
- {
71
- "label-mapping": {
72
- "bug": ["debugger", "tester"],
73
- "feature": ["architect", "coder", "tester"],
74
- "refactor": ["analyst", "coder"],
75
- "docs": ["researcher", "writer"],
76
- "performance": ["analyst", "optimizer"]
77
- }
78
- }
79
- ```
80
-
81
- ### Label-Based Topology
82
- ```bash
83
- # Small PR (< 100 lines): ring topology
84
- # Medium PR (100-500 lines): mesh topology
85
- # Large PR (> 500 lines): hierarchical topology
86
- npx ruv-swarm github pr-topology --pr 123
87
- ```
88
-
89
- ## PR Swarm Commands
90
-
91
- ### Initialize from PR
92
- ```bash
93
- # Create swarm with PR context using gh CLI
94
- PR_DIFF=$(gh pr diff 123)
95
- PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
96
-
97
- npx ruv-swarm github pr-init 123 \
98
- --auto-agents \
99
- --pr-data "$PR_INFO" \
100
- --diff "$PR_DIFF" \
101
- --analyze-impact
102
- ```
103
-
104
- ### Progress Updates
105
- ```bash
106
- # Post swarm progress to PR using gh CLI
107
- PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
108
-
109
- gh pr comment 123 --body "$PROGRESS"
110
-
111
- # Update PR labels based on progress
112
- if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
113
- gh pr edit 123 --add-label "ready-for-review"
114
- fi
115
- ```
116
-
117
- ### Code Review Integration
118
- ```bash
119
- # Create review agents with gh CLI integration
120
- PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
121
-
122
- # Run swarm review
123
- REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
124
- --agents "security,performance,style" \
125
- --files "$PR_FILES")
126
-
127
- # Post review comments using gh CLI
128
- echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
129
- FILE=$(echo "$comment" | jq -r '.file')
130
- LINE=$(echo "$comment" | jq -r '.line')
131
- BODY=$(echo "$comment" | jq -r '.body')
132
-
133
- gh pr review 123 --comment --body "$BODY"
134
- done
135
- ```
136
-
137
- ## Advanced Features
138
-
139
- ### 1. Multi-PR Swarm Coordination
140
- ```bash
141
- # Coordinate swarms across related PRs
142
- npx ruv-swarm github multi-pr \
143
- --prs "123,124,125" \
144
- --strategy "parallel" \
145
- --share-memory
146
- ```
147
-
148
- ### 2. PR Dependency Analysis
149
- ```bash
150
- # Analyze PR dependencies
151
- npx ruv-swarm github pr-deps 123 \
152
- --spawn-agents \
153
- --resolve-conflicts
154
- ```
155
-
156
- ### 3. Automated PR Fixes
157
- ```bash
158
- # Auto-fix PR issues
159
- npx ruv-swarm github pr-fix 123 \
160
- --issues "lint,test-failures" \
161
- --commit-fixes
162
- ```
163
-
164
- ## Best Practices
165
-
166
- ### 1. PR Templates
167
- ```markdown
168
- <!-- .github/pull_request_template.md -->
169
- ## Swarm Configuration
170
- - Topology: [mesh/hierarchical/ring/star]
171
- - Max Agents: [number]
172
- - Auto-spawn: [yes/no]
173
- - Priority: [high/medium/low]
174
-
175
- ## Tasks for Swarm
176
- - [ ] Task 1 description
177
- - [ ] Task 2 description
178
- ```
179
-
180
- ### 2. Status Checks
181
- ```yaml
182
- # Require swarm completion before merge
183
- required_status_checks:
184
- contexts:
185
- - "swarm/tasks-complete"
186
- - "swarm/tests-pass"
187
- - "swarm/review-approved"
188
- ```
189
-
190
- ### 3. PR Merge Automation
191
- ```bash
192
- # Auto-merge when swarm completes using gh CLI
193
- # Check swarm completion status
194
- SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
195
-
196
- if [[ "$SWARM_STATUS" == "complete" ]]; then
197
- # Check review requirements
198
- REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
199
-
200
- if [[ $REVIEWS -ge 2 ]]; then
201
- # Enable auto-merge
202
- gh pr merge 123 --auto --squash
203
- fi
204
- fi
205
- ```
206
-
207
- ## Webhook Integration
208
-
209
- ### Setup Webhook Handler
210
- ```javascript
211
- // webhook-handler.js
212
- const { createServer } = require('http');
213
- const { execSync } = require('child_process');
214
-
215
- createServer((req, res) => {
216
- if (req.url === '/github-webhook') {
217
- const event = JSON.parse(body);
218
-
219
- if (event.action === 'opened' && event.pull_request) {
220
- execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
221
- }
222
-
223
- res.writeHead(200);
224
- res.end('OK');
225
- }
226
- }).listen(3000);
227
- ```
228
-
229
- ## Examples
230
-
231
- ### Feature Development PR
232
- ```bash
233
- # PR #456: Add user authentication
234
- npx ruv-swarm github pr-init 456 \
235
- --topology hierarchical \
236
- --agents "architect,coder,tester,security" \
237
- --auto-assign-tasks
238
- ```
239
-
240
- ### Bug Fix PR
241
- ```bash
242
- # PR #789: Fix memory leak
243
- npx ruv-swarm github pr-init 789 \
244
- --topology mesh \
245
- --agents "debugger,analyst,tester" \
246
- --priority high
247
- ```
248
-
249
- ### Documentation PR
250
- ```bash
251
- # PR #321: Update API docs
252
- npx ruv-swarm github pr-init 321 \
253
- --topology ring \
254
- --agents "researcher,writer,reviewer" \
255
- --validate-links
256
- ```
257
-
258
- ## Metrics & Reporting
259
-
260
- ### PR Swarm Analytics
261
- ```bash
262
- # Generate PR swarm report
263
- npx ruv-swarm github pr-report 123 \
264
- --metrics "completion-time,agent-efficiency,token-usage" \
265
- --format markdown
266
- ```
267
-
268
- ### Dashboard Integration
269
- ```bash
270
- # Export to GitHub Insights
271
- npx ruv-swarm github export-metrics \
272
- --pr 123 \
273
- --to-insights
274
- ```
275
-
276
- ## Security Considerations
277
-
278
- 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
279
- 2. **Command Validation**: Validate all PR comments before execution
280
- 3. **Rate Limiting**: Implement rate limits for PR operations
281
- 4. **Audit Trail**: Log all swarm operations for compliance
282
-
283
- ## Integration with Claude Code
284
-
285
- When using with Claude Code:
286
- 1. Claude Code reads PR diff and context
287
- 2. Swarm coordinates approach based on PR type
288
- 3. Agents work in parallel on different aspects
289
- 4. Progress updates posted to PR automatically
290
- 5. Final review performed before marking ready
291
-
292
- ## Advanced Swarm PR Coordination
293
-
294
- ### Multi-Agent PR Analysis
295
- ```bash
296
- # Initialize PR-specific swarm with intelligent topology selection
297
- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
298
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
299
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
300
- mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
301
- mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
302
- mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
303
-
304
- # Store PR context for swarm coordination
305
- mcp__claude-flow__memory_usage {
306
- action: "store",
307
- key: "pr/#{pr_number}/analysis",
308
- value: {
309
- diff: "pr_diff_content",
310
- files_changed: ["file1.js", "file2.py"],
311
- complexity_score: 8.5,
312
- risk_assessment: "medium"
313
- }
314
- }
315
-
316
- # Orchestrate comprehensive PR workflow
317
- mcp__claude-flow__task_orchestrate {
318
- task: "Execute multi-agent PR review and validation workflow",
319
- strategy: "parallel",
320
- priority: "high",
321
- dependencies: ["diff_analysis", "test_validation", "security_review"]
322
- }
323
- ```
324
-
325
- ### Swarm-Coordinated PR Lifecycle
326
- ```javascript
327
- // Pre-hook: PR Initialization and Swarm Setup
328
- const prPreHook = async (prData) => {
329
- // Analyze PR complexity for optimal swarm configuration
330
- const complexity = await analyzePRComplexity(prData);
331
- const topology = complexity > 7 ? "hierarchical" : "mesh";
332
-
333
- // Initialize swarm with PR-specific configuration
334
- await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
335
-
336
- // Store comprehensive PR context
337
- await mcp__claude_flow__memory_usage({
338
- action: "store",
339
- key: `pr/${prData.number}/context`,
340
- value: {
341
- pr: prData,
342
- complexity,
343
- agents_assigned: await getOptimalAgents(prData),
344
- timeline: generateTimeline(prData)
345
- }
346
- });
347
-
348
- // Coordinate initial agent synchronization
349
- await mcp__claude_flow__coordination_sync({ swarmId: "current" });
350
- };
351
-
352
- // Post-hook: PR Completion and Metrics
353
- const prPostHook = async (results) => {
354
- // Generate comprehensive PR completion report
355
- const report = await generatePRReport(results);
356
-
357
- // Update PR with final swarm analysis
358
- await updatePRWithResults(report);
359
-
360
- // Store completion metrics for future optimization
361
- await mcp__claude_flow__memory_usage({
362
- action: "store",
363
- key: `pr/${results.number}/completion`,
364
- value: {
365
- completion_time: results.duration,
366
- agent_efficiency: results.agentMetrics,
367
- quality_score: results.qualityAssessment,
368
- lessons_learned: results.insights
369
- }
370
- });
371
- };
372
- ```
373
-
374
- ### Intelligent PR Merge Coordination
375
- ```bash
376
- # Coordinate merge decision with swarm consensus
377
- mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
378
-
379
- # Analyze merge readiness with multiple agents
380
- mcp__claude-flow__task_orchestrate {
381
- task: "Evaluate PR merge readiness with comprehensive validation",
382
- strategy: "sequential",
383
- priority: "critical"
384
- }
385
-
386
- # Store merge decision context
387
- mcp__claude-flow__memory_usage {
388
- action: "store",
389
- key: "pr/merge_decisions/#{pr_number}",
390
- value: {
391
- ready_to_merge: true,
392
- validation_passed: true,
393
- agent_consensus: "approved",
394
- final_review_score: 9.2
395
- }
396
- }
397
- ```
398
-
1
+ ---
2
+ name: swarm-pr
3
+ description: |
4
+ Pull request swarm management agent that coordinates multi-agent code review, validation, and integration workflows with automated PR lifecycle management
5
+ tools: mcp__github__get_pull_request, mcp__github__create_pull_request, mcp__github__update_pull_request, mcp__github__list_pull_requests, mcp__github__create_pr_comment, mcp__github__get_pr_diff, mcp__github__merge_pull_request, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__memory_usage, mcp__claude-flow__coordination_sync, TodoWrite, TodoRead, Bash, Grep, Read, Write, Edit
6
+ ---
7
+
8
+ # Swarm PR - Managing Swarms through Pull Requests
9
+
10
+ ## Overview
11
+ Create and manage AI swarms directly from GitHub Pull Requests, enabling seamless integration with your development workflow through intelligent multi-agent coordination.
12
+
13
+ ## Core Features
14
+
15
+ ### 1. PR-Based Swarm Creation
16
+ ```bash
17
+ # Create swarm from PR description using gh CLI
18
+ gh pr view 123 --json body,title,labels,files | npx ruv-swarm swarm create-from-pr
19
+
20
+ # Auto-spawn agents based on PR labels
21
+ gh pr view 123 --json labels | npx ruv-swarm swarm auto-spawn
22
+
23
+ # Create swarm with PR context
24
+ gh pr view 123 --json body,labels,author,assignees | \
25
+ npx ruv-swarm swarm init --from-pr-data
26
+ ```
27
+
28
+ ### 2. PR Comment Commands
29
+ Execute swarm commands via PR comments:
30
+
31
+ ```markdown
32
+ <!-- In PR comment -->
33
+ /swarm init mesh 6
34
+ /swarm spawn coder "Implement authentication"
35
+ /swarm spawn tester "Write unit tests"
36
+ /swarm status
37
+ ```
38
+
39
+ ### 3. Automated PR Workflows
40
+
41
+ ```yaml
42
+ # .github/workflows/swarm-pr.yml
43
+ name: Swarm PR Handler
44
+ on:
45
+ pull_request:
46
+ types: [opened, labeled]
47
+ issue_comment:
48
+ types: [created]
49
+
50
+ jobs:
51
+ swarm-handler:
52
+ runs-on: ubuntu-latest
53
+ steps:
54
+ - uses: actions/checkout@v3
55
+ - name: Handle Swarm Command
56
+ run: |
57
+ if [[ "${{ github.event.comment.body }}" == /swarm* ]]; then
58
+ npx ruv-swarm github handle-comment \
59
+ --pr ${{ github.event.pull_request.number }} \
60
+ --comment "${{ github.event.comment.body }}"
61
+ fi
62
+ ```
63
+
64
+ ## PR Label Integration
65
+
66
+ ### Automatic Agent Assignment
67
+ Map PR labels to agent types:
68
+
69
+ ```json
70
+ {
71
+ "label-mapping": {
72
+ "bug": ["debugger", "tester"],
73
+ "feature": ["architect", "coder", "tester"],
74
+ "refactor": ["analyst", "coder"],
75
+ "docs": ["researcher", "writer"],
76
+ "performance": ["analyst", "optimizer"]
77
+ }
78
+ }
79
+ ```
80
+
81
+ ### Label-Based Topology
82
+ ```bash
83
+ # Small PR (< 100 lines): ring topology
84
+ # Medium PR (100-500 lines): mesh topology
85
+ # Large PR (> 500 lines): hierarchical topology
86
+ npx ruv-swarm github pr-topology --pr 123
87
+ ```
88
+
89
+ ## PR Swarm Commands
90
+
91
+ ### Initialize from PR
92
+ ```bash
93
+ # Create swarm with PR context using gh CLI
94
+ PR_DIFF=$(gh pr diff 123)
95
+ PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
96
+
97
+ npx ruv-swarm github pr-init 123 \
98
+ --auto-agents \
99
+ --pr-data "$PR_INFO" \
100
+ --diff "$PR_DIFF" \
101
+ --analyze-impact
102
+ ```
103
+
104
+ ### Progress Updates
105
+ ```bash
106
+ # Post swarm progress to PR using gh CLI
107
+ PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
108
+
109
+ gh pr comment 123 --body "$PROGRESS"
110
+
111
+ # Update PR labels based on progress
112
+ if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
113
+ gh pr edit 123 --add-label "ready-for-review"
114
+ fi
115
+ ```
116
+
117
+ ### Code Review Integration
118
+ ```bash
119
+ # Create review agents with gh CLI integration
120
+ PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
121
+
122
+ # Run swarm review
123
+ REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
124
+ --agents "security,performance,style" \
125
+ --files "$PR_FILES")
126
+
127
+ # Post review comments using gh CLI
128
+ echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
129
+ FILE=$(echo "$comment" | jq -r '.file')
130
+ LINE=$(echo "$comment" | jq -r '.line')
131
+ BODY=$(echo "$comment" | jq -r '.body')
132
+
133
+ gh pr review 123 --comment --body "$BODY"
134
+ done
135
+ ```
136
+
137
+ ## Advanced Features
138
+
139
+ ### 1. Multi-PR Swarm Coordination
140
+ ```bash
141
+ # Coordinate swarms across related PRs
142
+ npx ruv-swarm github multi-pr \
143
+ --prs "123,124,125" \
144
+ --strategy "parallel" \
145
+ --share-memory
146
+ ```
147
+
148
+ ### 2. PR Dependency Analysis
149
+ ```bash
150
+ # Analyze PR dependencies
151
+ npx ruv-swarm github pr-deps 123 \
152
+ --spawn-agents \
153
+ --resolve-conflicts
154
+ ```
155
+
156
+ ### 3. Automated PR Fixes
157
+ ```bash
158
+ # Auto-fix PR issues
159
+ npx ruv-swarm github pr-fix 123 \
160
+ --issues "lint,test-failures" \
161
+ --commit-fixes
162
+ ```
163
+
164
+ ## Best Practices
165
+
166
+ ### 1. PR Templates
167
+ ```markdown
168
+ <!-- .github/pull_request_template.md -->
169
+ ## Swarm Configuration
170
+ - Topology: [mesh/hierarchical/ring/star]
171
+ - Max Agents: [number]
172
+ - Auto-spawn: [yes/no]
173
+ - Priority: [high/medium/low]
174
+
175
+ ## Tasks for Swarm
176
+ - [ ] Task 1 description
177
+ - [ ] Task 2 description
178
+ ```
179
+
180
+ ### 2. Status Checks
181
+ ```yaml
182
+ # Require swarm completion before merge
183
+ required_status_checks:
184
+ contexts:
185
+ - "swarm/tasks-complete"
186
+ - "swarm/tests-pass"
187
+ - "swarm/review-approved"
188
+ ```
189
+
190
+ ### 3. PR Merge Automation
191
+ ```bash
192
+ # Auto-merge when swarm completes using gh CLI
193
+ # Check swarm completion status
194
+ SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
195
+
196
+ if [[ "$SWARM_STATUS" == "complete" ]]; then
197
+ # Check review requirements
198
+ REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
199
+
200
+ if [[ $REVIEWS -ge 2 ]]; then
201
+ # Enable auto-merge
202
+ gh pr merge 123 --auto --squash
203
+ fi
204
+ fi
205
+ ```
206
+
207
+ ## Webhook Integration
208
+
209
+ ### Setup Webhook Handler
210
+ ```javascript
211
+ // webhook-handler.js
212
+ const { createServer } = require('http');
213
+ const { execSync } = require('child_process');
214
+
215
+ createServer((req, res) => {
216
+ if (req.url === '/github-webhook') {
217
+ const event = JSON.parse(body);
218
+
219
+ if (event.action === 'opened' && event.pull_request) {
220
+ execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
221
+ }
222
+
223
+ res.writeHead(200);
224
+ res.end('OK');
225
+ }
226
+ }).listen(3000);
227
+ ```
228
+
229
+ ## Examples
230
+
231
+ ### Feature Development PR
232
+ ```bash
233
+ # PR #456: Add user authentication
234
+ npx ruv-swarm github pr-init 456 \
235
+ --topology hierarchical \
236
+ --agents "architect,coder,tester,security" \
237
+ --auto-assign-tasks
238
+ ```
239
+
240
+ ### Bug Fix PR
241
+ ```bash
242
+ # PR #789: Fix memory leak
243
+ npx ruv-swarm github pr-init 789 \
244
+ --topology mesh \
245
+ --agents "debugger,analyst,tester" \
246
+ --priority high
247
+ ```
248
+
249
+ ### Documentation PR
250
+ ```bash
251
+ # PR #321: Update API docs
252
+ npx ruv-swarm github pr-init 321 \
253
+ --topology ring \
254
+ --agents "researcher,writer,reviewer" \
255
+ --validate-links
256
+ ```
257
+
258
+ ## Metrics & Reporting
259
+
260
+ ### PR Swarm Analytics
261
+ ```bash
262
+ # Generate PR swarm report
263
+ npx ruv-swarm github pr-report 123 \
264
+ --metrics "completion-time,agent-efficiency,token-usage" \
265
+ --format markdown
266
+ ```
267
+
268
+ ### Dashboard Integration
269
+ ```bash
270
+ # Export to GitHub Insights
271
+ npx ruv-swarm github export-metrics \
272
+ --pr 123 \
273
+ --to-insights
274
+ ```
275
+
276
+ ## Security Considerations
277
+
278
+ 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
279
+ 2. **Command Validation**: Validate all PR comments before execution
280
+ 3. **Rate Limiting**: Implement rate limits for PR operations
281
+ 4. **Audit Trail**: Log all swarm operations for compliance
282
+
283
+ ## Integration with Claude Code
284
+
285
+ When using with Claude Code:
286
+ 1. Claude Code reads PR diff and context
287
+ 2. Swarm coordinates approach based on PR type
288
+ 3. Agents work in parallel on different aspects
289
+ 4. Progress updates posted to PR automatically
290
+ 5. Final review performed before marking ready
291
+
292
+ ## Advanced Swarm PR Coordination
293
+
294
+ ### Multi-Agent PR Analysis
295
+ ```bash
296
+ # Initialize PR-specific swarm with intelligent topology selection
297
+ mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
298
+ mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
299
+ mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
300
+ mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
301
+ mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
302
+ mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
303
+
304
+ # Store PR context for swarm coordination
305
+ mcp__claude-flow__memory_usage {
306
+ action: "store",
307
+ key: "pr/#{pr_number}/analysis",
308
+ value: {
309
+ diff: "pr_diff_content",
310
+ files_changed: ["file1.js", "file2.py"],
311
+ complexity_score: 8.5,
312
+ risk_assessment: "medium"
313
+ }
314
+ }
315
+
316
+ # Orchestrate comprehensive PR workflow
317
+ mcp__claude-flow__task_orchestrate {
318
+ task: "Execute multi-agent PR review and validation workflow",
319
+ strategy: "parallel",
320
+ priority: "high",
321
+ dependencies: ["diff_analysis", "test_validation", "security_review"]
322
+ }
323
+ ```
324
+
325
+ ### Swarm-Coordinated PR Lifecycle
326
+ ```javascript
327
+ // Pre-hook: PR Initialization and Swarm Setup
328
+ const prPreHook = async (prData) => {
329
+ // Analyze PR complexity for optimal swarm configuration
330
+ const complexity = await analyzePRComplexity(prData);
331
+ const topology = complexity > 7 ? "hierarchical" : "mesh";
332
+
333
+ // Initialize swarm with PR-specific configuration
334
+ await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
335
+
336
+ // Store comprehensive PR context
337
+ await mcp__claude_flow__memory_usage({
338
+ action: "store",
339
+ key: `pr/${prData.number}/context`,
340
+ value: {
341
+ pr: prData,
342
+ complexity,
343
+ agents_assigned: await getOptimalAgents(prData),
344
+ timeline: generateTimeline(prData)
345
+ }
346
+ });
347
+
348
+ // Coordinate initial agent synchronization
349
+ await mcp__claude_flow__coordination_sync({ swarmId: "current" });
350
+ };
351
+
352
+ // Post-hook: PR Completion and Metrics
353
+ const prPostHook = async (results) => {
354
+ // Generate comprehensive PR completion report
355
+ const report = await generatePRReport(results);
356
+
357
+ // Update PR with final swarm analysis
358
+ await updatePRWithResults(report);
359
+
360
+ // Store completion metrics for future optimization
361
+ await mcp__claude_flow__memory_usage({
362
+ action: "store",
363
+ key: `pr/${results.number}/completion`,
364
+ value: {
365
+ completion_time: results.duration,
366
+ agent_efficiency: results.agentMetrics,
367
+ quality_score: results.qualityAssessment,
368
+ lessons_learned: results.insights
369
+ }
370
+ });
371
+ };
372
+ ```
373
+
374
+ ### Intelligent PR Merge Coordination
375
+ ```bash
376
+ # Coordinate merge decision with swarm consensus
377
+ mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
378
+
379
+ # Analyze merge readiness with multiple agents
380
+ mcp__claude-flow__task_orchestrate {
381
+ task: "Evaluate PR merge readiness with comprehensive validation",
382
+ strategy: "sequential",
383
+ priority: "critical"
384
+ }
385
+
386
+ # Store merge decision context
387
+ mcp__claude-flow__memory_usage {
388
+ action: "store",
389
+ key: "pr/merge_decisions/#{pr_number}",
390
+ value: {
391
+ ready_to_merge: true,
392
+ validation_passed: true,
393
+ agent_consensus: "approved",
394
+ final_review_score: 9.2
395
+ }
396
+ }
397
+ ```
398
+
399
399
  See also: [swarm-issue.md](./swarm-issue.md), [sync-coordinator.md](./sync-coordinator.md), [workflow-automation.md](./workflow-automation.md)