claude-flow 3.32.9 → 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 (451) 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 +156 -1
  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 -79
  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 -192
  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/embeddings.js +26 -26
  406. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  407. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +31 -10
  408. package/v3/@claude-flow/cli/dist/src/commands/init.js +202 -34
  409. package/v3/@claude-flow/cli/dist/src/commands/memory.js +12 -1
  410. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  418. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  419. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +13 -2
  420. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +12 -10
  421. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +83 -11
  422. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  423. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  424. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +2 -2
  425. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  426. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +24 -24
  427. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  428. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  429. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +8 -0
  430. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +21 -0
  431. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +4 -3
  432. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  433. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +192 -123
  434. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +407 -407
  435. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  436. package/v3/@claude-flow/cli/dist/src/parser.js +25 -9
  437. package/v3/@claude-flow/cli/dist/src/proxy/verify.js +2 -2
  438. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  439. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  440. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  441. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  442. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +7 -4
  443. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  444. package/v3/@claude-flow/cli/package.json +137 -137
  445. package/v3/@claude-flow/guidance/README.md +1195 -1195
  446. package/v3/@claude-flow/guidance/package.json +198 -198
  447. package/v3/@claude-flow/shared/README.md +323 -323
  448. package/v3/@claude-flow/shared/dist/events/event-store.js +31 -31
  449. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  450. package/v3/@claude-flow/shared/package.json +43 -43
  451. package/v3/README.md +493 -493
