claude-flow 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 (455) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  3. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  4. package/.claude/agents/analysis/code-analyzer.md +188 -188
  5. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  7. package/.claude/agents/base-template-generator.md +41 -41
  8. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  9. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  10. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  11. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  12. package/.claude/agents/consensus/quorum-manager.md +802 -802
  13. package/.claude/agents/consensus/raft-manager.md +42 -42
  14. package/.claude/agents/consensus/security-manager.md +601 -601
  15. package/.claude/agents/core/coder.md +254 -254
  16. package/.claude/agents/core/planner.md +151 -151
  17. package/.claude/agents/core/researcher.md +173 -173
  18. package/.claude/agents/core/reviewer.md +308 -308
  19. package/.claude/agents/core/tester.md +299 -299
  20. package/.claude/agents/custom/test-long-runner.md +43 -43
  21. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  22. package/.claude/agents/database-specialist.md +9 -9
  23. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  24. package/.claude/agents/development/dev-backend-api.md +177 -177
  25. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  27. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  28. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  29. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  30. package/.claude/agents/flow-nexus/app-store.md +87 -87
  31. package/.claude/agents/flow-nexus/authentication.md +68 -68
  32. package/.claude/agents/flow-nexus/challenges.md +80 -80
  33. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  34. package/.claude/agents/flow-nexus/payments.md +82 -82
  35. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  36. package/.claude/agents/flow-nexus/swarm.md +75 -75
  37. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  38. package/.claude/agents/flow-nexus/workflow.md +83 -83
  39. package/.claude/agents/github/code-review-swarm.md +520 -520
  40. package/.claude/agents/github/github-modes.md +153 -153
  41. package/.claude/agents/github/issue-tracker.md +298 -298
  42. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  43. package/.claude/agents/github/pr-manager.md +162 -162
  44. package/.claude/agents/github/project-board-sync.md +477 -477
  45. package/.claude/agents/github/release-manager.md +337 -337
  46. package/.claude/agents/github/release-swarm.md +550 -550
  47. package/.claude/agents/github/repo-architect.md +364 -364
  48. package/.claude/agents/github/swarm-issue.md +550 -550
  49. package/.claude/agents/github/swarm-pr.md +401 -401
  50. package/.claude/agents/github/sync-coordinator.md +424 -424
  51. package/.claude/agents/github/workflow-automation.md +604 -604
  52. package/.claude/agents/goal/agent.md +816 -816
  53. package/.claude/agents/goal/code-goal-planner.md +444 -444
  54. package/.claude/agents/goal/goal-planner.md +167 -167
  55. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  56. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  57. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  58. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  59. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  60. package/.claude/agents/neural/safla-neural.md +73 -73
  61. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  62. package/.claude/agents/optimization/load-balancer.md +428 -428
  63. package/.claude/agents/optimization/performance-monitor.md +669 -669
  64. package/.claude/agents/optimization/resource-allocator.md +671 -671
  65. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  66. package/.claude/agents/payments/agentic-payments.md +126 -126
  67. package/.claude/agents/project-coordinator.md +8 -8
  68. package/.claude/agents/python-specialist.md +9 -9
  69. package/.claude/agents/reasoning/agent.md +816 -816
  70. package/.claude/agents/reasoning/goal-planner.md +72 -72
  71. package/.claude/agents/security-auditor.md +9 -9
  72. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  73. package/.claude/agents/sparc/architecture.md +452 -452
  74. package/.claude/agents/sparc/pseudocode.md +298 -298
  75. package/.claude/agents/sparc/refinement.md +503 -503
  76. package/.claude/agents/sparc/specification.md +257 -257
  77. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  78. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  79. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  80. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  81. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  82. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  83. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  84. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  85. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  86. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  87. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  88. package/.claude/agents/templates/github-pr-manager.md +154 -154
  89. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  90. package/.claude/agents/templates/memory-coordinator.md +162 -162
  91. package/.claude/agents/templates/migration-plan.md +723 -723
  92. package/.claude/agents/templates/orchestrator-task.md +119 -119
  93. package/.claude/agents/templates/performance-analyzer.md +178 -178
  94. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  95. package/.claude/agents/testing/production-validator.md +372 -372
  96. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  98. package/.claude/agents/testing/validation/production-validator.md +372 -372
  99. package/.claude/agents/typescript-specialist.md +9 -9
  100. package/.claude/agents/v3/database-specialist.md +9 -9
  101. package/.claude/agents/v3/project-coordinator.md +8 -8
  102. package/.claude/agents/v3/python-specialist.md +9 -9
  103. package/.claude/agents/v3/test-architect.md +9 -9
  104. package/.claude/agents/v3/typescript-specialist.md +9 -9
  105. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  106. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  107. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  108. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  109. package/.claude/agents/v3/v3-security-architect.md +139 -139
  110. package/.claude/checkpoints/1767754460.json +8 -8
  111. package/.claude/commands/agents/README.md +10 -10
  112. package/.claude/commands/agents/agent-capabilities.md +21 -21
  113. package/.claude/commands/agents/agent-coordination.md +28 -28
  114. package/.claude/commands/agents/agent-spawning.md +28 -28
  115. package/.claude/commands/agents/agent-types.md +26 -26
  116. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  117. package/.claude/commands/analysis/README.md +9 -9
  118. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  119. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  120. package/.claude/commands/analysis/performance-report.md +25 -25
  121. package/.claude/commands/analysis/token-efficiency.md +44 -44
  122. package/.claude/commands/analysis/token-usage.md +25 -25
  123. package/.claude/commands/automation/README.md +9 -9
  124. package/.claude/commands/automation/auto-agent.md +122 -122
  125. package/.claude/commands/automation/self-healing.md +105 -105
  126. package/.claude/commands/automation/session-memory.md +89 -89
  127. package/.claude/commands/automation/smart-agents.md +72 -72
  128. package/.claude/commands/automation/smart-spawn.md +25 -25
  129. package/.claude/commands/automation/workflow-select.md +25 -25
  130. package/.claude/commands/claude-flow-help.md +103 -103
  131. package/.claude/commands/claude-flow-memory.md +107 -107
  132. package/.claude/commands/claude-flow-swarm.md +205 -205
  133. package/.claude/commands/coordination/README.md +9 -9
  134. package/.claude/commands/coordination/agent-spawn.md +25 -25
  135. package/.claude/commands/coordination/init.md +44 -44
  136. package/.claude/commands/coordination/orchestrate.md +43 -43
  137. package/.claude/commands/coordination/spawn.md +45 -45
  138. package/.claude/commands/coordination/swarm-init.md +85 -85
  139. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  140. package/.claude/commands/flow-nexus/app-store.md +123 -123
  141. package/.claude/commands/flow-nexus/challenges.md +119 -119
  142. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  143. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  144. package/.claude/commands/flow-nexus/payments.md +115 -115
  145. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  146. package/.claude/commands/flow-nexus/swarm.md +86 -86
  147. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  148. package/.claude/commands/flow-nexus/workflow.md +114 -114
  149. package/.claude/commands/github/README.md +11 -11
  150. package/.claude/commands/github/code-review-swarm.md +513 -513
  151. package/.claude/commands/github/code-review.md +25 -25
  152. package/.claude/commands/github/github-modes.md +146 -146
  153. package/.claude/commands/github/github-swarm.md +121 -121
  154. package/.claude/commands/github/issue-tracker.md +291 -291
  155. package/.claude/commands/github/issue-triage.md +25 -25
  156. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  157. package/.claude/commands/github/pr-enhance.md +26 -26
  158. package/.claude/commands/github/pr-manager.md +169 -169
  159. package/.claude/commands/github/project-board-sync.md +470 -470
  160. package/.claude/commands/github/release-manager.md +337 -337
  161. package/.claude/commands/github/release-swarm.md +543 -543
  162. package/.claude/commands/github/repo-analyze.md +25 -25
  163. package/.claude/commands/github/repo-architect.md +366 -366
  164. package/.claude/commands/github/swarm-issue.md +481 -481
  165. package/.claude/commands/github/swarm-pr.md +284 -284
  166. package/.claude/commands/github/sync-coordinator.md +300 -300
  167. package/.claude/commands/github/workflow-automation.md +441 -441
  168. package/.claude/commands/hive-mind/README.md +17 -17
  169. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  171. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  176. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  179. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  180. package/.claude/commands/hooks/README.md +11 -11
  181. package/.claude/commands/hooks/overview.md +57 -57
  182. package/.claude/commands/hooks/post-edit.md +117 -117
  183. package/.claude/commands/hooks/post-task.md +112 -112
  184. package/.claude/commands/hooks/pre-edit.md +113 -113
  185. package/.claude/commands/hooks/pre-task.md +111 -111
  186. package/.claude/commands/hooks/session-end.md +118 -118
  187. package/.claude/commands/hooks/setup.md +102 -102
  188. package/.claude/commands/memory/README.md +9 -9
  189. package/.claude/commands/memory/memory-persist.md +25 -25
  190. package/.claude/commands/memory/memory-search.md +25 -25
  191. package/.claude/commands/memory/memory-usage.md +25 -25
  192. package/.claude/commands/memory/neural.md +47 -47
  193. package/.claude/commands/monitoring/README.md +9 -9
  194. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  195. package/.claude/commands/monitoring/agents.md +44 -44
  196. package/.claude/commands/monitoring/real-time-view.md +25 -25
  197. package/.claude/commands/monitoring/status.md +46 -46
  198. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  199. package/.claude/commands/optimization/README.md +9 -9
  200. package/.claude/commands/optimization/auto-topology.md +61 -61
  201. package/.claude/commands/optimization/cache-manage.md +25 -25
  202. package/.claude/commands/optimization/parallel-execute.md +25 -25
  203. package/.claude/commands/optimization/parallel-execution.md +49 -49
  204. package/.claude/commands/optimization/topology-optimize.md +25 -25
  205. package/.claude/commands/pair/README.md +260 -260
  206. package/.claude/commands/pair/commands.md +545 -545
  207. package/.claude/commands/pair/config.md +509 -509
  208. package/.claude/commands/pair/examples.md +511 -511
  209. package/.claude/commands/pair/modes.md +347 -347
  210. package/.claude/commands/pair/session.md +406 -406
  211. package/.claude/commands/pair/start.md +208 -208
  212. package/.claude/commands/sparc/analyzer.md +51 -51
  213. package/.claude/commands/sparc/architect.md +53 -53
  214. package/.claude/commands/sparc/ask.md +97 -97
  215. package/.claude/commands/sparc/batch-executor.md +54 -54
  216. package/.claude/commands/sparc/code.md +89 -89
  217. package/.claude/commands/sparc/coder.md +54 -54
  218. package/.claude/commands/sparc/debug.md +83 -83
  219. package/.claude/commands/sparc/debugger.md +54 -54
  220. package/.claude/commands/sparc/designer.md +53 -53
  221. package/.claude/commands/sparc/devops.md +109 -109
  222. package/.claude/commands/sparc/docs-writer.md +80 -80
  223. package/.claude/commands/sparc/documenter.md +54 -54
  224. package/.claude/commands/sparc/innovator.md +54 -54
  225. package/.claude/commands/sparc/integration.md +83 -83
  226. package/.claude/commands/sparc/mcp.md +117 -117
  227. package/.claude/commands/sparc/memory-manager.md +54 -54
  228. package/.claude/commands/sparc/optimizer.md +54 -54
  229. package/.claude/commands/sparc/orchestrator.md +131 -131
  230. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  231. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  232. package/.claude/commands/sparc/researcher.md +54 -54
  233. package/.claude/commands/sparc/reviewer.md +54 -54
  234. package/.claude/commands/sparc/security-review.md +80 -80
  235. package/.claude/commands/sparc/sparc-modes.md +174 -174
  236. package/.claude/commands/sparc/sparc.md +111 -111
  237. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  238. package/.claude/commands/sparc/supabase-admin.md +348 -348
  239. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  240. package/.claude/commands/sparc/tdd.md +54 -54
  241. package/.claude/commands/sparc/tester.md +54 -54
  242. package/.claude/commands/sparc/tutorial.md +79 -79
  243. package/.claude/commands/sparc/workflow-manager.md +54 -54
  244. package/.claude/commands/sparc.md +166 -166
  245. package/.claude/commands/stream-chain/pipeline.md +120 -120
  246. package/.claude/commands/stream-chain/run.md +69 -69
  247. package/.claude/commands/swarm/README.md +15 -15
  248. package/.claude/commands/swarm/analysis.md +95 -95
  249. package/.claude/commands/swarm/development.md +96 -96
  250. package/.claude/commands/swarm/examples.md +168 -168
  251. package/.claude/commands/swarm/maintenance.md +102 -102
  252. package/.claude/commands/swarm/optimization.md +117 -117
  253. package/.claude/commands/swarm/research.md +136 -136
  254. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  255. package/.claude/commands/swarm/swarm-background.md +8 -8
  256. package/.claude/commands/swarm/swarm-init.md +19 -19
  257. package/.claude/commands/swarm/swarm-modes.md +8 -8
  258. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  259. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  260. package/.claude/commands/swarm/swarm-status.md +8 -8
  261. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  262. package/.claude/commands/swarm/swarm.md +27 -27
  263. package/.claude/commands/swarm/testing.md +131 -131
  264. package/.claude/commands/training/README.md +9 -9
  265. package/.claude/commands/training/model-update.md +25 -25
  266. package/.claude/commands/training/neural-patterns.md +73 -73
  267. package/.claude/commands/training/neural-train.md +25 -25
  268. package/.claude/commands/training/pattern-learn.md +25 -25
  269. package/.claude/commands/training/specialization.md +62 -62
  270. package/.claude/commands/truth/start.md +142 -142
  271. package/.claude/commands/verify/check.md +49 -49
  272. package/.claude/commands/verify/start.md +127 -127
  273. package/.claude/commands/workflows/README.md +9 -9
  274. package/.claude/commands/workflows/development.md +77 -77
  275. package/.claude/commands/workflows/research.md +62 -62
  276. package/.claude/commands/workflows/workflow-create.md +25 -25
  277. package/.claude/commands/workflows/workflow-execute.md +25 -25
  278. package/.claude/commands/workflows/workflow-export.md +25 -25
  279. package/.claude/config/v3-dependency-optimization.json +265 -265
  280. package/.claude/config/v3-performance-targets.json +250 -250
  281. package/.claude/helpers/.LOCKED +2 -2
  282. package/.claude/helpers/.helpers-version +1 -0
  283. package/.claude/helpers/README.md +96 -96
  284. package/.claude/helpers/adr-compliance.sh +186 -186
  285. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  286. package/.claude/helpers/auto-commit.sh +178 -178
  287. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  288. package/.claude/helpers/checkpoint-manager.sh +251 -251
  289. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  290. package/.claude/helpers/daemon-manager.sh +252 -252
  291. package/.claude/helpers/ddd-tracker.sh +144 -144
  292. package/.claude/helpers/github-safe.js +156 -156
  293. package/.claude/helpers/github-setup.sh +45 -45
  294. package/.claude/helpers/guidance-hook.sh +13 -13
  295. package/.claude/helpers/guidance-hooks.sh +102 -102
  296. package/.claude/helpers/health-monitor.sh +108 -108
  297. package/.claude/helpers/helpers.manifest.json +13 -0
  298. package/.claude/helpers/hook-handler.cjs +464 -464
  299. package/.claude/helpers/intelligence.cjs +1058 -1058
  300. package/.claude/helpers/learning-hooks.sh +329 -329
  301. package/.claude/helpers/learning-optimizer.sh +127 -127
  302. package/.claude/helpers/learning-service.mjs +1144 -1144
  303. package/.claude/helpers/memory.cjs +84 -84
  304. package/.claude/helpers/metrics-db.mjs +503 -503
  305. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  306. package/.claude/helpers/pattern-consolidator.sh +86 -86
  307. package/.claude/helpers/perf-worker.sh +160 -160
  308. package/.claude/helpers/quick-start.sh +19 -19
  309. package/.claude/helpers/router.cjs +62 -62
  310. package/.claude/helpers/security-scanner.sh +127 -127
  311. package/.claude/helpers/session.cjs +125 -125
  312. package/.claude/helpers/setup-mcp.sh +18 -18
  313. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  314. package/.claude/helpers/statusline.cjs +211 -2
  315. package/.claude/helpers/swarm-comms.sh +353 -353
  316. package/.claude/helpers/swarm-hooks.sh +761 -761
  317. package/.claude/helpers/swarm-monitor.sh +210 -210
  318. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  319. package/.claude/helpers/update-v3-progress.sh +165 -165
  320. package/.claude/helpers/v3-quick-status.sh +57 -57
  321. package/.claude/helpers/v3.sh +110 -110
  322. package/.claude/helpers/validate-v3-config.sh +215 -215
  323. package/.claude/helpers/worker-manager.sh +170 -170
  324. package/.claude/mcp.json +12 -12
  325. package/.claude/proven-config.json +42 -0
  326. package/.claude/settings.json +284 -284
  327. package/.claude/settings.json.bak +526 -526
  328. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  329. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  330. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  331. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  332. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  333. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  334. package/.claude/skills/browser/SKILL.md +204 -204
  335. package/.claude/skills/dual-mode/README.md +71 -71
  336. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  337. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  338. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  339. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  340. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  341. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  342. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  343. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  344. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  345. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  346. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  347. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  348. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  349. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  350. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  351. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  352. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  353. package/.claude/skills/skill-builder/SKILL.md +910 -910
  354. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  355. package/.claude/skills/stream-chain/SKILL.md +560 -560
  356. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  357. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  358. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  359. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  360. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  361. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  362. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  363. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  364. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  365. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  366. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  367. package/.claude/skills/verification-quality/SKILL.md +691 -691
  368. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  369. package/.claude/skills/worker-integration/SKILL.md +147 -147
  370. package/.claude/statusline-command.sh +176 -176
  371. package/.claude/statusline.mjs +109 -109
  372. package/.claude/statusline.sh +431 -431
  373. package/.claude/workflows/full-system-test.js +65 -65
  374. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  375. package/.claude/workflows/plugin-contract-audit.js +91 -91
  376. package/.claude-plugin/README.md +720 -720
  377. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  378. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  379. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  380. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  381. package/.claude-plugin/hooks/hooks.json +79 -77
  382. package/.claude-plugin/marketplace.json +185 -185
  383. package/.claude-plugin/plugin.json +71 -71
  384. package/.claude-plugin/scripts/install.sh +234 -234
  385. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  386. package/.claude-plugin/scripts/ruflo-hook.sh +52 -52
  387. package/.claude-plugin/scripts/uninstall.sh +36 -36
  388. package/.claude-plugin/scripts/verify.sh +108 -108
  389. package/LICENSE +21 -21
  390. package/README.md +419 -419
  391. package/bin/cli.js +11 -11
  392. package/bin/npx-repair.js +7 -7
  393. package/bin/npx-safe-launch.js +9 -9
  394. package/package.json +192 -186
  395. package/v3/@claude-flow/cli/README.md +419 -419
  396. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  397. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  398. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  399. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  400. package/v3/@claude-flow/cli/dist/src/autopilot-state.js +24 -7
  401. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  402. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  403. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  404. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  405. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +267 -20
  406. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  407. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  408. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +74 -11
  409. package/v3/@claude-flow/cli/dist/src/commands/init.js +202 -34
  410. package/v3/@claude-flow/cli/dist/src/commands/memory.js +12 -1
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  418. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  419. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  420. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +13 -2
  421. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +11 -4
  422. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +11 -4
  423. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +12 -10
  424. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +83 -11
  425. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  426. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  427. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +2 -2
  428. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  429. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +24 -24
  430. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  431. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  432. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +8 -0
  433. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +21 -0
  434. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +4 -3
  435. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.d.ts +9 -0
  436. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +35 -22
  437. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +189 -93
  438. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +479 -407
  439. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  440. package/v3/@claude-flow/cli/dist/src/parser.js +25 -9
  441. package/v3/@claude-flow/cli/dist/src/proxy/verify.js +2 -2
  442. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  443. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  446. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +7 -4
  447. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  448. package/v3/@claude-flow/cli/package.json +137 -135
  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/dist/events/event-store.js +31 -31
  453. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  454. package/v3/@claude-flow/shared/package.json +43 -43
  455. package/v3/README.md +493 -493
