@claude-flow/cli 3.6.30 → 3.7.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (492) hide show
  1. package/.claude/agents/analysis/analyze-code-quality.md +178 -178
  2. package/.claude/agents/analysis/code-analyzer.md +209 -209
  3. package/.claude/agents/analysis/code-review/analyze-code-quality.md +178 -178
  4. package/.claude/agents/architecture/arch-system-design.md +156 -156
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +154 -154
  6. package/.claude/agents/browser/browser-agent.yaml +182 -182
  7. package/.claude/agents/consensus/byzantine-coordinator.md +62 -62
  8. package/.claude/agents/consensus/crdt-synchronizer.md +996 -996
  9. package/.claude/agents/consensus/gossip-coordinator.md +62 -62
  10. package/.claude/agents/consensus/performance-benchmarker.md +850 -850
  11. package/.claude/agents/consensus/quorum-manager.md +822 -822
  12. package/.claude/agents/consensus/raft-manager.md +62 -62
  13. package/.claude/agents/consensus/security-manager.md +621 -621
  14. package/.claude/agents/core/coder.md +452 -452
  15. package/.claude/agents/core/planner.md +374 -374
  16. package/.claude/agents/core/researcher.md +368 -368
  17. package/.claude/agents/core/reviewer.md +519 -519
  18. package/.claude/agents/core/tester.md +511 -511
  19. package/.claude/agents/custom/test-long-runner.md +44 -44
  20. package/.claude/agents/data/data-ml-model.md +444 -444
  21. package/.claude/agents/data/ml/data-ml-model.md +192 -192
  22. package/.claude/agents/development/backend/dev-backend-api.md +141 -141
  23. package/.claude/agents/development/dev-backend-api.md +344 -344
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +163 -163
  25. package/.claude/agents/devops/ops-cicd-github.md +164 -164
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +173 -173
  27. package/.claude/agents/documentation/docs-api-openapi.md +354 -354
  28. package/.claude/agents/flow-nexus/app-store.md +87 -87
  29. package/.claude/agents/flow-nexus/authentication.md +68 -68
  30. package/.claude/agents/flow-nexus/challenges.md +80 -80
  31. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  32. package/.claude/agents/flow-nexus/payments.md +82 -82
  33. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  34. package/.claude/agents/flow-nexus/swarm.md +75 -75
  35. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  36. package/.claude/agents/flow-nexus/workflow.md +83 -83
  37. package/.claude/agents/github/code-review-swarm.md +377 -377
  38. package/.claude/agents/github/github-modes.md +172 -172
  39. package/.claude/agents/github/issue-tracker.md +575 -575
  40. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  41. package/.claude/agents/github/pr-manager.md +437 -437
  42. package/.claude/agents/github/project-board-sync.md +508 -508
  43. package/.claude/agents/github/release-manager.md +604 -604
  44. package/.claude/agents/github/release-swarm.md +582 -582
  45. package/.claude/agents/github/repo-architect.md +397 -397
  46. package/.claude/agents/github/swarm-issue.md +572 -572
  47. package/.claude/agents/github/swarm-pr.md +427 -427
  48. package/.claude/agents/github/sync-coordinator.md +451 -451
  49. package/.claude/agents/github/workflow-automation.md +902 -902
  50. package/.claude/agents/goal/agent.md +815 -815
  51. package/.claude/agents/goal/goal-planner.md +72 -72
  52. package/.claude/agents/optimization/benchmark-suite.md +664 -664
  53. package/.claude/agents/optimization/load-balancer.md +430 -430
  54. package/.claude/agents/optimization/performance-monitor.md +671 -671
  55. package/.claude/agents/optimization/resource-allocator.md +673 -673
  56. package/.claude/agents/optimization/topology-optimizer.md +807 -807
  57. package/.claude/agents/payments/agentic-payments.md +126 -126
  58. package/.claude/agents/sona/sona-learning-optimizer.md +74 -74
  59. package/.claude/agents/sparc/architecture.md +698 -698
  60. package/.claude/agents/sparc/pseudocode.md +519 -519
  61. package/.claude/agents/sparc/refinement.md +801 -801
  62. package/.claude/agents/sparc/specification.md +477 -477
  63. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +224 -224
  64. package/.claude/agents/specialized/spec-mobile-react-native.md +226 -226
  65. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  66. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  67. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  68. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  69. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  70. package/.claude/agents/swarm/adaptive-coordinator.md +1126 -1126
  71. package/.claude/agents/swarm/hierarchical-coordinator.md +709 -709
  72. package/.claude/agents/swarm/mesh-coordinator.md +962 -962
  73. package/.claude/agents/templates/automation-smart-agent.md +204 -204
  74. package/.claude/agents/templates/base-template-generator.md +289 -289
  75. package/.claude/agents/templates/coordinator-swarm-init.md +89 -89
  76. package/.claude/agents/templates/github-pr-manager.md +176 -176
  77. package/.claude/agents/templates/implementer-sparc-coder.md +258 -258
  78. package/.claude/agents/templates/memory-coordinator.md +186 -186
  79. package/.claude/agents/templates/orchestrator-task.md +138 -138
  80. package/.claude/agents/templates/performance-analyzer.md +198 -198
  81. package/.claude/agents/templates/sparc-coordinator.md +513 -513
  82. package/.claude/agents/testing/production-validator.md +394 -394
  83. package/.claude/agents/testing/tdd-london-swarm.md +243 -243
  84. package/.claude/agents/v3/adr-architect.md +184 -184
  85. package/.claude/agents/v3/aidefence-guardian.md +282 -282
  86. package/.claude/agents/v3/claims-authorizer.md +208 -208
  87. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -993
  88. package/.claude/agents/v3/ddd-domain-expert.md +220 -220
  89. package/.claude/agents/v3/injection-analyst.md +236 -236
  90. package/.claude/agents/v3/memory-specialist.md +995 -995
  91. package/.claude/agents/v3/performance-engineer.md +1233 -1233
  92. package/.claude/agents/v3/pii-detector.md +151 -151
  93. package/.claude/agents/v3/reasoningbank-learner.md +213 -213
  94. package/.claude/agents/v3/security-architect-aidefence.md +410 -410
  95. package/.claude/agents/v3/security-architect.md +867 -867
  96. package/.claude/agents/v3/security-auditor.md +771 -771
  97. package/.claude/agents/v3/sparc-orchestrator.md +182 -182
  98. package/.claude/agents/v3/swarm-memory-manager.md +157 -157
  99. package/.claude/agents/v3/v3-integration-architect.md +205 -205
  100. package/.claude/commands/agents/README.md +50 -50
  101. package/.claude/commands/agents/agent-capabilities.md +140 -140
  102. package/.claude/commands/agents/agent-coordination.md +28 -28
  103. package/.claude/commands/agents/agent-spawning.md +28 -28
  104. package/.claude/commands/agents/agent-types.md +216 -216
  105. package/.claude/commands/agents/health.md +139 -139
  106. package/.claude/commands/agents/list.md +100 -100
  107. package/.claude/commands/agents/logs.md +130 -130
  108. package/.claude/commands/agents/metrics.md +122 -122
  109. package/.claude/commands/agents/pool.md +127 -127
  110. package/.claude/commands/agents/spawn.md +140 -140
  111. package/.claude/commands/agents/status.md +115 -115
  112. package/.claude/commands/agents/stop.md +102 -102
  113. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  114. package/.claude/commands/analysis/README.md +9 -9
  115. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  116. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  117. package/.claude/commands/analysis/performance-report.md +25 -25
  118. package/.claude/commands/analysis/token-efficiency.md +44 -44
  119. package/.claude/commands/analysis/token-usage.md +25 -25
  120. package/.claude/commands/automation/README.md +9 -9
  121. package/.claude/commands/automation/auto-agent.md +122 -122
  122. package/.claude/commands/automation/self-healing.md +105 -105
  123. package/.claude/commands/automation/session-memory.md +89 -89
  124. package/.claude/commands/automation/smart-agents.md +72 -72
  125. package/.claude/commands/automation/smart-spawn.md +25 -25
  126. package/.claude/commands/automation/workflow-select.md +25 -25
  127. package/.claude/commands/claude-flow-help.md +103 -103
  128. package/.claude/commands/claude-flow-memory.md +107 -107
  129. package/.claude/commands/claude-flow-swarm.md +205 -205
  130. package/.claude/commands/coordination/README.md +9 -9
  131. package/.claude/commands/coordination/agent-spawn.md +25 -25
  132. package/.claude/commands/coordination/init.md +44 -44
  133. package/.claude/commands/coordination/orchestrate.md +43 -43
  134. package/.claude/commands/coordination/spawn.md +45 -45
  135. package/.claude/commands/coordination/swarm-init.md +85 -85
  136. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  137. package/.claude/commands/flow-nexus/app-store.md +123 -123
  138. package/.claude/commands/flow-nexus/challenges.md +119 -119
  139. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  140. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  141. package/.claude/commands/flow-nexus/payments.md +115 -115
  142. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  143. package/.claude/commands/flow-nexus/swarm.md +86 -86
  144. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  145. package/.claude/commands/flow-nexus/workflow.md +114 -114
  146. package/.claude/commands/github/README.md +11 -11
  147. package/.claude/commands/github/code-review-swarm.md +513 -513
  148. package/.claude/commands/github/code-review.md +25 -25
  149. package/.claude/commands/github/github-modes.md +146 -146
  150. package/.claude/commands/github/github-swarm.md +121 -121
  151. package/.claude/commands/github/issue-tracker.md +291 -291
  152. package/.claude/commands/github/issue-triage.md +25 -25
  153. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  154. package/.claude/commands/github/pr-enhance.md +26 -26
  155. package/.claude/commands/github/pr-manager.md +169 -169
  156. package/.claude/commands/github/project-board-sync.md +470 -470
  157. package/.claude/commands/github/release-manager.md +337 -337
  158. package/.claude/commands/github/release-swarm.md +543 -543
  159. package/.claude/commands/github/repo-analyze.md +25 -25
  160. package/.claude/commands/github/repo-architect.md +366 -366
  161. package/.claude/commands/github/swarm-issue.md +481 -481
  162. package/.claude/commands/github/swarm-pr.md +284 -284
  163. package/.claude/commands/github/sync-coordinator.md +300 -300
  164. package/.claude/commands/github/workflow-automation.md +441 -441
  165. package/.claude/commands/hive-mind/README.md +17 -17
  166. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  167. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  168. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  173. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  177. package/.claude/commands/hooks/README.md +11 -11
  178. package/.claude/commands/hooks/overview.md +57 -57
  179. package/.claude/commands/hooks/post-edit.md +117 -117
  180. package/.claude/commands/hooks/post-task.md +112 -112
  181. package/.claude/commands/hooks/pre-edit.md +113 -113
  182. package/.claude/commands/hooks/pre-task.md +111 -111
  183. package/.claude/commands/hooks/session-end.md +118 -118
  184. package/.claude/commands/hooks/setup.md +102 -102
  185. package/.claude/commands/memory/README.md +9 -9
  186. package/.claude/commands/memory/memory-persist.md +25 -25
  187. package/.claude/commands/memory/memory-search.md +25 -25
  188. package/.claude/commands/memory/memory-usage.md +25 -25
  189. package/.claude/commands/memory/neural.md +47 -47
  190. package/.claude/commands/monitoring/README.md +9 -9
  191. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  192. package/.claude/commands/monitoring/agents.md +44 -44
  193. package/.claude/commands/monitoring/real-time-view.md +25 -25
  194. package/.claude/commands/monitoring/status.md +46 -46
  195. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  196. package/.claude/commands/optimization/README.md +9 -9
  197. package/.claude/commands/optimization/auto-topology.md +61 -61
  198. package/.claude/commands/optimization/cache-manage.md +25 -25
  199. package/.claude/commands/optimization/parallel-execute.md +25 -25
  200. package/.claude/commands/optimization/parallel-execution.md +49 -49
  201. package/.claude/commands/optimization/topology-optimize.md +25 -25
  202. package/.claude/commands/pair/README.md +260 -260
  203. package/.claude/commands/pair/commands.md +545 -545
  204. package/.claude/commands/pair/config.md +509 -509
  205. package/.claude/commands/pair/examples.md +511 -511
  206. package/.claude/commands/pair/modes.md +347 -347
  207. package/.claude/commands/pair/session.md +406 -406
  208. package/.claude/commands/pair/start.md +208 -208
  209. package/.claude/commands/sparc/analyzer.md +51 -51
  210. package/.claude/commands/sparc/architect.md +53 -53
  211. package/.claude/commands/sparc/ask.md +97 -97
  212. package/.claude/commands/sparc/batch-executor.md +54 -54
  213. package/.claude/commands/sparc/code.md +89 -89
  214. package/.claude/commands/sparc/coder.md +54 -54
  215. package/.claude/commands/sparc/debug.md +83 -83
  216. package/.claude/commands/sparc/debugger.md +54 -54
  217. package/.claude/commands/sparc/designer.md +53 -53
  218. package/.claude/commands/sparc/devops.md +109 -109
  219. package/.claude/commands/sparc/docs-writer.md +80 -80
  220. package/.claude/commands/sparc/documenter.md +54 -54
  221. package/.claude/commands/sparc/innovator.md +54 -54
  222. package/.claude/commands/sparc/integration.md +83 -83
  223. package/.claude/commands/sparc/mcp.md +117 -117
  224. package/.claude/commands/sparc/memory-manager.md +54 -54
  225. package/.claude/commands/sparc/optimizer.md +54 -54
  226. package/.claude/commands/sparc/orchestrator.md +131 -131
  227. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  228. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  229. package/.claude/commands/sparc/researcher.md +54 -54
  230. package/.claude/commands/sparc/reviewer.md +54 -54
  231. package/.claude/commands/sparc/security-review.md +80 -80
  232. package/.claude/commands/sparc/sparc-modes.md +174 -174
  233. package/.claude/commands/sparc/sparc.md +111 -111
  234. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  235. package/.claude/commands/sparc/supabase-admin.md +348 -348
  236. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  237. package/.claude/commands/sparc/tdd.md +54 -54
  238. package/.claude/commands/sparc/tester.md +54 -54
  239. package/.claude/commands/sparc/tutorial.md +79 -79
  240. package/.claude/commands/sparc/workflow-manager.md +54 -54
  241. package/.claude/commands/sparc.md +166 -166
  242. package/.claude/commands/stream-chain/pipeline.md +120 -120
  243. package/.claude/commands/stream-chain/run.md +69 -69
  244. package/.claude/commands/swarm/README.md +15 -15
  245. package/.claude/commands/swarm/analysis.md +95 -95
  246. package/.claude/commands/swarm/development.md +96 -96
  247. package/.claude/commands/swarm/examples.md +168 -168
  248. package/.claude/commands/swarm/maintenance.md +102 -102
  249. package/.claude/commands/swarm/optimization.md +117 -117
  250. package/.claude/commands/swarm/research.md +136 -136
  251. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  252. package/.claude/commands/swarm/swarm-background.md +8 -8
  253. package/.claude/commands/swarm/swarm-init.md +19 -19
  254. package/.claude/commands/swarm/swarm-modes.md +8 -8
  255. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  256. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  257. package/.claude/commands/swarm/swarm-status.md +8 -8
  258. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  259. package/.claude/commands/swarm/swarm.md +87 -87
  260. package/.claude/commands/swarm/testing.md +131 -131
  261. package/.claude/commands/training/README.md +9 -9
  262. package/.claude/commands/training/model-update.md +25 -25
  263. package/.claude/commands/training/neural-patterns.md +107 -107
  264. package/.claude/commands/training/neural-train.md +75 -75
  265. package/.claude/commands/training/pattern-learn.md +25 -25
  266. package/.claude/commands/training/specialization.md +62 -62
  267. package/.claude/commands/truth/start.md +142 -142
  268. package/.claude/commands/verify/check.md +49 -49
  269. package/.claude/commands/verify/start.md +127 -127
  270. package/.claude/commands/workflows/README.md +9 -9
  271. package/.claude/commands/workflows/development.md +77 -77
  272. package/.claude/commands/workflows/research.md +62 -62
  273. package/.claude/commands/workflows/workflow-create.md +25 -25
  274. package/.claude/commands/workflows/workflow-execute.md +25 -25
  275. package/.claude/commands/workflows/workflow-export.md +25 -25
  276. package/.claude/helpers/README.md +96 -96
  277. package/.claude/helpers/adr-compliance.sh +186 -186
  278. package/.claude/helpers/auto-commit.sh +178 -178
  279. package/.claude/helpers/auto-memory-hook.mjs +368 -368
  280. package/.claude/helpers/checkpoint-manager.sh +251 -251
  281. package/.claude/helpers/daemon-manager.sh +252 -252
  282. package/.claude/helpers/ddd-tracker.sh +144 -144
  283. package/.claude/helpers/github-safe.js +121 -121
  284. package/.claude/helpers/github-setup.sh +28 -28
  285. package/.claude/helpers/guidance-hook.sh +13 -13
  286. package/.claude/helpers/guidance-hooks.sh +102 -102
  287. package/.claude/helpers/health-monitor.sh +108 -108
  288. package/.claude/helpers/hook-handler.cjs +278 -278
  289. package/.claude/helpers/intelligence.cjs +1031 -1031
  290. package/.claude/helpers/learning-hooks.sh +329 -329
  291. package/.claude/helpers/learning-optimizer.sh +127 -127
  292. package/.claude/helpers/learning-service.mjs +1144 -1144
  293. package/.claude/helpers/memory.js +83 -83
  294. package/.claude/helpers/metrics-db.mjs +488 -488
  295. package/.claude/helpers/pattern-consolidator.sh +86 -86
  296. package/.claude/helpers/perf-worker.sh +160 -160
  297. package/.claude/helpers/post-commit +16 -16
  298. package/.claude/helpers/pre-commit +26 -26
  299. package/.claude/helpers/quick-start.sh +19 -19
  300. package/.claude/helpers/router.js +66 -66
  301. package/.claude/helpers/security-scanner.sh +127 -127
  302. package/.claude/helpers/session.js +135 -135
  303. package/.claude/helpers/setup-mcp.sh +18 -18
  304. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  305. package/.claude/helpers/statusline-hook.sh +21 -21
  306. package/.claude/helpers/statusline.cjs +575 -575
  307. package/.claude/helpers/statusline.js +321 -321
  308. package/.claude/helpers/swarm-comms.sh +353 -353
  309. package/.claude/helpers/swarm-hooks.sh +761 -761
  310. package/.claude/helpers/swarm-monitor.sh +210 -210
  311. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  312. package/.claude/helpers/update-v3-progress.sh +165 -165
  313. package/.claude/helpers/v3-quick-status.sh +57 -57
  314. package/.claude/helpers/v3.sh +110 -110
  315. package/.claude/helpers/validate-v3-config.sh +215 -215
  316. package/.claude/helpers/worker-manager.sh +170 -170
  317. package/.claude/settings.json +182 -182
  318. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  319. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  320. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  321. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  322. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  323. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  324. package/.claude/skills/aidefence-scan.md +151 -151
  325. package/.claude/skills/aidefence.yaml +297 -297
  326. package/.claude/skills/browser/SKILL.md +204 -204
  327. package/.claude/skills/flow-nexus-neural/SKILL.md +738 -738
  328. package/.claude/skills/flow-nexus-platform/SKILL.md +1157 -1157
  329. package/.claude/skills/flow-nexus-swarm/SKILL.md +610 -610
  330. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  331. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  332. package/.claude/skills/github-project-management/SKILL.md +1290 -1277
  333. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  334. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  335. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  336. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  337. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  338. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  339. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  340. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  341. package/.claude/skills/secure-review.md +181 -181
  342. package/.claude/skills/skill-builder/SKILL.md +910 -910
  343. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  344. package/.claude/skills/stream-chain/SKILL.md +563 -563
  345. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  346. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  347. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  348. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  349. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  350. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  351. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  352. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  353. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  354. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  355. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  356. package/.claude/skills/verification-quality/SKILL.md +649 -649
  357. package/.claude/skills/worker-benchmarks/skill.md +135 -135
  358. package/.claude/skills/worker-integration/skill.md +154 -154
  359. package/README.md +393 -391
  360. package/bin/cli.js +220 -220
  361. package/bin/mcp-server.js +224 -224
  362. package/bin/preinstall.cjs +2 -2
  363. package/dist/src/commands/agent-wasm.js +2 -2
  364. package/dist/src/commands/agent-wasm.js.map +1 -1
  365. package/dist/src/commands/completions.js +409 -409
  366. package/dist/src/commands/daemon.d.ts.map +1 -1
  367. package/dist/src/commands/daemon.js +19 -3
  368. package/dist/src/commands/daemon.js.map +1 -1
  369. package/dist/src/commands/doctor.d.ts.map +1 -1
  370. package/dist/src/commands/doctor.js +105 -23
  371. package/dist/src/commands/doctor.js.map +1 -1
  372. package/dist/src/commands/embeddings.js +26 -26
  373. package/dist/src/commands/hive-mind.d.ts.map +1 -1
  374. package/dist/src/commands/hive-mind.js +122 -104
  375. package/dist/src/commands/hive-mind.js.map +1 -1
  376. package/dist/src/commands/hooks.d.ts.map +1 -1
  377. package/dist/src/commands/hooks.js +34 -21
  378. package/dist/src/commands/hooks.js.map +1 -1
  379. package/dist/src/commands/memory.d.ts.map +1 -1
  380. package/dist/src/commands/memory.js +68 -0
  381. package/dist/src/commands/memory.js.map +1 -1
  382. package/dist/src/commands/ruvector/backup.js +23 -23
  383. package/dist/src/commands/ruvector/benchmark.js +31 -31
  384. package/dist/src/commands/ruvector/import.js +14 -14
  385. package/dist/src/commands/ruvector/init.js +115 -115
  386. package/dist/src/commands/ruvector/migrate.js +99 -99
  387. package/dist/src/commands/ruvector/optimize.js +51 -51
  388. package/dist/src/commands/ruvector/setup.js +624 -624
  389. package/dist/src/commands/ruvector/status.js +38 -38
  390. package/dist/src/index.d.ts +5 -1
  391. package/dist/src/index.d.ts.map +1 -1
  392. package/dist/src/index.js +59 -18
  393. package/dist/src/index.js.map +1 -1
  394. package/dist/src/init/claudemd-generator.js +226 -226
  395. package/dist/src/init/executor.d.ts.map +1 -1
  396. package/dist/src/init/executor.js +511 -453
  397. package/dist/src/init/executor.js.map +1 -1
  398. package/dist/src/init/helpers-generator.js +645 -645
  399. package/dist/src/init/settings-generator.d.ts.map +1 -1
  400. package/dist/src/init/settings-generator.js +11 -5
  401. package/dist/src/init/settings-generator.js.map +1 -1
  402. package/dist/src/init/statusline-generator.js +858 -858
  403. package/dist/src/init/types.d.ts +7 -0
  404. package/dist/src/init/types.d.ts.map +1 -1
  405. package/dist/src/init/types.js.map +1 -1
  406. package/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  407. package/dist/src/mcp-tools/agentdb-tools.d.ts.map +1 -1
  408. package/dist/src/mcp-tools/agentdb-tools.js +108 -0
  409. package/dist/src/mcp-tools/agentdb-tools.js.map +1 -1
  410. package/dist/src/mcp-tools/hooks-tools.d.ts.map +1 -1
  411. package/dist/src/mcp-tools/hooks-tools.js +4 -2
  412. package/dist/src/mcp-tools/hooks-tools.js.map +1 -1
  413. package/dist/src/mcp-tools/memory-tools.d.ts.map +1 -1
  414. package/dist/src/mcp-tools/memory-tools.js +19 -0
  415. package/dist/src/mcp-tools/memory-tools.js.map +1 -1
  416. package/dist/src/mcp-tools/neural-tools.d.ts.map +1 -1
  417. package/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/dist/src/mcp-tools/neural-tools.js.map +1 -1
  419. package/dist/src/mcp-tools/security-tools.d.ts.map +1 -1
  420. package/dist/src/mcp-tools/security-tools.js +28 -3
  421. package/dist/src/mcp-tools/security-tools.js.map +1 -1
  422. package/dist/src/mcp-tools/swarm-tools.d.ts.map +1 -1
  423. package/dist/src/mcp-tools/swarm-tools.js +72 -3
  424. package/dist/src/mcp-tools/swarm-tools.js.map +1 -1
  425. package/dist/src/mcp-tools/types.d.ts +4 -33
  426. package/dist/src/mcp-tools/types.d.ts.map +1 -1
  427. package/dist/src/mcp-tools/types.js +4 -14
  428. package/dist/src/mcp-tools/types.js.map +1 -1
  429. package/dist/src/mcp-tools/validate-input.d.ts +5 -57
  430. package/dist/src/mcp-tools/validate-input.d.ts.map +1 -1
  431. package/dist/src/mcp-tools/validate-input.js +5 -233
  432. package/dist/src/mcp-tools/validate-input.js.map +1 -1
  433. package/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  434. package/dist/src/mcp-tools/wasm-agent-tools.js.map +1 -1
  435. package/dist/src/memory/intelligence.d.ts.map +1 -1
  436. package/dist/src/memory/intelligence.js +28 -3
  437. package/dist/src/memory/intelligence.js.map +1 -1
  438. package/dist/src/memory/memory-bridge.d.ts +69 -0
  439. package/dist/src/memory/memory-bridge.d.ts.map +1 -1
  440. package/dist/src/memory/memory-bridge.js +319 -66
  441. package/dist/src/memory/memory-bridge.js.map +1 -1
  442. package/dist/src/memory/memory-initializer.d.ts +5 -0
  443. package/dist/src/memory/memory-initializer.d.ts.map +1 -1
  444. package/dist/src/memory/memory-initializer.js +369 -363
  445. package/dist/src/memory/memory-initializer.js.map +1 -1
  446. package/dist/src/memory/neural-package-bridge.d.ts +48 -0
  447. package/dist/src/memory/neural-package-bridge.d.ts.map +1 -0
  448. package/dist/src/memory/neural-package-bridge.js +87 -0
  449. package/dist/src/memory/neural-package-bridge.js.map +1 -0
  450. package/dist/src/memory/rabitq-index.js +5 -5
  451. package/dist/src/memory/sona-optimizer.d.ts.map +1 -1
  452. package/dist/src/memory/sona-optimizer.js +1 -0
  453. package/dist/src/memory/sona-optimizer.js.map +1 -1
  454. package/dist/src/output.d.ts +6 -130
  455. package/dist/src/output.d.ts.map +1 -1
  456. package/dist/src/output.js +6 -511
  457. package/dist/src/output.js.map +1 -1
  458. package/dist/src/parser.d.ts +9 -0
  459. package/dist/src/parser.d.ts.map +1 -1
  460. package/dist/src/parser.js +11 -0
  461. package/dist/src/parser.js.map +1 -1
  462. package/dist/src/runtime/headless.js +28 -28
  463. package/dist/src/ruvector/agent-wasm.d.ts.map +1 -1
  464. package/dist/src/ruvector/agent-wasm.js +4 -1
  465. package/dist/src/ruvector/agent-wasm.js.map +1 -1
  466. package/dist/src/ruvector/index.d.ts +0 -2
  467. package/dist/src/ruvector/index.d.ts.map +1 -1
  468. package/dist/src/ruvector/index.js +8 -2
  469. package/dist/src/ruvector/index.js.map +1 -1
  470. package/dist/src/ruvector/model-router.d.ts +22 -1
  471. package/dist/src/ruvector/model-router.d.ts.map +1 -1
  472. package/dist/src/ruvector/model-router.js +125 -5
  473. package/dist/src/ruvector/model-router.js.map +1 -1
  474. package/dist/src/services/headless-worker-executor.js +84 -84
  475. package/dist/src/transfer/deploy-seraphine.js +23 -23
  476. package/dist/src/types.d.ts +10 -195
  477. package/dist/src/types.d.ts.map +1 -1
  478. package/dist/src/types.js +10 -35
  479. package/dist/src/types.js.map +1 -1
  480. package/dist/tsconfig.tsbuildinfo +1 -1
  481. package/package.json +6 -4
  482. package/scripts/deploy-ipfs-node.sh +153 -153
  483. package/scripts/postinstall.cjs +153 -153
  484. package/scripts/publish-registry.ts +345 -345
  485. package/scripts/publish.sh +57 -57
  486. package/scripts/setup-ipfs-registry.md +366 -366
  487. package/dist/src/services/event-stream.d.ts.map +0 -1
  488. package/dist/src/services/event-stream.js.map +0 -1
  489. package/dist/src/services/loop-worker-runner.d.ts.map +0 -1
  490. package/dist/src/services/loop-worker-runner.js.map +0 -1
  491. package/dist/src/services/runtime-capabilities.d.ts.map +0 -1
  492. package/dist/src/services/runtime-capabilities.js.map +0 -1