@@ -1,514 +1,514 @@
1
- # Code Review Swarm - Automated Code Review with AI Agents
2
-
3
- ## Overview
4
- Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.
5
-
6
- ## Core Features
7
-
8
- ### 1. Multi-Agent Review System
9
- ```bash
10
- # Initialize code review swarm with gh CLI
11
- # Get PR details
12
- PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
13
- PR_DIFF=$(gh pr diff 123)
14
-
15
- # Initialize swarm with PR context
16
- npx ruv-swarm github review-init \
17
- --pr 123 \
18
- --pr-data "$PR_DATA" \
19
- --diff "$PR_DIFF" \
20
- --agents "security,performance,style,architecture,accessibility" \
21
- --depth comprehensive
22
-
23
- # Post initial review status
24
- gh pr comment 123 --body "🔍 Multi-agent code review initiated"
25
- ```
26
-
27
- ### 2. Specialized Review Agents
28
-
29
- #### Security Agent
30
- ```bash
31
- # Security-focused review with gh CLI
32
- # Get changed files
33
- CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
34
-
35
- # Run security review
36
- SECURITY_RESULTS=$(npx ruv-swarm github review-security \
37
- --pr 123 \
38
- --files "$CHANGED_FILES" \
39
- --check "owasp,cve,secrets,permissions" \
40
- --suggest-fixes)
41
-
42
- # Post security findings
43
- if echo "$SECURITY_RESULTS" | grep -q "critical"; then
44
- # Request changes for critical issues
45
- gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
46
- # Add security label
47
- gh pr edit 123 --add-label "security-review-required"
48
- else
49
- # Post as comment for non-critical issues
50
- gh pr comment 123 --body "$SECURITY_RESULTS"
51
- fi
52
- ```
53
-
54
- #### Performance Agent
55
- ```bash
56
- # Performance analysis
57
- npx ruv-swarm github review-performance \
58
- --pr 123 \
59
- --profile "cpu,memory,io" \
60
- --benchmark-against main \
61
- --suggest-optimizations
62
- ```
63
-
64
- #### Architecture Agent
65
- ```bash
66
- # Architecture review
67
- npx ruv-swarm github review-architecture \
68
- --pr 123 \
69
- --check "patterns,coupling,cohesion,solid" \
70
- --visualize-impact \
71
- --suggest-refactoring
72
- ```
73
-
74
- ### 3. Review Configuration
75
- ```yaml
76
- # .github/review-swarm.yml
77
- version: 1
78
- review:
79
- auto-trigger: true
80
- required-agents:
81
- - security
82
- - performance
83
- - style
84
- optional-agents:
85
- - architecture
86
- - accessibility
87
- - i18n
88
-
89
- thresholds:
90
- security: block
91
- performance: warn
92
- style: suggest
93
-
94
- rules:
95
- security:
96
- - no-eval
97
- - no-hardcoded-secrets
98
- - proper-auth-checks
99
- performance:
100
- - no-n-plus-one
101
- - efficient-queries
102
- - proper-caching
103
- architecture:
104
- - max-coupling: 5
105
- - min-cohesion: 0.7
106
- - follow-patterns
107
- ```
108
-
109
- ## Review Agents
110
-
111
- ### Security Review Agent
112
- ```javascript
113
- // Security checks performed
114
- {
115
- "checks": [
116
- "SQL injection vulnerabilities",
117
- "XSS attack vectors",
118
- "Authentication bypasses",
119
- "Authorization flaws",
120
- "Cryptographic weaknesses",
121
- "Dependency vulnerabilities",
122
- "Secret exposure",
123
- "CORS misconfigurations"
124
- ],
125
- "actions": [
126
- "Block PR on critical issues",
127
- "Suggest secure alternatives",
128
- "Add security test cases",
129
- "Update security documentation"
130
- ]
131
- }
132
- ```
133
-
134
- ### Performance Review Agent
135
- ```javascript
136
- // Performance analysis
137
- {
138
- "metrics": [
139
- "Algorithm complexity",
140
- "Database query efficiency",
141
- "Memory allocation patterns",
142
- "Cache utilization",
143
- "Network request optimization",
144
- "Bundle size impact",
145
- "Render performance"
146
- ],
147
- "benchmarks": [
148
- "Compare with baseline",
149
- "Load test simulations",
150
- "Memory leak detection",
151
- "Bottleneck identification"
152
- ]
153
- }
154
- ```
155
-
156
- ### Style & Convention Agent
157
- ```javascript
158
- // Style enforcement
159
- {
160
- "checks": [
161
- "Code formatting",
162
- "Naming conventions",
163
- "Documentation standards",
164
- "Comment quality",
165
- "Test coverage",
166
- "Error handling patterns",
167
- "Logging standards"
168
- ],
169
- "auto-fix": [
170
- "Formatting issues",
171
- "Import organization",
172
- "Trailing whitespace",
173
- "Simple naming issues"
174
- ]
175
- }
176
- ```
177
-
178
- ### Architecture Review Agent
179
- ```javascript
180
- // Architecture analysis
181
- {
182
- "patterns": [
183
- "Design pattern adherence",
184
- "SOLID principles",
185
- "DRY violations",
186
- "Separation of concerns",
187
- "Dependency injection",
188
- "Layer violations",
189
- "Circular dependencies"
190
- ],
191
- "metrics": [
192
- "Coupling metrics",
193
- "Cohesion scores",
194
- "Complexity measures",
195
- "Maintainability index"
196
- ]
197
- }
198
- ```
199
-
200
- ## Advanced Review Features
201
-
202
- ### 1. Context-Aware Reviews
203
- ```bash
204
- # Review with full context
205
- npx ruv-swarm github review-context \
206
- --pr 123 \
207
- --load-related-prs \
208
- --analyze-impact \
209
- --check-breaking-changes
210
- ```
211
-
212
- ### 2. Learning from History
213
- ```bash
214
- # Learn from past reviews
215
- npx ruv-swarm github review-learn \
216
- --analyze-past-reviews \
217
- --identify-patterns \
218
- --improve-suggestions \
219
- --reduce-false-positives
220
- ```
221
-
222
- ### 3. Cross-PR Analysis
223
- ```bash
224
- # Analyze related PRs together
225
- npx ruv-swarm github review-batch \
226
- --prs "123,124,125" \
227
- --check-consistency \
228
- --verify-integration \
229
- --combined-impact
230
- ```
231
-
232
- ## Review Automation
233
-
234
- ### Auto-Review on Push
235
- ```yaml
236
- # .github/workflows/auto-review.yml
237
- name: Automated Code Review
238
- on:
239
- pull_request:
240
- types: [opened, synchronize]
241
-
242
- jobs:
243
- swarm-review:
244
- runs-on: ubuntu-latest
245
- steps:
246
- - uses: actions/checkout@v4
247
- with:
248
- fetch-depth: 0
249
-
250
- - name: Setup GitHub CLI
251
- run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
252
-
253
- - name: Run Review Swarm
254
- run: |
255
- # Get PR context with gh CLI
256
- PR_NUM=${{ github.event.pull_request.number }}
257
- PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)
258
-
259
- # Run swarm review
260
- REVIEW_OUTPUT=$(npx ruv-swarm github review-all \
261
- --pr $PR_NUM \
262
- --pr-data "$PR_DATA" \
263
- --agents "security,performance,style,architecture")
264
-
265
- # Post review results
266
- echo "$REVIEW_OUTPUT" | gh pr review $PR_NUM --comment -F -
267
-
268
- # Update PR status
269
- if echo "$REVIEW_OUTPUT" | grep -q "approved"; then
270
- gh pr review $PR_NUM --approve
271
- elif echo "$REVIEW_OUTPUT" | grep -q "changes-requested"; then
272
- gh pr review $PR_NUM --request-changes -b "See review comments above"
273
- fi
274
- ```
275
-
276
- ### Review Triggers
277
- ```javascript
278
- // Custom review triggers
279
- {
280
- "triggers": {
281
- "high-risk-files": {
282
- "paths": ["**/auth/**", "**/payment/**"],
283
- "agents": ["security", "architecture"],
284
- "depth": "comprehensive"
285
- },
286
- "performance-critical": {
287
- "paths": ["**/api/**", "**/database/**"],
288
- "agents": ["performance", "database"],
289
- "benchmarks": true
290
- },
291
- "ui-changes": {
292
- "paths": ["**/components/**", "**/styles/**"],
293
- "agents": ["accessibility", "style", "i18n"],
294
- "visual-tests": true
295
- }
296
- }
297
- }
298
- ```
299
-
300
- ## Review Comments
301
-
302
- ### Intelligent Comment Generation
303
- ```bash
304
- # Generate contextual review comments with gh CLI
305
- # Get PR diff with context
306
- PR_DIFF=$(gh pr diff 123 --color never)
307
- PR_FILES=$(gh pr view 123 --json files)
308
-
309
- # Generate review comments
310
- COMMENTS=$(npx ruv-swarm github review-comment \
311
- --pr 123 \
312
- --diff "$PR_DIFF" \
313
- --files "$PR_FILES" \
314
- --style "constructive" \
315
- --include-examples \
316
- --suggest-fixes)
317
-
318
- # Post comments using gh CLI
319
- echo "$COMMENTS" | jq -c '.[]' | while read -r comment; do
320
- FILE=$(echo "$comment" | jq -r '.path')
321
- LINE=$(echo "$comment" | jq -r '.line')
322
- BODY=$(echo "$comment" | jq -r '.body')
323
-
324
- # Create review with inline comments
325
- gh api \
326
- --method POST \
327
- /repos/:owner/:repo/pulls/123/comments \
328
- -f path="$FILE" \
329
- -f line="$LINE" \
330
- -f body="$BODY" \
331
- -f commit_id="$(gh pr view 123 --json headRefOid -q .headRefOid)"
332
- done
333
- ```
334
-
335
- ### Comment Templates
336
- ```markdown
337
- <!-- Security Issue Template -->
338
- 🔒 **Security Issue: [Type]**
339
-
340
- **Severity**: 🔴 Critical / 🟡 High / 🟢 Low
341
-
342
- **Description**:
343
- [Clear explanation of the security issue]
344
-
345
- **Impact**:
346
- [Potential consequences if not addressed]
347
-
348
- **Suggested Fix**:
349
- ```language
350
- [Code example of the fix]
351
- ```
352
-
353
- **References**:
354
- - [OWASP Guide](link)
355
- - [Security Best Practices](link)
356
- ```
357
-
358
- ### Batch Comment Management
359
- ```bash
360
- # Manage review comments efficiently
361
- npx ruv-swarm github review-comments \
362
- --pr 123 \
363
- --group-by "agent,severity" \
364
- --summarize \
365
- --resolve-outdated
366
- ```
367
-
368
- ## Integration with CI/CD
369
-
370
- ### Status Checks
371
- ```yaml
372
- # Required status checks
373
- protection_rules:
374
- required_status_checks:
375
- contexts:
376
- - "review-swarm/security"
377
- - "review-swarm/performance"
378
- - "review-swarm/architecture"
379
- ```
380
-
381
- ### Quality Gates
382
- ```bash
383
- # Define quality gates
384
- npx ruv-swarm github quality-gates \
385
- --define '{
386
- "security": {"threshold": "no-critical"},
387
- "performance": {"regression": "<5%"},
388
- "coverage": {"minimum": "80%"},
389
- "architecture": {"complexity": "<10"}
390
- }'
391
- ```
392
-
393
- ### Review Metrics
394
- ```bash
395
- # Track review effectiveness
396
- npx ruv-swarm github review-metrics \
397
- --period 30d \
398
- --metrics "issues-found,false-positives,fix-rate" \
399
- --export-dashboard
400
- ```
401
-
402
- ## Best Practices
403
-
404
- ### 1. Review Configuration
405
- - Define clear review criteria
406
- - Set appropriate thresholds
407
- - Configure agent specializations
408
- - Establish override procedures
409
-
410
- ### 2. Comment Quality
411
- - Provide actionable feedback
412
- - Include code examples
413
- - Reference documentation
414
- - Maintain respectful tone
415
-
416
- ### 3. Performance
417
- - Cache analysis results
418
- - Incremental reviews for large PRs
419
- - Parallel agent execution
420
- - Smart comment batching
421
-
422
- ## Advanced Features
423
-
424
- ### 1. AI Learning
425
- ```bash
426
- # Train on your codebase
427
- npx ruv-swarm github review-train \
428
- --learn-patterns \
429
- --adapt-to-style \
430
- --improve-accuracy
431
- ```
432
-
433
- ### 2. Custom Review Agents
434
- ```javascript
435
- // Create custom review agent
436
- class CustomReviewAgent {
437
- async review(pr) {
438
- const issues = [];
439
-
440
- // Custom logic here
441
- if (await this.checkCustomRule(pr)) {
442
- issues.push({
443
- severity: 'warning',
444
- message: 'Custom rule violation',
445
- suggestion: 'Fix suggestion'
446
- });
447
- }
448
-
449
- return issues;
450
- }
451
- }
452
- ```
453
-
454
- ### 3. Review Orchestration
455
- ```bash
456
- # Orchestrate complex reviews
457
- npx ruv-swarm github review-orchestrate \
458
- --strategy "risk-based" \
459
- --allocate-time-budget \
460
- --prioritize-critical
461
- ```
462
-
463
- ## Examples
464
-
465
- ### Security-Critical PR
466
- ```bash
467
- # Auth system changes
468
- npx ruv-swarm github review-init \
469
- --pr 456 \
470
- --agents "security,authentication,audit" \
471
- --depth "maximum" \
472
- --require-security-approval
473
- ```
474
-
475
- ### Performance-Sensitive PR
476
- ```bash
477
- # Database optimization
478
- npx ruv-swarm github review-init \
479
- --pr 789 \
480
- --agents "performance,database,caching" \
481
- --benchmark \
482
- --profile
483
- ```
484
-
485
- ### UI Component PR
486
- ```bash
487
- # New component library
488
- npx ruv-swarm github review-init \
489
- --pr 321 \
490
- --agents "accessibility,style,i18n,docs" \
491
- --visual-regression \
492
- --component-tests
493
- ```
494
-
495
- ## Monitoring & Analytics
496
-
497
- ### Review Dashboard
498
- ```bash
499
- # Launch review dashboard
500
- npx ruv-swarm github review-dashboard \
501
- --real-time \
502
- --show "agent-activity,issue-trends,fix-rates"
503
- ```
504
-
505
- ### Review Reports
506
- ```bash
507
- # Generate review reports
508
- npx ruv-swarm github review-report \
509
- --format "markdown" \
510
- --include "summary,details,trends" \
511
- --email-stakeholders
512
- ```
513
-
1
+ # Code Review Swarm - Automated Code Review with AI Agents
2
+
3
+ ## Overview
4
+ Deploy specialized AI agents to perform comprehensive, intelligent code reviews that go beyond traditional static analysis.
5
+
6
+ ## Core Features
7
+
8
+ ### 1. Multi-Agent Review System
9
+ ```bash
10
+ # Initialize code review swarm with gh CLI
11
+ # Get PR details
12
+ PR_DATA=$(gh pr view 123 --json files,additions,deletions,title,body)
13
+ PR_DIFF=$(gh pr diff 123)
14
+
15
+ # Initialize swarm with PR context
16
+ npx ruv-swarm github review-init \
17
+ --pr 123 \
18
+ --pr-data "$PR_DATA" \
19
+ --diff "$PR_DIFF" \
20
+ --agents "security,performance,style,architecture,accessibility" \
21
+ --depth comprehensive
22
+
23
+ # Post initial review status
24
+ gh pr comment 123 --body "🔍 Multi-agent code review initiated"
25
+ ```
26
+
27
+ ### 2. Specialized Review Agents
28
+
29
+ #### Security Agent
30
+ ```bash
31
+ # Security-focused review with gh CLI
32
+ # Get changed files
33
+ CHANGED_FILES=$(gh pr view 123 --json files --jq '.files[].path')
34
+
35
+ # Run security review
36
+ SECURITY_RESULTS=$(npx ruv-swarm github review-security \
37
+ --pr 123 \
38
+ --files "$CHANGED_FILES" \
39
+ --check "owasp,cve,secrets,permissions" \
40
+ --suggest-fixes)
41
+
42
+ # Post security findings
43
+ if echo "$SECURITY_RESULTS" | grep -q "critical"; then
44
+ # Request changes for critical issues
45
+ gh pr review 123 --request-changes --body "$SECURITY_RESULTS"
46
+ # Add security label
47
+ gh pr edit 123 --add-label "security-review-required"
48
+ else
49
+ # Post as comment for non-critical issues
50
+ gh pr comment 123 --body "$SECURITY_RESULTS"
51
+ fi
52
+ ```
53
+
54
+ #### Performance Agent
55
+ ```bash
56
+ # Performance analysis
57
+ npx ruv-swarm github review-performance \
58
+ --pr 123 \
59
+ --profile "cpu,memory,io" \
60
+ --benchmark-against main \
61
+ --suggest-optimizations
62
+ ```
63
+
64
+ #### Architecture Agent
65
+ ```bash
66
+ # Architecture review
67
+ npx ruv-swarm github review-architecture \
68
+ --pr 123 \
69
+ --check "patterns,coupling,cohesion,solid" \
70
+ --visualize-impact \
71
+ --suggest-refactoring
72
+ ```
73
+
74
+ ### 3. Review Configuration
75
+ ```yaml
76
+ # .github/review-swarm.yml
77
+ version: 1
78
+ review:
79
+ auto-trigger: true
80
+ required-agents:
81
+ - security
82
+ - performance
83
+ - style
84
+ optional-agents:
85
+ - architecture
86
+ - accessibility
87
+ - i18n
88
+
89
+ thresholds:
90
+ security: block
91
+ performance: warn
92
+ style: suggest
93
+
94
+ rules:
95
+ security:
96
+ - no-eval
97
+ - no-hardcoded-secrets
98
+ - proper-auth-checks
99
+ performance:
100
+ - no-n-plus-one
101
+ - efficient-queries
102
+ - proper-caching
103
+ architecture:
104
+ - max-coupling: 5
105
+ - min-cohesion: 0.7
106
+ - follow-patterns
107
+ ```
108
+
109
+ ## Review Agents
110
+
111
+ ### Security Review Agent
112
+ ```javascript
113
+ // Security checks performed
114
+ {
115
+ "checks": [
116
+ "SQL injection vulnerabilities",
117
+ "XSS attack vectors",
118
+ "Authentication bypasses",
119
+ "Authorization flaws",
120
+ "Cryptographic weaknesses",
121
+ "Dependency vulnerabilities",
122
+ "Secret exposure",
123
+ "CORS misconfigurations"
124
+ ],
125
+ "actions": [
126
+ "Block PR on critical issues",
127
+ "Suggest secure alternatives",
128
+ "Add security test cases",
129
+ "Update security documentation"
130
+ ]
131
+ }
132
+ ```
133
+
134
+ ### Performance Review Agent
135
+ ```javascript
136
+ // Performance analysis
137
+ {
138
+ "metrics": [
139
+ "Algorithm complexity",
140
+ "Database query efficiency",
141
+ "Memory allocation patterns",
142
+ "Cache utilization",
143
+ "Network request optimization",
144
+ "Bundle size impact",
145
+ "Render performance"
146
+ ],
147
+ "benchmarks": [
148
+ "Compare with baseline",
149
+ "Load test simulations",
150
+ "Memory leak detection",
151
+ "Bottleneck identification"
152
+ ]
153
+ }
154
+ ```
155
+
156
+ ### Style & Convention Agent
157
+ ```javascript
158
+ // Style enforcement
159
+ {
160
+ "checks": [
161
+ "Code formatting",
162
+ "Naming conventions",
163
+ "Documentation standards",
164
+ "Comment quality",
165
+ "Test coverage",
166
+ "Error handling patterns",
167
+ "Logging standards"
168
+ ],
169
+ "auto-fix": [
170
+ "Formatting issues",
171
+ "Import organization",
172
+ "Trailing whitespace",
173
+ "Simple naming issues"
174
+ ]
175
+ }
176
+ ```
177
+
178
+ ### Architecture Review Agent
179
+ ```javascript
180
+ // Architecture analysis
181
+ {
182
+ "patterns": [
183
+ "Design pattern adherence",
184
+ "SOLID principles",
185
+ "DRY violations",
186
+ "Separation of concerns",
187
+ "Dependency injection",
188
+ "Layer violations",
189
+ "Circular dependencies"
190
+ ],
191
+ "metrics": [
192
+ "Coupling metrics",
193
+ "Cohesion scores",
194
+ "Complexity measures",
195
+ "Maintainability index"
196
+ ]
197
+ }
198
+ ```
199
+
200
+ ## Advanced Review Features
201
+
202
+ ### 1. Context-Aware Reviews
203
+ ```bash
204
+ # Review with full context
205
+ npx ruv-swarm github review-context \
206
+ --pr 123 \
207
+ --load-related-prs \
208
+ --analyze-impact \
209
+ --check-breaking-changes
210
+ ```
211
+
212
+ ### 2. Learning from History
213
+ ```bash
214
+ # Learn from past reviews
215
+ npx ruv-swarm github review-learn \
216
+ --analyze-past-reviews \
217
+ --identify-patterns \
218
+ --improve-suggestions \
219
+ --reduce-false-positives
220
+ ```
221
+
222
+ ### 3. Cross-PR Analysis
223
+ ```bash
224
+ # Analyze related PRs together
225
+ npx ruv-swarm github review-batch \
226
+ --prs "123,124,125" \
227
+ --check-consistency \
228
+ --verify-integration \
229
+ --combined-impact
230
+ ```
231
+
232
+ ## Review Automation
233
+
234
+ ### Auto-Review on Push
235
+ ```yaml
236
+ # .github/workflows/auto-review.yml
237
+ name: Automated Code Review
238
+ on:
239
+ pull_request:
240
+ types: [opened, synchronize]
241
+
242
+ jobs:
243
+ swarm-review:
244
+ runs-on: ubuntu-latest
245
+ steps:
246
+ - uses: actions/checkout@v4
247
+ with:
248
+ fetch-depth: 0
249
+
250
+ - name: Setup GitHub CLI
251
+ run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
252
+
253
+ - name: Run Review Swarm
254
+ run: |
255
+ # Get PR context with gh CLI
256
+ PR_NUM=${{ github.event.pull_request.number }}
257
+ PR_DATA=$(gh pr view $PR_NUM --json files,title,body,labels)
258
+
259
+ # Run swarm review
260
+ REVIEW_OUTPUT=$(npx ruv-swarm github review-all \
261
+ --pr $PR_NUM \
262
+ --pr-data "$PR_DATA" \
263
+ --agents "security,performance,style,architecture")
264
+
265
+ # Post review results
266
+ echo "$REVIEW_OUTPUT" | gh pr review $PR_NUM --comment -F -
267
+
268
+ # Update PR status
269
+ if echo "$REVIEW_OUTPUT" | grep -q "approved"; then
270
+ gh pr review $PR_NUM --approve
271
+ elif echo "$REVIEW_OUTPUT" | grep -q "changes-requested"; then
272
+ gh pr review $PR_NUM --request-changes -b "See review comments above"
273
+ fi
274
+ ```
275
+
276
+ ### Review Triggers
277
+ ```javascript
278
+ // Custom review triggers
279
+ {
280
+ "triggers": {
281
+ "high-risk-files": {
282
+ "paths": ["**/auth/**", "**/payment/**"],
283
+ "agents": ["security", "architecture"],
284
+ "depth": "comprehensive"
285
+ },
286
+ "performance-critical": {
287
+ "paths": ["**/api/**", "**/database/**"],
288
+ "agents": ["performance", "database"],
289
+ "benchmarks": true
290
+ },
291
+ "ui-changes": {
292
+ "paths": ["**/components/**", "**/styles/**"],
293
+ "agents": ["accessibility", "style", "i18n"],
294
+ "visual-tests": true
295
+ }
296
+ }
297
+ }
298
+ ```
299
+
300
+ ## Review Comments
301
+
302
+ ### Intelligent Comment Generation
303
+ ```bash
304
+ # Generate contextual review comments with gh CLI
305
+ # Get PR diff with context
306
+ PR_DIFF=$(gh pr diff 123 --color never)
307
+ PR_FILES=$(gh pr view 123 --json files)
308
+
309
+ # Generate review comments
310
+ COMMENTS=$(npx ruv-swarm github review-comment \
311
+ --pr 123 \
312
+ --diff "$PR_DIFF" \
313
+ --files "$PR_FILES" \
314
+ --style "constructive" \
315
+ --include-examples \
316
+ --suggest-fixes)
317
+
318
+ # Post comments using gh CLI
319
+ echo "$COMMENTS" | jq -c '.[]' | while read -r comment; do
320
+ FILE=$(echo "$comment" | jq -r '.path')
321
+ LINE=$(echo "$comment" | jq -r '.line')
322
+ BODY=$(echo "$comment" | jq -r '.body')
323
+
324
+ # Create review with inline comments
325
+ gh api \
326
+ --method POST \
327
+ /repos/:owner/:repo/pulls/123/comments \
328
+ -f path="$FILE" \
329
+ -f line="$LINE" \
330
+ -f body="$BODY" \
331
+ -f commit_id="$(gh pr view 123 --json headRefOid -q .headRefOid)"
332
+ done
333
+ ```
334
+
335
+ ### Comment Templates
336
+ ```markdown
337
+ <!-- Security Issue Template -->
338
+ 🔒 **Security Issue: [Type]**
339
+
340
+ **Severity**: 🔴 Critical / 🟡 High / 🟢 Low
341
+
342
+ **Description**:
343
+ [Clear explanation of the security issue]
344
+
345
+ **Impact**:
346
+ [Potential consequences if not addressed]
347
+
348
+ **Suggested Fix**:
349
+ ```language
350
+ [Code example of the fix]
351
+ ```
352
+
353
+ **References**:
354
+ - [OWASP Guide](link)
355
+ - [Security Best Practices](link)
356
+ ```
357
+
358
+ ### Batch Comment Management
359
+ ```bash
360
+ # Manage review comments efficiently
361
+ npx ruv-swarm github review-comments \
362
+ --pr 123 \
363
+ --group-by "agent,severity" \
364
+ --summarize \
365
+ --resolve-outdated
366
+ ```
367
+
368
+ ## Integration with CI/CD
369
+
370
+ ### Status Checks
371
+ ```yaml
372
+ # Required status checks
373
+ protection_rules:
374
+ required_status_checks:
375
+ contexts:
376
+ - "review-swarm/security"
377
+ - "review-swarm/performance"
378
+ - "review-swarm/architecture"
379
+ ```
380
+
381
+ ### Quality Gates
382
+ ```bash
383
+ # Define quality gates
384
+ npx ruv-swarm github quality-gates \
385
+ --define '{
386
+ "security": {"threshold": "no-critical"},
387
+ "performance": {"regression": "<5%"},
388
+ "coverage": {"minimum": "80%"},
389
+ "architecture": {"complexity": "<10"}
390
+ }'
391
+ ```
392
+
393
+ ### Review Metrics
394
+ ```bash
395
+ # Track review effectiveness
396
+ npx ruv-swarm github review-metrics \
397
+ --period 30d \
398
+ --metrics "issues-found,false-positives,fix-rate" \
399
+ --export-dashboard
400
+ ```
401
+
402
+ ## Best Practices
403
+
404
+ ### 1. Review Configuration
405
+ - Define clear review criteria
406
+ - Set appropriate thresholds
407
+ - Configure agent specializations
408
+ - Establish override procedures
409
+
410
+ ### 2. Comment Quality
411
+ - Provide actionable feedback
412
+ - Include code examples
413
+ - Reference documentation
414
+ - Maintain respectful tone
415
+
416
+ ### 3. Performance
417
+ - Cache analysis results
418
+ - Incremental reviews for large PRs
419
+ - Parallel agent execution
420
+ - Smart comment batching
421
+
422
+ ## Advanced Features
423
+
424
+ ### 1. AI Learning
425
+ ```bash
426
+ # Train on your codebase
427
+ npx ruv-swarm github review-train \
428
+ --learn-patterns \
429
+ --adapt-to-style \
430
+ --improve-accuracy
431
+ ```
432
+
433
+ ### 2. Custom Review Agents
434
+ ```javascript
435
+ // Create custom review agent
436
+ class CustomReviewAgent {
437
+ async review(pr) {
438
+ const issues = [];
439
+
440
+ // Custom logic here
441
+ if (await this.checkCustomRule(pr)) {
442
+ issues.push({
443
+ severity: 'warning',
444
+ message: 'Custom rule violation',
445
+ suggestion: 'Fix suggestion'
446
+ });
447
+ }
448
+
449
+ return issues;
450
+ }
451
+ }
452
+ ```
453
+
454
+ ### 3. Review Orchestration
455
+ ```bash
456
+ # Orchestrate complex reviews
457
+ npx ruv-swarm github review-orchestrate \
458
+ --strategy "risk-based" \
459
+ --allocate-time-budget \
460
+ --prioritize-critical
461
+ ```
462
+
463
+ ## Examples
464
+
465
+ ### Security-Critical PR
466
+ ```bash
467
+ # Auth system changes
468
+ npx ruv-swarm github review-init \
469
+ --pr 456 \
470
+ --agents "security,authentication,audit" \
471
+ --depth "maximum" \
472
+ --require-security-approval
473
+ ```
474
+
475
+ ### Performance-Sensitive PR
476
+ ```bash
477
+ # Database optimization
478
+ npx ruv-swarm github review-init \
479
+ --pr 789 \
480
+ --agents "performance,database,caching" \
481
+ --benchmark \
482
+ --profile
483
+ ```
484
+
485
+ ### UI Component PR
486
+ ```bash
487
+ # New component library
488
+ npx ruv-swarm github review-init \
489
+ --pr 321 \
490
+ --agents "accessibility,style,i18n,docs" \
491
+ --visual-regression \
492
+ --component-tests
493
+ ```
494
+
495
+ ## Monitoring & Analytics
496
+
497
+ ### Review Dashboard
498
+ ```bash
499
+ # Launch review dashboard
500
+ npx ruv-swarm github review-dashboard \
501
+ --real-time \
502
+ --show "agent-activity,issue-trends,fix-rates"
503
+ ```
504
+
505
+ ### Review Reports
506
+ ```bash
507
+ # Generate review reports
508
+ npx ruv-swarm github review-report \
509
+ --format "markdown" \
510
+ --include "summary,details,trends" \
511
+ --email-stakeholders
512
+ ```
513
+
514
514
  See also: [swarm-pr.md](./swarm-pr.md), [workflow-automation.md](./workflow-automation.md)