@@ -1,402 +1,402 @@
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@v4
55
- - name: Handle Swarm Command
56
- run: |
57
- COMMENT_BODY_FILE=$(mktemp)
58
- printf '%s' "${{ github.event.comment.body }}" > "$COMMENT_BODY_FILE"
59
- if grep -q '^/swarm' "$COMMENT_BODY_FILE"; then
60
- npx ruv-swarm github handle-comment \
61
- --pr ${{ github.event.pull_request.number }} \
62
- --comment-file "$COMMENT_BODY_FILE"
63
- fi
64
- rm -f "$COMMENT_BODY_FILE"
65
- ```
66
-
67
- ## PR Label Integration
68
-
69
- ### Automatic Agent Assignment
70
- Map PR labels to agent types:
71
-
72
- ```json
73
- {
74
- "label-mapping": {
75
- "bug": ["debugger", "tester"],
76
- "feature": ["architect", "coder", "tester"],
77
- "refactor": ["analyst", "coder"],
78
- "docs": ["researcher", "writer"],
79
- "performance": ["analyst", "optimizer"]
80
- }
81
- }
82
- ```
83
-
84
- ### Label-Based Topology
85
- ```bash
86
- # Small PR (< 100 lines): ring topology
87
- # Medium PR (100-500 lines): mesh topology
88
- # Large PR (> 500 lines): hierarchical topology
89
- npx ruv-swarm github pr-topology --pr 123
90
- ```
91
-
92
- ## PR Swarm Commands
93
-
94
- ### Initialize from PR
95
- ```bash
96
- # Create swarm with PR context using gh CLI
97
- PR_DIFF=$(gh pr diff 123)
98
- PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
99
-
100
- npx ruv-swarm github pr-init 123 \
101
- --auto-agents \
102
- --pr-data "$PR_INFO" \
103
- --diff "$PR_DIFF" \
104
- --analyze-impact
105
- ```
106
-
107
- ### Progress Updates
108
- ```bash
109
- # Post swarm progress to PR using gh CLI
110
- PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
111
-
112
- gh pr comment 123 --body "$PROGRESS"
113
-
114
- # Update PR labels based on progress
115
- if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
116
- gh pr edit 123 --add-label "ready-for-review"
117
- fi
118
- ```
119
-
120
- ### Code Review Integration
121
- ```bash
122
- # Create review agents with gh CLI integration
123
- PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
124
-
125
- # Run swarm review
126
- REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
127
- --agents "security,performance,style" \
128
- --files "$PR_FILES")
129
-
130
- # Post review comments using gh CLI
131
- echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
132
- FILE=$(echo "$comment" | jq -r '.file')
133
- LINE=$(echo "$comment" | jq -r '.line')
134
- BODY=$(echo "$comment" | jq -r '.body')
135
-
136
- gh pr review 123 --comment --body "$BODY"
137
- done
138
- ```
139
-
140
- ## Advanced Features
141
-
142
- ### 1. Multi-PR Swarm Coordination
143
- ```bash
144
- # Coordinate swarms across related PRs
145
- npx ruv-swarm github multi-pr \
146
- --prs "123,124,125" \
147
- --strategy "parallel" \
148
- --share-memory
149
- ```
150
-
151
- ### 2. PR Dependency Analysis
152
- ```bash
153
- # Analyze PR dependencies
154
- npx ruv-swarm github pr-deps 123 \
155
- --spawn-agents \
156
- --resolve-conflicts
157
- ```
158
-
159
- ### 3. Automated PR Fixes
160
- ```bash
161
- # Auto-fix PR issues
162
- npx ruv-swarm github pr-fix 123 \
163
- --issues "lint,test-failures" \
164
- --commit-fixes
165
- ```
166
-
167
- ## Best Practices
168
-
169
- ### 1. PR Templates
170
- ```markdown
171
- <!-- .github/pull_request_template.md -->
172
- ## Swarm Configuration
173
- - Topology: [mesh/hierarchical/ring/star]
174
- - Max Agents: [number]
175
- - Auto-spawn: [yes/no]
176
- - Priority: [high/medium/low]
177
-
178
- ## Tasks for Swarm
179
- - [ ] Task 1 description
180
- - [ ] Task 2 description
181
- ```
182
-
183
- ### 2. Status Checks
184
- ```yaml
185
- # Require swarm completion before merge
186
- required_status_checks:
187
- contexts:
188
- - "swarm/tasks-complete"
189
- - "swarm/tests-pass"
190
- - "swarm/review-approved"
191
- ```
192
-
193
- ### 3. PR Merge Automation
194
- ```bash
195
- # Auto-merge when swarm completes using gh CLI
196
- # Check swarm completion status
197
- SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
198
-
199
- if [[ "$SWARM_STATUS" == "complete" ]]; then
200
- # Check review requirements
201
- REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
202
-
203
- if [[ $REVIEWS -ge 2 ]]; then
204
- # Enable auto-merge
205
- gh pr merge 123 --auto --squash
206
- fi
207
- fi
208
- ```
209
-
210
- ## Webhook Integration
211
-
212
- ### Setup Webhook Handler
213
- ```javascript
214
- // webhook-handler.js
215
- const { createServer } = require('http');
216
- const { execSync } = require('child_process');
217
-
218
- createServer((req, res) => {
219
- if (req.url === '/github-webhook') {
220
- const event = JSON.parse(body);
221
-
222
- if (event.action === 'opened' && event.pull_request) {
223
- execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
224
- }
225
-
226
- res.writeHead(200);
227
- res.end('OK');
228
- }
229
- }).listen(3000);
230
- ```
231
-
232
- ## Examples
233
-
234
- ### Feature Development PR
235
- ```bash
236
- # PR #456: Add user authentication
237
- npx ruv-swarm github pr-init 456 \
238
- --topology hierarchical \
239
- --agents "architect,coder,tester,security" \
240
- --auto-assign-tasks
241
- ```
242
-
243
- ### Bug Fix PR
244
- ```bash
245
- # PR #789: Fix memory leak
246
- npx ruv-swarm github pr-init 789 \
247
- --topology mesh \
248
- --agents "debugger,analyst,tester" \
249
- --priority high
250
- ```
251
-
252
- ### Documentation PR
253
- ```bash
254
- # PR #321: Update API docs
255
- npx ruv-swarm github pr-init 321 \
256
- --topology ring \
257
- --agents "researcher,writer,reviewer" \
258
- --validate-links
259
- ```
260
-
261
- ## Metrics & Reporting
262
-
263
- ### PR Swarm Analytics
264
- ```bash
265
- # Generate PR swarm report
266
- npx ruv-swarm github pr-report 123 \
267
- --metrics "completion-time,agent-efficiency,token-usage" \
268
- --format markdown
269
- ```
270
-
271
- ### Dashboard Integration
272
- ```bash
273
- # Export to GitHub Insights
274
- npx ruv-swarm github export-metrics \
275
- --pr 123 \
276
- --to-insights
277
- ```
278
-
279
- ## Security Considerations
280
-
281
- 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
282
- 2. **Command Validation**: Validate all PR comments before execution
283
- 3. **Rate Limiting**: Implement rate limits for PR operations
284
- 4. **Audit Trail**: Log all swarm operations for compliance
285
-
286
- ## Integration with Claude Code
287
-
288
- When using with Claude Code:
289
- 1. Claude Code reads PR diff and context
290
- 2. Swarm coordinates approach based on PR type
291
- 3. Agents work in parallel on different aspects
292
- 4. Progress updates posted to PR automatically
293
- 5. Final review performed before marking ready
294
-
295
- ## Advanced Swarm PR Coordination
296
-
297
- ### Multi-Agent PR Analysis
298
- ```bash
299
- # Initialize PR-specific swarm with intelligent topology selection
300
- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
301
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
302
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
303
- mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
304
- mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
305
- mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
306
-
307
- # Store PR context for swarm coordination
308
- mcp__claude-flow__memory_usage {
309
- action: "store",
310
- key: "pr/#{pr_number}/analysis",
311
- value: {
312
- diff: "pr_diff_content",
313
- files_changed: ["file1.js", "file2.py"],
314
- complexity_score: 8.5,
315
- risk_assessment: "medium"
316
- }
317
- }
318
-
319
- # Orchestrate comprehensive PR workflow
320
- mcp__claude-flow__task_orchestrate {
321
- task: "Execute multi-agent PR review and validation workflow",
322
- strategy: "parallel",
323
- priority: "high",
324
- dependencies: ["diff_analysis", "test_validation", "security_review"]
325
- }
326
- ```
327
-
328
- ### Swarm-Coordinated PR Lifecycle
329
- ```javascript
330
- // Pre-hook: PR Initialization and Swarm Setup
331
- const prPreHook = async (prData) => {
332
- // Analyze PR complexity for optimal swarm configuration
333
- const complexity = await analyzePRComplexity(prData);
334
- const topology = complexity > 7 ? "hierarchical" : "mesh";
335
-
336
- // Initialize swarm with PR-specific configuration
337
- await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
338
-
339
- // Store comprehensive PR context
340
- await mcp__claude_flow__memory_usage({
341
- action: "store",
342
- key: `pr/${prData.number}/context`,
343
- value: {
344
- pr: prData,
345
- complexity,
346
- agents_assigned: await getOptimalAgents(prData),
347
- timeline: generateTimeline(prData)
348
- }
349
- });
350
-
351
- // Coordinate initial agent synchronization
352
- await mcp__claude_flow__coordination_sync({ swarmId: "current" });
353
- };
354
-
355
- // Post-hook: PR Completion and Metrics
356
- const prPostHook = async (results) => {
357
- // Generate comprehensive PR completion report
358
- const report = await generatePRReport(results);
359
-
360
- // Update PR with final swarm analysis
361
- await updatePRWithResults(report);
362
-
363
- // Store completion metrics for future optimization
364
- await mcp__claude_flow__memory_usage({
365
- action: "store",
366
- key: `pr/${results.number}/completion`,
367
- value: {
368
- completion_time: results.duration,
369
- agent_efficiency: results.agentMetrics,
370
- quality_score: results.qualityAssessment,
371
- lessons_learned: results.insights
372
- }
373
- });
374
- };
375
- ```
376
-
377
- ### Intelligent PR Merge Coordination
378
- ```bash
379
- # Coordinate merge decision with swarm consensus
380
- mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
381
-
382
- # Analyze merge readiness with multiple agents
383
- mcp__claude-flow__task_orchestrate {
384
- task: "Evaluate PR merge readiness with comprehensive validation",
385
- strategy: "sequential",
386
- priority: "critical"
387
- }
388
-
389
- # Store merge decision context
390
- mcp__claude-flow__memory_usage {
391
- action: "store",
392
- key: "pr/merge_decisions/#{pr_number}",
393
- value: {
394
- ready_to_merge: true,
395
- validation_passed: true,
396
- agent_consensus: "approved",
397
- final_review_score: 9.2
398
- }
399
- }
400
- ```
401
-
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@v4
55
+ - name: Handle Swarm Command
56
+ run: |
57
+ COMMENT_BODY_FILE=$(mktemp)
58
+ printf '%s' "${{ github.event.comment.body }}" > "$COMMENT_BODY_FILE"
59
+ if grep -q '^/swarm' "$COMMENT_BODY_FILE"; then
60
+ npx ruv-swarm github handle-comment \
61
+ --pr ${{ github.event.pull_request.number }} \
62
+ --comment-file "$COMMENT_BODY_FILE"
63
+ fi
64
+ rm -f "$COMMENT_BODY_FILE"
65
+ ```
66
+
67
+ ## PR Label Integration
68
+
69
+ ### Automatic Agent Assignment
70
+ Map PR labels to agent types:
71
+
72
+ ```json
73
+ {
74
+ "label-mapping": {
75
+ "bug": ["debugger", "tester"],
76
+ "feature": ["architect", "coder", "tester"],
77
+ "refactor": ["analyst", "coder"],
78
+ "docs": ["researcher", "writer"],
79
+ "performance": ["analyst", "optimizer"]
80
+ }
81
+ }
82
+ ```
83
+
84
+ ### Label-Based Topology
85
+ ```bash
86
+ # Small PR (< 100 lines): ring topology
87
+ # Medium PR (100-500 lines): mesh topology
88
+ # Large PR (> 500 lines): hierarchical topology
89
+ npx ruv-swarm github pr-topology --pr 123
90
+ ```
91
+
92
+ ## PR Swarm Commands
93
+
94
+ ### Initialize from PR
95
+ ```bash
96
+ # Create swarm with PR context using gh CLI
97
+ PR_DIFF=$(gh pr diff 123)
98
+ PR_INFO=$(gh pr view 123 --json title,body,labels,files,reviews)
99
+
100
+ npx ruv-swarm github pr-init 123 \
101
+ --auto-agents \
102
+ --pr-data "$PR_INFO" \
103
+ --diff "$PR_DIFF" \
104
+ --analyze-impact
105
+ ```
106
+
107
+ ### Progress Updates
108
+ ```bash
109
+ # Post swarm progress to PR using gh CLI
110
+ PROGRESS=$(npx ruv-swarm github pr-progress 123 --format markdown)
111
+
112
+ gh pr comment 123 --body "$PROGRESS"
113
+
114
+ # Update PR labels based on progress
115
+ if [[ $(echo "$PROGRESS" | grep -o '[0-9]\+%' | sed 's/%//') -gt 90 ]]; then
116
+ gh pr edit 123 --add-label "ready-for-review"
117
+ fi
118
+ ```
119
+
120
+ ### Code Review Integration
121
+ ```bash
122
+ # Create review agents with gh CLI integration
123
+ PR_FILES=$(gh pr view 123 --json files --jq '.files[].path')
124
+
125
+ # Run swarm review
126
+ REVIEW_RESULTS=$(npx ruv-swarm github pr-review 123 \
127
+ --agents "security,performance,style" \
128
+ --files "$PR_FILES")
129
+
130
+ # Post review comments using gh CLI
131
+ echo "$REVIEW_RESULTS" | jq -r '.comments[]' | while read -r comment; do
132
+ FILE=$(echo "$comment" | jq -r '.file')
133
+ LINE=$(echo "$comment" | jq -r '.line')
134
+ BODY=$(echo "$comment" | jq -r '.body')
135
+
136
+ gh pr review 123 --comment --body "$BODY"
137
+ done
138
+ ```
139
+
140
+ ## Advanced Features
141
+
142
+ ### 1. Multi-PR Swarm Coordination
143
+ ```bash
144
+ # Coordinate swarms across related PRs
145
+ npx ruv-swarm github multi-pr \
146
+ --prs "123,124,125" \
147
+ --strategy "parallel" \
148
+ --share-memory
149
+ ```
150
+
151
+ ### 2. PR Dependency Analysis
152
+ ```bash
153
+ # Analyze PR dependencies
154
+ npx ruv-swarm github pr-deps 123 \
155
+ --spawn-agents \
156
+ --resolve-conflicts
157
+ ```
158
+
159
+ ### 3. Automated PR Fixes
160
+ ```bash
161
+ # Auto-fix PR issues
162
+ npx ruv-swarm github pr-fix 123 \
163
+ --issues "lint,test-failures" \
164
+ --commit-fixes
165
+ ```
166
+
167
+ ## Best Practices
168
+
169
+ ### 1. PR Templates
170
+ ```markdown
171
+ <!-- .github/pull_request_template.md -->
172
+ ## Swarm Configuration
173
+ - Topology: [mesh/hierarchical/ring/star]
174
+ - Max Agents: [number]
175
+ - Auto-spawn: [yes/no]
176
+ - Priority: [high/medium/low]
177
+
178
+ ## Tasks for Swarm
179
+ - [ ] Task 1 description
180
+ - [ ] Task 2 description
181
+ ```
182
+
183
+ ### 2. Status Checks
184
+ ```yaml
185
+ # Require swarm completion before merge
186
+ required_status_checks:
187
+ contexts:
188
+ - "swarm/tasks-complete"
189
+ - "swarm/tests-pass"
190
+ - "swarm/review-approved"
191
+ ```
192
+
193
+ ### 3. PR Merge Automation
194
+ ```bash
195
+ # Auto-merge when swarm completes using gh CLI
196
+ # Check swarm completion status
197
+ SWARM_STATUS=$(npx ruv-swarm github pr-status 123)
198
+
199
+ if [[ "$SWARM_STATUS" == "complete" ]]; then
200
+ # Check review requirements
201
+ REVIEWS=$(gh pr view 123 --json reviews --jq '.reviews | length')
202
+
203
+ if [[ $REVIEWS -ge 2 ]]; then
204
+ # Enable auto-merge
205
+ gh pr merge 123 --auto --squash
206
+ fi
207
+ fi
208
+ ```
209
+
210
+ ## Webhook Integration
211
+
212
+ ### Setup Webhook Handler
213
+ ```javascript
214
+ // webhook-handler.js
215
+ const { createServer } = require('http');
216
+ const { execSync } = require('child_process');
217
+
218
+ createServer((req, res) => {
219
+ if (req.url === '/github-webhook') {
220
+ const event = JSON.parse(body);
221
+
222
+ if (event.action === 'opened' && event.pull_request) {
223
+ execSync(`npx ruv-swarm github pr-init ${event.pull_request.number}`);
224
+ }
225
+
226
+ res.writeHead(200);
227
+ res.end('OK');
228
+ }
229
+ }).listen(3000);
230
+ ```
231
+
232
+ ## Examples
233
+
234
+ ### Feature Development PR
235
+ ```bash
236
+ # PR #456: Add user authentication
237
+ npx ruv-swarm github pr-init 456 \
238
+ --topology hierarchical \
239
+ --agents "architect,coder,tester,security" \
240
+ --auto-assign-tasks
241
+ ```
242
+
243
+ ### Bug Fix PR
244
+ ```bash
245
+ # PR #789: Fix memory leak
246
+ npx ruv-swarm github pr-init 789 \
247
+ --topology mesh \
248
+ --agents "debugger,analyst,tester" \
249
+ --priority high
250
+ ```
251
+
252
+ ### Documentation PR
253
+ ```bash
254
+ # PR #321: Update API docs
255
+ npx ruv-swarm github pr-init 321 \
256
+ --topology ring \
257
+ --agents "researcher,writer,reviewer" \
258
+ --validate-links
259
+ ```
260
+
261
+ ## Metrics & Reporting
262
+
263
+ ### PR Swarm Analytics
264
+ ```bash
265
+ # Generate PR swarm report
266
+ npx ruv-swarm github pr-report 123 \
267
+ --metrics "completion-time,agent-efficiency,token-usage" \
268
+ --format markdown
269
+ ```
270
+
271
+ ### Dashboard Integration
272
+ ```bash
273
+ # Export to GitHub Insights
274
+ npx ruv-swarm github export-metrics \
275
+ --pr 123 \
276
+ --to-insights
277
+ ```
278
+
279
+ ## Security Considerations
280
+
281
+ 1. **Token Permissions**: Ensure GitHub tokens have appropriate scopes
282
+ 2. **Command Validation**: Validate all PR comments before execution
283
+ 3. **Rate Limiting**: Implement rate limits for PR operations
284
+ 4. **Audit Trail**: Log all swarm operations for compliance
285
+
286
+ ## Integration with Claude Code
287
+
288
+ When using with Claude Code:
289
+ 1. Claude Code reads PR diff and context
290
+ 2. Swarm coordinates approach based on PR type
291
+ 3. Agents work in parallel on different aspects
292
+ 4. Progress updates posted to PR automatically
293
+ 5. Final review performed before marking ready
294
+
295
+ ## Advanced Swarm PR Coordination
296
+
297
+ ### Multi-Agent PR Analysis
298
+ ```bash
299
+ # Initialize PR-specific swarm with intelligent topology selection
300
+ mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
301
+ mcp__claude-flow__agent_spawn { type: "coordinator", name: "PR Coordinator" }
302
+ mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
303
+ mcp__claude-flow__agent_spawn { type: "tester", name: "Test Engineer" }
304
+ mcp__claude-flow__agent_spawn { type: "analyst", name: "Impact Analyzer" }
305
+ mcp__claude-flow__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
306
+
307
+ # Store PR context for swarm coordination
308
+ mcp__claude-flow__memory_usage {
309
+ action: "store",
310
+ key: "pr/#{pr_number}/analysis",
311
+ value: {
312
+ diff: "pr_diff_content",
313
+ files_changed: ["file1.js", "file2.py"],
314
+ complexity_score: 8.5,
315
+ risk_assessment: "medium"
316
+ }
317
+ }
318
+
319
+ # Orchestrate comprehensive PR workflow
320
+ mcp__claude-flow__task_orchestrate {
321
+ task: "Execute multi-agent PR review and validation workflow",
322
+ strategy: "parallel",
323
+ priority: "high",
324
+ dependencies: ["diff_analysis", "test_validation", "security_review"]
325
+ }
326
+ ```
327
+
328
+ ### Swarm-Coordinated PR Lifecycle
329
+ ```javascript
330
+ // Pre-hook: PR Initialization and Swarm Setup
331
+ const prPreHook = async (prData) => {
332
+ // Analyze PR complexity for optimal swarm configuration
333
+ const complexity = await analyzePRComplexity(prData);
334
+ const topology = complexity > 7 ? "hierarchical" : "mesh";
335
+
336
+ // Initialize swarm with PR-specific configuration
337
+ await mcp__claude_flow__swarm_init({ topology, maxAgents: 8 });
338
+
339
+ // Store comprehensive PR context
340
+ await mcp__claude_flow__memory_usage({
341
+ action: "store",
342
+ key: `pr/${prData.number}/context`,
343
+ value: {
344
+ pr: prData,
345
+ complexity,
346
+ agents_assigned: await getOptimalAgents(prData),
347
+ timeline: generateTimeline(prData)
348
+ }
349
+ });
350
+
351
+ // Coordinate initial agent synchronization
352
+ await mcp__claude_flow__coordination_sync({ swarmId: "current" });
353
+ };
354
+
355
+ // Post-hook: PR Completion and Metrics
356
+ const prPostHook = async (results) => {
357
+ // Generate comprehensive PR completion report
358
+ const report = await generatePRReport(results);
359
+
360
+ // Update PR with final swarm analysis
361
+ await updatePRWithResults(report);
362
+
363
+ // Store completion metrics for future optimization
364
+ await mcp__claude_flow__memory_usage({
365
+ action: "store",
366
+ key: `pr/${results.number}/completion`,
367
+ value: {
368
+ completion_time: results.duration,
369
+ agent_efficiency: results.agentMetrics,
370
+ quality_score: results.qualityAssessment,
371
+ lessons_learned: results.insights
372
+ }
373
+ });
374
+ };
375
+ ```
376
+
377
+ ### Intelligent PR Merge Coordination
378
+ ```bash
379
+ # Coordinate merge decision with swarm consensus
380
+ mcp__claude-flow__coordination_sync { swarmId: "pr-review-swarm" }
381
+
382
+ # Analyze merge readiness with multiple agents
383
+ mcp__claude-flow__task_orchestrate {
384
+ task: "Evaluate PR merge readiness with comprehensive validation",
385
+ strategy: "sequential",
386
+ priority: "critical"
387
+ }
388
+
389
+ # Store merge decision context
390
+ mcp__claude-flow__memory_usage {
391
+ action: "store",
392
+ key: "pr/merge_decisions/#{pr_number}",
393
+ value: {
394
+ ready_to_merge: true,
395
+ validation_passed: true,
396
+ agent_consensus: "approved",
397
+ final_review_score: 9.2
398
+ }
399
+ }
400
+ ```
401
+
402
402
  See also: [swarm-issue.md](./swarm-issue.md), [sync-coordinator.md](./sync-coordinator.md), [workflow-automation.md](./workflow-automation.md)