@@ -1,874 +1,874 @@
1
- ---
2
- name: github-multi-repo
3
- version: 1.0.0
4
- description: Multi-repository coordination, synchronization, and architecture management with AI swarm orchestration
5
- category: github-integration
6
- tags: [multi-repo, synchronization, architecture, coordination, github]
7
- author: Claude Flow Team
8
- requires:
9
- - ruv-swarm@^1.0.11
10
- - gh-cli@^2.0.0
11
- capabilities:
12
- - cross-repository coordination
13
- - package synchronization
14
- - architecture optimization
15
- - template management
16
- - distributed workflows
17
- ---
18
-
19
- # GitHub Multi-Repository Coordination Skill
20
-
21
- ## Overview
22
-
23
- Advanced multi-repository coordination system that combines swarm intelligence, package synchronization, and repository architecture optimization. This skill enables organization-wide automation, cross-project collaboration, and scalable repository management.
24
-
25
- ## Core Capabilities
26
-
27
- ### 🔄 Multi-Repository Swarm Coordination
28
- Cross-repository AI swarm orchestration for distributed development workflows.
29
-
30
- ### 📦 Package Synchronization
31
- Intelligent dependency resolution and version alignment across multiple packages.
32
-
33
- ### 🏗️ Repository Architecture
34
- Structure optimization and template management for scalable projects.
35
-
36
- ### 🔗 Integration Management
37
- Cross-package integration testing and deployment coordination.
38
-
39
- ## Quick Start
40
-
41
- ### Initialize Multi-Repo Coordination
42
- ```bash
43
- # Basic swarm initialization
44
- npx claude-flow skill run github-multi-repo init \
45
- --repos "org/frontend,org/backend,org/shared" \
46
- --topology hierarchical
47
-
48
- # Advanced initialization with synchronization
49
- npx claude-flow skill run github-multi-repo init \
50
- --repos "org/frontend,org/backend,org/shared" \
51
- --topology mesh \
52
- --shared-memory \
53
- --sync-strategy eventual
54
- ```
55
-
56
- ### Synchronize Packages
57
- ```bash
58
- # Synchronize package versions and dependencies
59
- npx claude-flow skill run github-multi-repo sync \
60
- --packages "claude-code-flow,ruv-swarm" \
61
- --align-versions \
62
- --update-docs
63
- ```
64
-
65
- ### Optimize Architecture
66
- ```bash
67
- # Analyze and optimize repository structure
68
- npx claude-flow skill run github-multi-repo optimize \
69
- --analyze-structure \
70
- --suggest-improvements \
71
- --create-templates
72
- ```
73
-
74
- ## Features
75
-
76
- ### 1. Cross-Repository Swarm Orchestration
77
-
78
- #### Repository Discovery
79
- ```javascript
80
- // Auto-discover related repositories with gh CLI
81
- const REPOS = Bash(`gh repo list my-organization --limit 100 \
82
- --json name,description,languages,topics \
83
- --jq '.[] | select(.languages | keys | contains(["TypeScript"]))'`)
84
-
85
- // Analyze repository dependencies
86
- const DEPS = Bash(`gh repo list my-organization --json name | \
87
- jq -r '.[].name' | while read -r repo; do
88
- gh api repos/my-organization/$repo/contents/package.json \
89
- --jq '.content' 2>/dev/null | base64 -d | jq '{name, dependencies}'
90
- done | jq -s '.'`)
91
-
92
- // Initialize swarm with discovered repositories
93
- mcp__claude-flow__swarm_init({
94
- topology: "hierarchical",
95
- maxAgents: 8,
96
- metadata: { repos: REPOS, dependencies: DEPS }
97
- })
98
- ```
99
-
100
- #### Synchronized Operations
101
- ```javascript
102
- // Execute synchronized changes across repositories
103
- [Parallel Multi-Repo Operations]:
104
- // Spawn coordination agents
105
- Task("Repository Coordinator", "Coordinate changes across all repositories", "coordinator")
106
- Task("Dependency Analyzer", "Analyze cross-repo dependencies", "analyst")
107
- Task("Integration Tester", "Validate cross-repo changes", "tester")
108
-
109
- // Get matching repositories
110
- Bash(`gh repo list org --limit 100 --json name \
111
- --jq '.[] | select(.name | test("-service$")) | .name' > /tmp/repos.txt`)
112
-
113
- // Execute task across repositories
114
- Bash(`cat /tmp/repos.txt | while read -r repo; do
115
- gh repo clone org/$repo /tmp/$repo -- --depth=1
116
- cd /tmp/$repo
117
-
118
- # Apply changes
119
- npm update
120
- npm test
121
-
122
- # Create PR if successful
123
- if [ $? -eq 0 ]; then
124
- git checkout -b update-dependencies-$(date +%Y%m%d)
125
- git add -A
126
- git commit -m "chore: Update dependencies"
127
- git push origin HEAD
128
- gh pr create --title "Update dependencies" --body "Automated update" --label "dependencies"
129
- fi
130
- done`)
131
-
132
- // Track all operations
133
- TodoWrite { todos: [
134
- { id: "discover", content: "Discover all service repositories", status: "completed" },
135
- { id: "update", content: "Update dependencies", status: "completed" },
136
- { id: "test", content: "Run integration tests", status: "in_progress" },
137
- { id: "pr", content: "Create pull requests", status: "pending" }
138
- ]}
139
- ```
140
-
141
- ### 2. Package Synchronization
142
-
143
- #### Version Alignment
144
- ```javascript
145
- // Synchronize package dependencies and versions
146
- [Complete Package Sync]:
147
- // Initialize sync swarm
148
- mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 5 })
149
-
150
- // Spawn sync agents
151
- Task("Sync Coordinator", "Coordinate version alignment", "coordinator")
152
- Task("Dependency Analyzer", "Analyze dependencies", "analyst")
153
- Task("Integration Tester", "Validate synchronization", "tester")
154
-
155
- // Read package states
156
- Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
157
- Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
158
-
159
- // Align versions using gh CLI
160
- Bash(`gh api repos/:owner/:repo/git/refs \
161
- -f ref='refs/heads/sync/package-alignment' \
162
- -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')`)
163
-
164
- // Update package.json files
165
- Bash(`gh api repos/:owner/:repo/contents/package.json \
166
- --method PUT \
167
- -f message="feat: Align Node.js version requirements" \
168
- -f branch="sync/package-alignment" \
169
- -f content="$(cat aligned-package.json | base64)"`)
170
-
171
- // Store sync state
172
- mcp__claude-flow__memory_usage({
173
- action: "store",
174
- key: "sync/packages/status",
175
- value: {
176
- timestamp: Date.now(),
177
- packages_synced: ["claude-code-flow", "ruv-swarm"],
178
- status: "synchronized"
179
- }
180
- })
181
- ```
182
-
183
- #### Documentation Synchronization
184
- ```javascript
185
- // Synchronize CLAUDE.md files across packages
186
- [Documentation Sync]:
187
- // Get source documentation
188
- Bash(`gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md \
189
- --jq '.content' | base64 -d > /tmp/claude-source.md`)
190
-
191
- // Update target documentation
192
- Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/CLAUDE.md \
193
- --method PUT \
194
- -f message="docs: Synchronize CLAUDE.md" \
195
- -f branch="sync/documentation" \
196
- -f content="$(cat /tmp/claude-source.md | base64)"`)
197
-
198
- // Track sync status
199
- mcp__claude-flow__memory_usage({
200
- action: "store",
201
- key: "sync/documentation/status",
202
- value: { status: "synchronized", files: ["CLAUDE.md"] }
203
- })
204
- ```
205
-
206
- #### Cross-Package Integration
207
- ```javascript
208
- // Coordinate feature implementation across packages
209
- [Cross-Package Feature]:
210
- // Push changes to all packages
211
- mcp__github__push_files({
212
- branch: "feature/github-integration",
213
- files: [
214
- {
215
- path: "claude-code-flow/.claude/commands/github/github-modes.md",
216
- content: "[GitHub modes documentation]"
217
- },
218
- {
219
- path: "ruv-swarm/src/github-coordinator/hooks.js",
220
- content: "[GitHub coordination hooks]"
221
- }
222
- ],
223
- message: "feat: Add GitHub workflow integration"
224
- })
225
-
226
- // Create coordinated PR
227
- Bash(`gh pr create \
228
- --title "Feature: GitHub Workflow Integration" \
229
- --body "## 🚀 GitHub Integration
230
-
231
- ### Features
232
- - ✅ Multi-repo coordination
233
- - ✅ Package synchronization
234
- - ✅ Architecture optimization
235
-
236
- ### Testing
237
- - [x] Package dependency verification
238
- - [x] Integration tests
239
- - [x] Cross-package compatibility"`)
240
- ```
241
-
242
- ### 3. Repository Architecture
243
-
244
- #### Structure Analysis
245
- ```javascript
246
- // Analyze and optimize repository structure
247
- [Architecture Analysis]:
248
- // Initialize architecture swarm
249
- mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 6 })
250
-
251
- // Spawn architecture agents
252
- Task("Senior Architect", "Analyze repository structure", "architect")
253
- Task("Structure Analyst", "Identify optimization opportunities", "analyst")
254
- Task("Performance Optimizer", "Optimize structure for scalability", "optimizer")
255
- Task("Best Practices Researcher", "Research architecture patterns", "researcher")
256
-
257
- // Analyze current structures
258
- LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
259
- LS("/workspaces/ruv-FANN/ruv-swarm/npm")
260
-
261
- // Search for best practices
262
- Bash(`gh search repos "language:javascript template architecture" \
263
- --limit 10 \
264
- --json fullName,description,stargazersCount \
265
- --sort stars \
266
- --order desc`)
267
-
268
- // Store analysis results
269
- mcp__claude-flow__memory_usage({
270
- action: "store",
271
- key: "architecture/analysis/results",
272
- value: {
273
- repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
274
- optimization_areas: ["structure", "workflows", "templates"],
275
- recommendations: ["standardize_structure", "improve_workflows"]
276
- }
277
- })
278
- ```
279
-
280
- #### Template Creation
281
- ```javascript
282
- // Create standardized repository template
283
- [Template Creation]:
284
- // Create template repository
285
- mcp__github__create_repository({
286
- name: "claude-project-template",
287
- description: "Standardized template for Claude Code projects",
288
- private: false,
289
- autoInit: true
290
- })
291
-
292
- // Push template structure
293
- mcp__github__push_files({
294
- repo: "claude-project-template",
295
- files: [
296
- {
297
- path: ".claude/commands/github/github-modes.md",
298
- content: "[GitHub modes template]"
299
- },
300
- {
301
- path: ".claude/config.json",
302
- content: JSON.stringify({
303
- version: "1.0",
304
- mcp_servers: {
305
- "ruv-swarm": {
306
- command: "npx",
307
- args: ["ruv-swarm", "mcp", "start"]
308
- }
309
- }
310
- })
311
- },
312
- {
313
- path: "CLAUDE.md",
314
- content: "[Standardized CLAUDE.md]"
315
- },
316
- {
317
- path: "package.json",
318
- content: JSON.stringify({
319
- name: "claude-project-template",
320
- engines: { node: ">=20.0.0" },
321
- dependencies: { "ruv-swarm": "^1.0.11" }
322
- })
323
- }
324
- ],
325
- message: "feat: Create standardized template"
326
- })
327
- ```
328
-
329
- #### Cross-Repository Standardization
330
- ```javascript
331
- // Synchronize structure across repositories
332
- [Structure Standardization]:
333
- const repositories = ["claude-code-flow", "ruv-swarm", "claude-extensions"]
334
-
335
- // Update common files across all repositories
336
- repositories.forEach(repo => {
337
- mcp__github__create_or_update_file({
338
- repo: "ruv-FANN",
339
- path: `${repo}/.github/workflows/integration.yml`,
340
- content: `name: Integration Tests
341
- on: [push, pull_request]
342
- jobs:
343
- test:
344
- runs-on: ubuntu-latest
345
- steps:
346
- - uses: actions/checkout@v3
347
- - uses: actions/setup-node@v3
348
- with: { node-version: '20' }
349
- - run: npm install && npm test`,
350
- message: "ci: Standardize integration workflow",
351
- branch: "structure/standardization"
352
- })
353
- })
354
- ```
355
-
356
- ### 4. Orchestration Workflows
357
-
358
- #### Dependency Management
359
- ```javascript
360
- // Update dependencies across all repositories
361
- [Organization-Wide Dependency Update]:
362
- // Create tracking issue
363
- TRACKING_ISSUE=$(Bash(`gh issue create \
364
- --title "Dependency Update: typescript@5.0.0" \
365
- --body "Tracking TypeScript update across all repositories" \
366
- --label "dependencies,tracking" \
367
- --json number -q .number`))
368
-
369
- // Find all TypeScript repositories
370
- TS_REPOS=$(Bash(`gh repo list org --limit 100 --json name | \
371
- jq -r '.[].name' | while read -r repo; do
372
- if gh api repos/org/$repo/contents/package.json 2>/dev/null | \
373
- jq -r '.content' | base64 -d | grep -q '"typescript"'; then
374
- echo "$repo"
375
- fi
376
- done`))
377
-
378
- // Update each repository
379
- Bash(`echo "$TS_REPOS" | while read -r repo; do
380
- gh repo clone org/$repo /tmp/$repo -- --depth=1
381
- cd /tmp/$repo
382
-
383
- npm install --save-dev typescript@5.0.0
384
-
385
- if npm test; then
386
- git checkout -b update-typescript-5
387
- git add package.json package-lock.json
388
- git commit -m "chore: Update TypeScript to 5.0.0
389
-
390
- Part of #$TRACKING_ISSUE"
391
-
392
- git push origin HEAD
393
- gh pr create \
394
- --title "Update TypeScript to 5.0.0" \
395
- --body "Updates TypeScript\n\nTracking: #$TRACKING_ISSUE" \
396
- --label "dependencies"
397
- else
398
- gh issue comment $TRACKING_ISSUE \
399
- --body "❌ Failed to update $repo - tests failing"
400
- fi
401
- done`)
402
- ```
403
-
404
- #### Refactoring Operations
405
- ```javascript
406
- // Coordinate large-scale refactoring
407
- [Cross-Repo Refactoring]:
408
- // Initialize refactoring swarm
409
- mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 8 })
410
-
411
- // Spawn specialized agents
412
- Task("Refactoring Coordinator", "Coordinate refactoring across repos", "coordinator")
413
- Task("Impact Analyzer", "Analyze refactoring impact", "analyst")
414
- Task("Code Transformer", "Apply refactoring changes", "coder")
415
- Task("Migration Guide Creator", "Create migration documentation", "documenter")
416
- Task("Integration Tester", "Validate refactored code", "tester")
417
-
418
- // Execute refactoring
419
- mcp__claude-flow__task_orchestrate({
420
- task: "Rename OldAPI to NewAPI across all repositories",
421
- strategy: "sequential",
422
- priority: "high"
423
- })
424
- ```
425
-
426
- #### Security Updates
427
- ```javascript
428
- // Coordinate security patches
429
- [Security Patch Deployment]:
430
- // Scan all repositories
431
- Bash(`gh repo list org --limit 100 --json name | jq -r '.[].name' | \
432
- while read -r repo; do
433
- gh repo clone org/$repo /tmp/$repo -- --depth=1
434
- cd /tmp/$repo
435
- npm audit --json > /tmp/audit-$repo.json
436
- done`)
437
-
438
- // Apply patches
439
- Bash(`for repo in /tmp/audit-*.json; do
440
- if [ $(jq '.vulnerabilities | length' $repo) -gt 0 ]; then
441
- cd /tmp/$(basename $repo .json | sed 's/audit-//')
442
- npm audit fix
443
-
444
- if npm test; then
445
- git checkout -b security/patch-$(date +%Y%m%d)
446
- git add -A
447
- git commit -m "security: Apply security patches"
448
- git push origin HEAD
449
- gh pr create --title "Security patches" --label "security"
450
- fi
451
- fi
452
- done`)
453
- ```
454
-
455
- ## Configuration
456
-
457
- ### Multi-Repo Config File
458
- ```yaml
459
- # .swarm/multi-repo.yml
460
- version: 1
461
- organization: my-org
462
-
463
- repositories:
464
- - name: frontend
465
- url: github.com/my-org/frontend
466
- role: ui
467
- agents: [coder, designer, tester]
468
-
469
- - name: backend
470
- url: github.com/my-org/backend
471
- role: api
472
- agents: [architect, coder, tester]
473
-
474
- - name: shared
475
- url: github.com/my-org/shared
476
- role: library
477
- agents: [analyst, coder]
478
-
479
- coordination:
480
- topology: hierarchical
481
- communication: webhook
482
- memory: redis://shared-memory
483
-
484
- dependencies:
485
- - from: frontend
486
- to: [backend, shared]
487
- - from: backend
488
- to: [shared]
489
- ```
490
-
491
- ### Repository Roles
492
- ```javascript
493
- {
494
- "roles": {
495
- "ui": {
496
- "responsibilities": ["user-interface", "ux", "accessibility"],
497
- "default-agents": ["designer", "coder", "tester"]
498
- },
499
- "api": {
500
- "responsibilities": ["endpoints", "business-logic", "data"],
501
- "default-agents": ["architect", "coder", "security"]
502
- },
503
- "library": {
504
- "responsibilities": ["shared-code", "utilities", "types"],
505
- "default-agents": ["analyst", "coder", "documenter"]
506
- }
507
- }
508
- }
509
- ```
510
-
511
- ## Communication Strategies
512
-
513
- ### 1. Webhook-Based Coordination
514
- ```javascript
515
- const { MultiRepoSwarm } = require('ruv-swarm');
516
-
517
- const swarm = new MultiRepoSwarm({
518
- webhook: {
519
- url: 'https://swarm-coordinator.example.com',
520
- secret: process.env.WEBHOOK_SECRET
521
- }
522
- });
523
-
524
- swarm.on('repo:update', async (event) => {
525
- await swarm.propagate(event, {
526
- to: event.dependencies,
527
- strategy: 'eventual-consistency'
528
- });
529
- });
530
- ```
531
-
532
- ### 2. Event Streaming
533
- ```yaml
534
- # Kafka configuration for real-time coordination
535
- kafka:
536
- brokers: ['kafka1:9092', 'kafka2:9092']
537
- topics:
538
- swarm-events:
539
- partitions: 10
540
- replication: 3
541
- swarm-memory:
542
- partitions: 5
543
- replication: 3
544
- ```
545
-
546
- ## Synchronization Patterns
547
-
548
- ### 1. Eventually Consistent
549
- ```javascript
550
- {
551
- "sync": {
552
- "strategy": "eventual",
553
- "max-lag": "5m",
554
- "retry": {
555
- "attempts": 3,
556
- "backoff": "exponential"
557
- }
558
- }
559
- }
560
- ```
561
-
562
- ### 2. Strong Consistency
563
- ```javascript
564
- {
565
- "sync": {
566
- "strategy": "strong",
567
- "consensus": "raft",
568
- "quorum": 0.51,
569
- "timeout": "30s"
570
- }
571
- }
572
- ```
573
-
574
- ### 3. Hybrid Approach
575
- ```javascript
576
- {
577
- "sync": {
578
- "default": "eventual",
579
- "overrides": {
580
- "security-updates": "strong",
581
- "dependency-updates": "strong",
582
- "documentation": "eventual"
583
- }
584
- }
585
- }
586
- ```
587
-
588
- ## Use Cases
589
-
590
- ### 1. Microservices Coordination
591
- ```bash
592
- npx claude-flow skill run github-multi-repo microservices \
593
- --services "auth,users,orders,payments" \
594
- --ensure-compatibility \
595
- --sync-contracts \
596
- --integration-tests
597
- ```
598
-
599
- ### 2. Library Updates
600
- ```bash
601
- npx claude-flow skill run github-multi-repo lib-update \
602
- --library "org/shared-lib" \
603
- --version "2.0.0" \
604
- --find-consumers \
605
- --update-imports \
606
- --run-tests
607
- ```
608
-
609
- ### 3. Organization-Wide Changes
610
- ```bash
611
- npx claude-flow skill run github-multi-repo org-policy \
612
- --policy "add-security-headers" \
613
- --repos "org/*" \
614
- --validate-compliance \
615
- --create-reports
616
- ```
617
-
618
- ## Architecture Patterns
619
-
620
- ### Monorepo Structure
621
- ```
622
- ruv-FANN/
623
- ├── packages/
624
- │ ├── claude-code-flow/
625
- │ │ ├── src/
626
- │ │ ├── .claude/
627
- │ │ └── package.json
628
- │ ├── ruv-swarm/
629
- │ │ ├── src/
630
- │ │ ├── wasm/
631
- │ │ └── package.json
632
- │ └── shared/
633
- │ ├── types/
634
- │ ├── utils/
635
- │ └── config/
636
- ├── tools/
637
- │ ├── build/
638
- │ ├── test/
639
- │ └── deploy/
640
- ├── docs/
641
- │ ├── architecture/
642
- │ ├── integration/
643
- │ └── examples/
644
- └── .github/
645
- ├── workflows/
646
- ├── templates/
647
- └── actions/
648
- ```
649
-
650
- ### Command Structure
651
- ```
652
- .claude/
653
- ├── commands/
654
- │ ├── github/
655
- │ │ ├── github-modes.md
656
- │ │ ├── pr-manager.md
657
- │ │ ├── issue-tracker.md
658
- │ │ └── sync-coordinator.md
659
- │ ├── sparc/
660
- │ │ ├── sparc-modes.md
661
- │ │ ├── coder.md
662
- │ │ └── tester.md
663
- │ └── swarm/
664
- │ ├── coordination.md
665
- │ └── orchestration.md
666
- ├── templates/
667
- │ ├── issue.md
668
- │ ├── pr.md
669
- │ └── project.md
670
- └── config.json
671
- ```
672
-
673
- ## Monitoring & Visualization
674
-
675
- ### Multi-Repo Dashboard
676
- ```bash
677
- npx claude-flow skill run github-multi-repo dashboard \
678
- --port 3000 \
679
- --metrics "agent-activity,task-progress,memory-usage" \
680
- --real-time
681
- ```
682
-
683
- ### Dependency Graph
684
- ```bash
685
- npx claude-flow skill run github-multi-repo dep-graph \
686
- --format mermaid \
687
- --include-agents \
688
- --show-data-flow
689
- ```
690
-
691
- ### Health Monitoring
692
- ```bash
693
- npx claude-flow skill run github-multi-repo health-check \
694
- --repos "org/*" \
695
- --check "connectivity,memory,agents" \
696
- --alert-on-issues
697
- ```
698
-
699
- ## Best Practices
700
-
701
- ### 1. Repository Organization
702
- - Clear repository roles and boundaries
703
- - Consistent naming conventions
704
- - Documented dependencies
705
- - Shared configuration standards
706
-
707
- ### 2. Communication
708
- - Use appropriate sync strategies
709
- - Implement circuit breakers
710
- - Monitor latency and failures
711
- - Clear error propagation
712
-
713
- ### 3. Security
714
- - Secure cross-repo authentication
715
- - Encrypted communication channels
716
- - Audit trail for all operations
717
- - Principle of least privilege
718
-
719
- ### 4. Version Management
720
- - Semantic versioning alignment
721
- - Dependency compatibility validation
722
- - Automated version bump coordination
723
-
724
- ### 5. Testing Integration
725
- - Cross-package test validation
726
- - Integration test automation
727
- - Performance regression detection
728
-
729
- ## Performance Optimization
730
-
731
- ### Caching Strategy
732
- ```bash
733
- npx claude-flow skill run github-multi-repo cache-strategy \
734
- --analyze-patterns \
735
- --suggest-cache-layers \
736
- --implement-invalidation
737
- ```
738
-
739
- ### Parallel Execution
740
- ```bash
741
- npx claude-flow skill run github-multi-repo parallel-optimize \
742
- --analyze-dependencies \
743
- --identify-parallelizable \
744
- --execute-optimal
745
- ```
746
-
747
- ### Resource Pooling
748
- ```bash
749
- npx claude-flow skill run github-multi-repo resource-pool \
750
- --share-agents \
751
- --distribute-load \
752
- --monitor-usage
753
- ```
754
-
755
- ## Troubleshooting
756
-
757
- ### Connectivity Issues
758
- ```bash
759
- npx claude-flow skill run github-multi-repo diagnose-connectivity \
760
- --test-all-repos \
761
- --check-permissions \
762
- --verify-webhooks
763
- ```
764
-
765
- ### Memory Synchronization
766
- ```bash
767
- npx claude-flow skill run github-multi-repo debug-memory \
768
- --check-consistency \
769
- --identify-conflicts \
770
- --repair-state
771
- ```
772
-
773
- ### Performance Bottlenecks
774
- ```bash
775
- npx claude-flow skill run github-multi-repo perf-analysis \
776
- --profile-operations \
777
- --identify-bottlenecks \
778
- --suggest-optimizations
779
- ```
780
-
781
- ## Advanced Features
782
-
783
- ### 1. Distributed Task Queue
784
- ```bash
785
- npx claude-flow skill run github-multi-repo queue \
786
- --backend redis \
787
- --workers 10 \
788
- --priority-routing \
789
- --dead-letter-queue
790
- ```
791
-
792
- ### 2. Cross-Repo Testing
793
- ```bash
794
- npx claude-flow skill run github-multi-repo test \
795
- --setup-test-env \
796
- --link-services \
797
- --run-e2e \
798
- --tear-down
799
- ```
800
-
801
- ### 3. Monorepo Migration
802
- ```bash
803
- npx claude-flow skill run github-multi-repo to-monorepo \
804
- --analyze-repos \
805
- --suggest-structure \
806
- --preserve-history \
807
- --create-migration-prs
808
- ```
809
-
810
- ## Examples
811
-
812
- ### Full-Stack Application Update
813
- ```bash
814
- npx claude-flow skill run github-multi-repo fullstack-update \
815
- --frontend "org/web-app" \
816
- --backend "org/api-server" \
817
- --database "org/db-migrations" \
818
- --coordinate-deployment
819
- ```
820
-
821
- ### Cross-Team Collaboration
822
- ```bash
823
- npx claude-flow skill run github-multi-repo cross-team \
824
- --teams "frontend,backend,devops" \
825
- --task "implement-feature-x" \
826
- --assign-by-expertise \
827
- --track-progress
828
- ```
829
-
830
- ## Metrics and Reporting
831
-
832
- ### Sync Quality Metrics
833
- - Package version alignment percentage
834
- - Documentation consistency score
835
- - Integration test success rate
836
- - Synchronization completion time
837
-
838
- ### Architecture Health Metrics
839
- - Repository structure consistency score
840
- - Documentation coverage percentage
841
- - Cross-repository integration success rate
842
- - Template adoption and usage statistics
843
-
844
- ### Automated Reporting
845
- - Weekly sync status reports
846
- - Dependency drift detection
847
- - Documentation divergence alerts
848
- - Integration health monitoring
849
-
850
- ## Integration Points
851
-
852
- ### Related Skills
853
- - `github-workflow` - GitHub workflow automation
854
- - `github-pr` - Pull request management
855
- - `sparc-architect` - Architecture design
856
- - `sparc-optimizer` - Performance optimization
857
-
858
- ### Related Commands
859
- - `/github sync-coordinator` - Cross-repo synchronization
860
- - `/github release-manager` - Coordinated releases
861
- - `/github repo-architect` - Repository optimization
862
- - `/sparc architect` - Detailed architecture design
863
-
864
- ## Support and Resources
865
-
866
- - Documentation: https://github.com/ruvnet/claude-flow
867
- - Issues: https://github.com/ruvnet/claude-flow/issues
868
- - Examples: `.claude/examples/github-multi-repo/`
869
-
870
- ---
871
-
872
- **Version:** 1.0.0
873
- **Last Updated:** 2025-10-19
874
- **Maintainer:** Claude Flow Team
1
+ ---
2
+ name: github-multi-repo
3
+ version: 1.0.0
4
+ description: Multi-repository coordination, synchronization, and architecture management with AI swarm orchestration
5
+ category: github-integration
6
+ tags: [multi-repo, synchronization, architecture, coordination, github]
7
+ author: Claude Flow Team
8
+ requires:
9
+ - ruv-swarm@^1.0.11
10
+ - gh-cli@^2.0.0
11
+ capabilities:
12
+ - cross-repository coordination
13
+ - package synchronization
14
+ - architecture optimization
15
+ - template management
16
+ - distributed workflows
17
+ ---
18
+
19
+ # GitHub Multi-Repository Coordination Skill
20
+
21
+ ## Overview
22
+
23
+ Advanced multi-repository coordination system that combines swarm intelligence, package synchronization, and repository architecture optimization. This skill enables organization-wide automation, cross-project collaboration, and scalable repository management.
24
+
25
+ ## Core Capabilities
26
+
27
+ ### 🔄 Multi-Repository Swarm Coordination
28
+ Cross-repository AI swarm orchestration for distributed development workflows.
29
+
30
+ ### 📦 Package Synchronization
31
+ Intelligent dependency resolution and version alignment across multiple packages.
32
+
33
+ ### 🏗️ Repository Architecture
34
+ Structure optimization and template management for scalable projects.
35
+
36
+ ### 🔗 Integration Management
37
+ Cross-package integration testing and deployment coordination.
38
+
39
+ ## Quick Start
40
+
41
+ ### Initialize Multi-Repo Coordination
42
+ ```bash
43
+ # Basic swarm initialization
44
+ npx claude-flow skill run github-multi-repo init \
45
+ --repos "org/frontend,org/backend,org/shared" \
46
+ --topology hierarchical
47
+
48
+ # Advanced initialization with synchronization
49
+ npx claude-flow skill run github-multi-repo init \
50
+ --repos "org/frontend,org/backend,org/shared" \
51
+ --topology mesh \
52
+ --shared-memory \
53
+ --sync-strategy eventual
54
+ ```
55
+
56
+ ### Synchronize Packages
57
+ ```bash
58
+ # Synchronize package versions and dependencies
59
+ npx claude-flow skill run github-multi-repo sync \
60
+ --packages "claude-code-flow,ruv-swarm" \
61
+ --align-versions \
62
+ --update-docs
63
+ ```
64
+
65
+ ### Optimize Architecture
66
+ ```bash
67
+ # Analyze and optimize repository structure
68
+ npx claude-flow skill run github-multi-repo optimize \
69
+ --analyze-structure \
70
+ --suggest-improvements \
71
+ --create-templates
72
+ ```
73
+
74
+ ## Features
75
+
76
+ ### 1. Cross-Repository Swarm Orchestration
77
+
78
+ #### Repository Discovery
79
+ ```javascript
80
+ // Auto-discover related repositories with gh CLI
81
+ const REPOS = Bash(`gh repo list my-organization --limit 100 \
82
+ --json name,description,languages,topics \
83
+ --jq '.[] | select(.languages | keys | contains(["TypeScript"]))'`)
84
+
85
+ // Analyze repository dependencies
86
+ const DEPS = Bash(`gh repo list my-organization --json name | \
87
+ jq -r '.[].name' | while read -r repo; do
88
+ gh api repos/my-organization/$repo/contents/package.json \
89
+ --jq '.content' 2>/dev/null | base64 -d | jq '{name, dependencies}'
90
+ done | jq -s '.'`)
91
+
92
+ // Initialize swarm with discovered repositories
93
+ mcp__claude-flow__swarm_init({
94
+ topology: "hierarchical",
95
+ maxAgents: 8,
96
+ metadata: { repos: REPOS, dependencies: DEPS }
97
+ })
98
+ ```
99
+
100
+ #### Synchronized Operations
101
+ ```javascript
102
+ // Execute synchronized changes across repositories
103
+ [Parallel Multi-Repo Operations]:
104
+ // Spawn coordination agents
105
+ Task("Repository Coordinator", "Coordinate changes across all repositories", "coordinator")
106
+ Task("Dependency Analyzer", "Analyze cross-repo dependencies", "analyst")
107
+ Task("Integration Tester", "Validate cross-repo changes", "tester")
108
+
109
+ // Get matching repositories
110
+ Bash(`gh repo list org --limit 100 --json name \
111
+ --jq '.[] | select(.name | test("-service$")) | .name' > /tmp/repos.txt`)
112
+
113
+ // Execute task across repositories
114
+ Bash(`cat /tmp/repos.txt | while read -r repo; do
115
+ gh repo clone org/$repo /tmp/$repo -- --depth=1
116
+ cd /tmp/$repo
117
+
118
+ # Apply changes
119
+ npm update
120
+ npm test
121
+
122
+ # Create PR if successful
123
+ if [ $? -eq 0 ]; then
124
+ git checkout -b update-dependencies-$(date +%Y%m%d)
125
+ git add -A
126
+ git commit -m "chore: Update dependencies"
127
+ git push origin HEAD
128
+ gh pr create --title "Update dependencies" --body "Automated update" --label "dependencies"
129
+ fi
130
+ done`)
131
+
132
+ // Track all operations
133
+ TodoWrite { todos: [
134
+ { id: "discover", content: "Discover all service repositories", status: "completed" },
135
+ { id: "update", content: "Update dependencies", status: "completed" },
136
+ { id: "test", content: "Run integration tests", status: "in_progress" },
137
+ { id: "pr", content: "Create pull requests", status: "pending" }
138
+ ]}
139
+ ```
140
+
141
+ ### 2. Package Synchronization
142
+
143
+ #### Version Alignment
144
+ ```javascript
145
+ // Synchronize package dependencies and versions
146
+ [Complete Package Sync]:
147
+ // Initialize sync swarm
148
+ mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 5 })
149
+
150
+ // Spawn sync agents
151
+ Task("Sync Coordinator", "Coordinate version alignment", "coordinator")
152
+ Task("Dependency Analyzer", "Analyze dependencies", "analyst")
153
+ Task("Integration Tester", "Validate synchronization", "tester")
154
+
155
+ // Read package states
156
+ Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
157
+ Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
158
+
159
+ // Align versions using gh CLI
160
+ Bash(`gh api repos/:owner/:repo/git/refs \
161
+ -f ref='refs/heads/sync/package-alignment' \
162
+ -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')`)
163
+
164
+ // Update package.json files
165
+ Bash(`gh api repos/:owner/:repo/contents/package.json \
166
+ --method PUT \
167
+ -f message="feat: Align Node.js version requirements" \
168
+ -f branch="sync/package-alignment" \
169
+ -f content="$(cat aligned-package.json | base64)"`)
170
+
171
+ // Store sync state
172
+ mcp__claude-flow__memory_usage({
173
+ action: "store",
174
+ key: "sync/packages/status",
175
+ value: {
176
+ timestamp: Date.now(),
177
+ packages_synced: ["claude-code-flow", "ruv-swarm"],
178
+ status: "synchronized"
179
+ }
180
+ })
181
+ ```
182
+
183
+ #### Documentation Synchronization
184
+ ```javascript
185
+ // Synchronize CLAUDE.md files across packages
186
+ [Documentation Sync]:
187
+ // Get source documentation
188
+ Bash(`gh api repos/:owner/:repo/contents/ruv-swarm/docs/CLAUDE.md \
189
+ --jq '.content' | base64 -d > /tmp/claude-source.md`)
190
+
191
+ // Update target documentation
192
+ Bash(`gh api repos/:owner/:repo/contents/claude-code-flow/CLAUDE.md \
193
+ --method PUT \
194
+ -f message="docs: Synchronize CLAUDE.md" \
195
+ -f branch="sync/documentation" \
196
+ -f content="$(cat /tmp/claude-source.md | base64)"`)
197
+
198
+ // Track sync status
199
+ mcp__claude-flow__memory_usage({
200
+ action: "store",
201
+ key: "sync/documentation/status",
202
+ value: { status: "synchronized", files: ["CLAUDE.md"] }
203
+ })
204
+ ```
205
+
206
+ #### Cross-Package Integration
207
+ ```javascript
208
+ // Coordinate feature implementation across packages
209
+ [Cross-Package Feature]:
210
+ // Push changes to all packages
211
+ mcp__github__push_files({
212
+ branch: "feature/github-integration",
213
+ files: [
214
+ {
215
+ path: "claude-code-flow/.claude/commands/github/github-modes.md",
216
+ content: "[GitHub modes documentation]"
217
+ },
218
+ {
219
+ path: "ruv-swarm/src/github-coordinator/hooks.js",
220
+ content: "[GitHub coordination hooks]"
221
+ }
222
+ ],
223
+ message: "feat: Add GitHub workflow integration"
224
+ })
225
+
226
+ // Create coordinated PR
227
+ Bash(`gh pr create \
228
+ --title "Feature: GitHub Workflow Integration" \
229
+ --body "## 🚀 GitHub Integration
230
+
231
+ ### Features
232
+ - ✅ Multi-repo coordination
233
+ - ✅ Package synchronization
234
+ - ✅ Architecture optimization
235
+
236
+ ### Testing
237
+ - [x] Package dependency verification
238
+ - [x] Integration tests
239
+ - [x] Cross-package compatibility"`)
240
+ ```
241
+
242
+ ### 3. Repository Architecture
243
+
244
+ #### Structure Analysis
245
+ ```javascript
246
+ // Analyze and optimize repository structure
247
+ [Architecture Analysis]:
248
+ // Initialize architecture swarm
249
+ mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 6 })
250
+
251
+ // Spawn architecture agents
252
+ Task("Senior Architect", "Analyze repository structure", "architect")
253
+ Task("Structure Analyst", "Identify optimization opportunities", "analyst")
254
+ Task("Performance Optimizer", "Optimize structure for scalability", "optimizer")
255
+ Task("Best Practices Researcher", "Research architecture patterns", "researcher")
256
+
257
+ // Analyze current structures
258
+ LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
259
+ LS("/workspaces/ruv-FANN/ruv-swarm/npm")
260
+
261
+ // Search for best practices
262
+ Bash(`gh search repos "language:javascript template architecture" \
263
+ --limit 10 \
264
+ --json fullName,description,stargazersCount \
265
+ --sort stars \
266
+ --order desc`)
267
+
268
+ // Store analysis results
269
+ mcp__claude-flow__memory_usage({
270
+ action: "store",
271
+ key: "architecture/analysis/results",
272
+ value: {
273
+ repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
274
+ optimization_areas: ["structure", "workflows", "templates"],
275
+ recommendations: ["standardize_structure", "improve_workflows"]
276
+ }
277
+ })
278
+ ```
279
+
280
+ #### Template Creation
281
+ ```javascript
282
+ // Create standardized repository template
283
+ [Template Creation]:
284
+ // Create template repository
285
+ mcp__github__create_repository({
286
+ name: "claude-project-template",
287
+ description: "Standardized template for Claude Code projects",
288
+ private: false,
289
+ autoInit: true
290
+ })
291
+
292
+ // Push template structure
293
+ mcp__github__push_files({
294
+ repo: "claude-project-template",
295
+ files: [
296
+ {
297
+ path: ".claude/commands/github/github-modes.md",
298
+ content: "[GitHub modes template]"
299
+ },
300
+ {
301
+ path: ".claude/config.json",
302
+ content: JSON.stringify({
303
+ version: "1.0",
304
+ mcp_servers: {
305
+ "ruv-swarm": {
306
+ command: "npx",
307
+ args: ["ruv-swarm", "mcp", "start"]
308
+ }
309
+ }
310
+ })
311
+ },
312
+ {
313
+ path: "CLAUDE.md",
314
+ content: "[Standardized CLAUDE.md]"
315
+ },
316
+ {
317
+ path: "package.json",
318
+ content: JSON.stringify({
319
+ name: "claude-project-template",
320
+ engines: { node: ">=20.0.0" },
321
+ dependencies: { "ruv-swarm": "^1.0.11" }
322
+ })
323
+ }
324
+ ],
325
+ message: "feat: Create standardized template"
326
+ })
327
+ ```
328
+
329
+ #### Cross-Repository Standardization
330
+ ```javascript
331
+ // Synchronize structure across repositories
332
+ [Structure Standardization]:
333
+ const repositories = ["claude-code-flow", "ruv-swarm", "claude-extensions"]
334
+
335
+ // Update common files across all repositories
336
+ repositories.forEach(repo => {
337
+ mcp__github__create_or_update_file({
338
+ repo: "ruv-FANN",
339
+ path: `${repo}/.github/workflows/integration.yml`,
340
+ content: `name: Integration Tests
341
+ on: [push, pull_request]
342
+ jobs:
343
+ test:
344
+ runs-on: ubuntu-latest
345
+ steps:
346
+ - uses: actions/checkout@v3
347
+ - uses: actions/setup-node@v3
348
+ with: { node-version: '20' }
349
+ - run: npm install && npm test`,
350
+ message: "ci: Standardize integration workflow",
351
+ branch: "structure/standardization"
352
+ })
353
+ })
354
+ ```
355
+
356
+ ### 4. Orchestration Workflows
357
+
358
+ #### Dependency Management
359
+ ```javascript
360
+ // Update dependencies across all repositories
361
+ [Organization-Wide Dependency Update]:
362
+ // Create tracking issue
363
+ TRACKING_ISSUE=$(Bash(`gh issue create \
364
+ --title "Dependency Update: typescript@5.0.0" \
365
+ --body "Tracking TypeScript update across all repositories" \
366
+ --label "dependencies,tracking" \
367
+ --json number -q .number`))
368
+
369
+ // Find all TypeScript repositories
370
+ TS_REPOS=$(Bash(`gh repo list org --limit 100 --json name | \
371
+ jq -r '.[].name' | while read -r repo; do
372
+ if gh api repos/org/$repo/contents/package.json 2>/dev/null | \
373
+ jq -r '.content' | base64 -d | grep -q '"typescript"'; then
374
+ echo "$repo"
375
+ fi
376
+ done`))
377
+
378
+ // Update each repository
379
+ Bash(`echo "$TS_REPOS" | while read -r repo; do
380
+ gh repo clone org/$repo /tmp/$repo -- --depth=1
381
+ cd /tmp/$repo
382
+
383
+ npm install --save-dev typescript@5.0.0
384
+
385
+ if npm test; then
386
+ git checkout -b update-typescript-5
387
+ git add package.json package-lock.json
388
+ git commit -m "chore: Update TypeScript to 5.0.0
389
+
390
+ Part of #$TRACKING_ISSUE"
391
+
392
+ git push origin HEAD
393
+ gh pr create \
394
+ --title "Update TypeScript to 5.0.0" \
395
+ --body "Updates TypeScript\n\nTracking: #$TRACKING_ISSUE" \
396
+ --label "dependencies"
397
+ else
398
+ gh issue comment $TRACKING_ISSUE \
399
+ --body "❌ Failed to update $repo - tests failing"
400
+ fi
401
+ done`)
402
+ ```
403
+
404
+ #### Refactoring Operations
405
+ ```javascript
406
+ // Coordinate large-scale refactoring
407
+ [Cross-Repo Refactoring]:
408
+ // Initialize refactoring swarm
409
+ mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 8 })
410
+
411
+ // Spawn specialized agents
412
+ Task("Refactoring Coordinator", "Coordinate refactoring across repos", "coordinator")
413
+ Task("Impact Analyzer", "Analyze refactoring impact", "analyst")
414
+ Task("Code Transformer", "Apply refactoring changes", "coder")
415
+ Task("Migration Guide Creator", "Create migration documentation", "documenter")
416
+ Task("Integration Tester", "Validate refactored code", "tester")
417
+
418
+ // Execute refactoring
419
+ mcp__claude-flow__task_orchestrate({
420
+ task: "Rename OldAPI to NewAPI across all repositories",
421
+ strategy: "sequential",
422
+ priority: "high"
423
+ })
424
+ ```
425
+
426
+ #### Security Updates
427
+ ```javascript
428
+ // Coordinate security patches
429
+ [Security Patch Deployment]:
430
+ // Scan all repositories
431
+ Bash(`gh repo list org --limit 100 --json name | jq -r '.[].name' | \
432
+ while read -r repo; do
433
+ gh repo clone org/$repo /tmp/$repo -- --depth=1
434
+ cd /tmp/$repo
435
+ npm audit --json > /tmp/audit-$repo.json
436
+ done`)
437
+
438
+ // Apply patches
439
+ Bash(`for repo in /tmp/audit-*.json; do
440
+ if [ $(jq '.vulnerabilities | length' $repo) -gt 0 ]; then
441
+ cd /tmp/$(basename $repo .json | sed 's/audit-//')
442
+ npm audit fix
443
+
444
+ if npm test; then
445
+ git checkout -b security/patch-$(date +%Y%m%d)
446
+ git add -A
447
+ git commit -m "security: Apply security patches"
448
+ git push origin HEAD
449
+ gh pr create --title "Security patches" --label "security"
450
+ fi
451
+ fi
452
+ done`)
453
+ ```
454
+
455
+ ## Configuration
456
+
457
+ ### Multi-Repo Config File
458
+ ```yaml
459
+ # .swarm/multi-repo.yml
460
+ version: 1
461
+ organization: my-org
462
+
463
+ repositories:
464
+ - name: frontend
465
+ url: github.com/my-org/frontend
466
+ role: ui
467
+ agents: [coder, designer, tester]
468
+
469
+ - name: backend
470
+ url: github.com/my-org/backend
471
+ role: api
472
+ agents: [architect, coder, tester]
473
+
474
+ - name: shared
475
+ url: github.com/my-org/shared
476
+ role: library
477
+ agents: [analyst, coder]
478
+
479
+ coordination:
480
+ topology: hierarchical
481
+ communication: webhook
482
+ memory: redis://shared-memory
483
+
484
+ dependencies:
485
+ - from: frontend
486
+ to: [backend, shared]
487
+ - from: backend
488
+ to: [shared]
489
+ ```
490
+
491
+ ### Repository Roles
492
+ ```javascript
493
+ {
494
+ "roles": {
495
+ "ui": {
496
+ "responsibilities": ["user-interface", "ux", "accessibility"],
497
+ "default-agents": ["designer", "coder", "tester"]
498
+ },
499
+ "api": {
500
+ "responsibilities": ["endpoints", "business-logic", "data"],
501
+ "default-agents": ["architect", "coder", "security"]
502
+ },
503
+ "library": {
504
+ "responsibilities": ["shared-code", "utilities", "types"],
505
+ "default-agents": ["analyst", "coder", "documenter"]
506
+ }
507
+ }
508
+ }
509
+ ```
510
+
511
+ ## Communication Strategies
512
+
513
+ ### 1. Webhook-Based Coordination
514
+ ```javascript
515
+ const { MultiRepoSwarm } = require('ruv-swarm');
516
+
517
+ const swarm = new MultiRepoSwarm({
518
+ webhook: {
519
+ url: 'https://swarm-coordinator.example.com',
520
+ secret: process.env.WEBHOOK_SECRET
521
+ }
522
+ });
523
+
524
+ swarm.on('repo:update', async (event) => {
525
+ await swarm.propagate(event, {
526
+ to: event.dependencies,
527
+ strategy: 'eventual-consistency'
528
+ });
529
+ });
530
+ ```
531
+
532
+ ### 2. Event Streaming
533
+ ```yaml
534
+ # Kafka configuration for real-time coordination
535
+ kafka:
536
+ brokers: ['kafka1:9092', 'kafka2:9092']
537
+ topics:
538
+ swarm-events:
539
+ partitions: 10
540
+ replication: 3
541
+ swarm-memory:
542
+ partitions: 5
543
+ replication: 3
544
+ ```
545
+
546
+ ## Synchronization Patterns
547
+
548
+ ### 1. Eventually Consistent
549
+ ```javascript
550
+ {
551
+ "sync": {
552
+ "strategy": "eventual",
553
+ "max-lag": "5m",
554
+ "retry": {
555
+ "attempts": 3,
556
+ "backoff": "exponential"
557
+ }
558
+ }
559
+ }
560
+ ```
561
+
562
+ ### 2. Strong Consistency
563
+ ```javascript
564
+ {
565
+ "sync": {
566
+ "strategy": "strong",
567
+ "consensus": "raft",
568
+ "quorum": 0.51,
569
+ "timeout": "30s"
570
+ }
571
+ }
572
+ ```
573
+
574
+ ### 3. Hybrid Approach
575
+ ```javascript
576
+ {
577
+ "sync": {
578
+ "default": "eventual",
579
+ "overrides": {
580
+ "security-updates": "strong",
581
+ "dependency-updates": "strong",
582
+ "documentation": "eventual"
583
+ }
584
+ }
585
+ }
586
+ ```
587
+
588
+ ## Use Cases
589
+
590
+ ### 1. Microservices Coordination
591
+ ```bash
592
+ npx claude-flow skill run github-multi-repo microservices \
593
+ --services "auth,users,orders,payments" \
594
+ --ensure-compatibility \
595
+ --sync-contracts \
596
+ --integration-tests
597
+ ```
598
+
599
+ ### 2. Library Updates
600
+ ```bash
601
+ npx claude-flow skill run github-multi-repo lib-update \
602
+ --library "org/shared-lib" \
603
+ --version "2.0.0" \
604
+ --find-consumers \
605
+ --update-imports \
606
+ --run-tests
607
+ ```
608
+
609
+ ### 3. Organization-Wide Changes
610
+ ```bash
611
+ npx claude-flow skill run github-multi-repo org-policy \
612
+ --policy "add-security-headers" \
613
+ --repos "org/*" \
614
+ --validate-compliance \
615
+ --create-reports
616
+ ```
617
+
618
+ ## Architecture Patterns
619
+
620
+ ### Monorepo Structure
621
+ ```
622
+ ruv-FANN/
623
+ ├── packages/
624
+ │ ├── claude-code-flow/
625
+ │ │ ├── src/
626
+ │ │ ├── .claude/
627
+ │ │ └── package.json
628
+ │ ├── ruv-swarm/
629
+ │ │ ├── src/
630
+ │ │ ├── wasm/
631
+ │ │ └── package.json
632
+ │ └── shared/
633
+ │ ├── types/
634
+ │ ├── utils/
635
+ │ └── config/
636
+ ├── tools/
637
+ │ ├── build/
638
+ │ ├── test/
639
+ │ └── deploy/
640
+ ├── docs/
641
+ │ ├── architecture/
642
+ │ ├── integration/
643
+ │ └── examples/
644
+ └── .github/
645
+ ├── workflows/
646
+ ├── templates/
647
+ └── actions/
648
+ ```
649
+
650
+ ### Command Structure
651
+ ```
652
+ .claude/
653
+ ├── commands/
654
+ │ ├── github/
655
+ │ │ ├── github-modes.md
656
+ │ │ ├── pr-manager.md
657
+ │ │ ├── issue-tracker.md
658
+ │ │ └── sync-coordinator.md
659
+ │ ├── sparc/
660
+ │ │ ├── sparc-modes.md
661
+ │ │ ├── coder.md
662
+ │ │ └── tester.md
663
+ │ └── swarm/
664
+ │ ├── coordination.md
665
+ │ └── orchestration.md
666
+ ├── templates/
667
+ │ ├── issue.md
668
+ │ ├── pr.md
669
+ │ └── project.md
670
+ └── config.json
671
+ ```
672
+
673
+ ## Monitoring & Visualization
674
+
675
+ ### Multi-Repo Dashboard
676
+ ```bash
677
+ npx claude-flow skill run github-multi-repo dashboard \
678
+ --port 3000 \
679
+ --metrics "agent-activity,task-progress,memory-usage" \
680
+ --real-time
681
+ ```
682
+
683
+ ### Dependency Graph
684
+ ```bash
685
+ npx claude-flow skill run github-multi-repo dep-graph \
686
+ --format mermaid \
687
+ --include-agents \
688
+ --show-data-flow
689
+ ```
690
+
691
+ ### Health Monitoring
692
+ ```bash
693
+ npx claude-flow skill run github-multi-repo health-check \
694
+ --repos "org/*" \
695
+ --check "connectivity,memory,agents" \
696
+ --alert-on-issues
697
+ ```
698
+
699
+ ## Best Practices
700
+
701
+ ### 1. Repository Organization
702
+ - Clear repository roles and boundaries
703
+ - Consistent naming conventions
704
+ - Documented dependencies
705
+ - Shared configuration standards
706
+
707
+ ### 2. Communication
708
+ - Use appropriate sync strategies
709
+ - Implement circuit breakers
710
+ - Monitor latency and failures
711
+ - Clear error propagation
712
+
713
+ ### 3. Security
714
+ - Secure cross-repo authentication
715
+ - Encrypted communication channels
716
+ - Audit trail for all operations
717
+ - Principle of least privilege
718
+
719
+ ### 4. Version Management
720
+ - Semantic versioning alignment
721
+ - Dependency compatibility validation
722
+ - Automated version bump coordination
723
+
724
+ ### 5. Testing Integration
725
+ - Cross-package test validation
726
+ - Integration test automation
727
+ - Performance regression detection
728
+
729
+ ## Performance Optimization
730
+
731
+ ### Caching Strategy
732
+ ```bash
733
+ npx claude-flow skill run github-multi-repo cache-strategy \
734
+ --analyze-patterns \
735
+ --suggest-cache-layers \
736
+ --implement-invalidation
737
+ ```
738
+
739
+ ### Parallel Execution
740
+ ```bash
741
+ npx claude-flow skill run github-multi-repo parallel-optimize \
742
+ --analyze-dependencies \
743
+ --identify-parallelizable \
744
+ --execute-optimal
745
+ ```
746
+
747
+ ### Resource Pooling
748
+ ```bash
749
+ npx claude-flow skill run github-multi-repo resource-pool \
750
+ --share-agents \
751
+ --distribute-load \
752
+ --monitor-usage
753
+ ```
754
+
755
+ ## Troubleshooting
756
+
757
+ ### Connectivity Issues
758
+ ```bash
759
+ npx claude-flow skill run github-multi-repo diagnose-connectivity \
760
+ --test-all-repos \
761
+ --check-permissions \
762
+ --verify-webhooks
763
+ ```
764
+
765
+ ### Memory Synchronization
766
+ ```bash
767
+ npx claude-flow skill run github-multi-repo debug-memory \
768
+ --check-consistency \
769
+ --identify-conflicts \
770
+ --repair-state
771
+ ```
772
+
773
+ ### Performance Bottlenecks
774
+ ```bash
775
+ npx claude-flow skill run github-multi-repo perf-analysis \
776
+ --profile-operations \
777
+ --identify-bottlenecks \
778
+ --suggest-optimizations
779
+ ```
780
+
781
+ ## Advanced Features
782
+
783
+ ### 1. Distributed Task Queue
784
+ ```bash
785
+ npx claude-flow skill run github-multi-repo queue \
786
+ --backend redis \
787
+ --workers 10 \
788
+ --priority-routing \
789
+ --dead-letter-queue
790
+ ```
791
+
792
+ ### 2. Cross-Repo Testing
793
+ ```bash
794
+ npx claude-flow skill run github-multi-repo test \
795
+ --setup-test-env \
796
+ --link-services \
797
+ --run-e2e \
798
+ --tear-down
799
+ ```
800
+
801
+ ### 3. Monorepo Migration
802
+ ```bash
803
+ npx claude-flow skill run github-multi-repo to-monorepo \
804
+ --analyze-repos \
805
+ --suggest-structure \
806
+ --preserve-history \
807
+ --create-migration-prs
808
+ ```
809
+
810
+ ## Examples
811
+
812
+ ### Full-Stack Application Update
813
+ ```bash
814
+ npx claude-flow skill run github-multi-repo fullstack-update \
815
+ --frontend "org/web-app" \
816
+ --backend "org/api-server" \
817
+ --database "org/db-migrations" \
818
+ --coordinate-deployment
819
+ ```
820
+
821
+ ### Cross-Team Collaboration
822
+ ```bash
823
+ npx claude-flow skill run github-multi-repo cross-team \
824
+ --teams "frontend,backend,devops" \
825
+ --task "implement-feature-x" \
826
+ --assign-by-expertise \
827
+ --track-progress
828
+ ```
829
+
830
+ ## Metrics and Reporting
831
+
832
+ ### Sync Quality Metrics
833
+ - Package version alignment percentage
834
+ - Documentation consistency score
835
+ - Integration test success rate
836
+ - Synchronization completion time
837
+
838
+ ### Architecture Health Metrics
839
+ - Repository structure consistency score
840
+ - Documentation coverage percentage
841
+ - Cross-repository integration success rate
842
+ - Template adoption and usage statistics
843
+
844
+ ### Automated Reporting
845
+ - Weekly sync status reports
846
+ - Dependency drift detection
847
+ - Documentation divergence alerts
848
+ - Integration health monitoring
849
+
850
+ ## Integration Points
851
+
852
+ ### Related Skills
853
+ - `github-workflow` - GitHub workflow automation
854
+ - `github-pr` - Pull request management
855
+ - `sparc-architect` - Architecture design
856
+ - `sparc-optimizer` - Performance optimization
857
+
858
+ ### Related Commands
859
+ - `/github sync-coordinator` - Cross-repo synchronization
860
+ - `/github release-manager` - Coordinated releases
861
+ - `/github repo-architect` - Repository optimization
862
+ - `/sparc architect` - Detailed architecture design
863
+
864
+ ## Support and Resources
865
+
866
+ - Documentation: https://github.com/ruvnet/claude-flow
867
+ - Issues: https://github.com/ruvnet/claude-flow/issues
868
+ - Examples: `.claude/examples/github-multi-repo/`
869
+
870
+ ---
871
+
872
+ **Version:** 1.0.0
873
+ **Last Updated:** 2025-10-19
874
+ **Maintainer:** Claude Flow Team