moflo 4.8.16 → 4.8.17

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 (466) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -182
  2. package/.claude/agents/core/coder.md +265 -265
  3. package/.claude/agents/core/planner.md +167 -167
  4. package/.claude/agents/core/researcher.md +189 -189
  5. package/.claude/agents/core/reviewer.md +325 -325
  6. package/.claude/agents/core/tester.md +318 -318
  7. package/.claude/agents/database-specialist.yaml +21 -21
  8. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  9. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  10. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  11. package/.claude/agents/github/code-review-swarm.md +537 -537
  12. package/.claude/agents/github/github-modes.md +172 -172
  13. package/.claude/agents/github/issue-tracker.md +318 -318
  14. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  15. package/.claude/agents/github/pr-manager.md +190 -190
  16. package/.claude/agents/github/project-board-sync.md +508 -508
  17. package/.claude/agents/github/release-manager.md +366 -366
  18. package/.claude/agents/github/release-swarm.md +582 -582
  19. package/.claude/agents/github/repo-architect.md +397 -397
  20. package/.claude/agents/github/swarm-issue.md +572 -572
  21. package/.claude/agents/github/swarm-pr.md +427 -427
  22. package/.claude/agents/github/sync-coordinator.md +451 -451
  23. package/.claude/agents/github/workflow-automation.md +634 -634
  24. package/.claude/agents/goal/code-goal-planner.md +445 -445
  25. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  26. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  27. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  28. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  29. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  30. package/.claude/agents/index.yaml +17 -17
  31. package/.claude/agents/neural/safla-neural.md +73 -73
  32. package/.claude/agents/project-coordinator.yaml +15 -15
  33. package/.claude/agents/python-specialist.yaml +21 -21
  34. package/.claude/agents/reasoning/goal-planner.md +72 -72
  35. package/.claude/agents/security-auditor.yaml +20 -20
  36. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  37. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  38. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  39. package/.claude/agents/templates/migration-plan.md +745 -745
  40. package/.claude/agents/typescript-specialist.yaml +21 -21
  41. package/.claude/checkpoints/1767754460.json +8 -8
  42. package/.claude/commands/agents/agent-spawning.md +28 -28
  43. package/.claude/commands/github/github-modes.md +146 -146
  44. package/.claude/commands/github/github-swarm.md +121 -121
  45. package/.claude/commands/github/issue-tracker.md +291 -291
  46. package/.claude/commands/github/pr-manager.md +169 -169
  47. package/.claude/commands/github/release-manager.md +337 -337
  48. package/.claude/commands/github/repo-architect.md +366 -366
  49. package/.claude/commands/github/sync-coordinator.md +300 -300
  50. package/.claude/commands/memory/neural.md +47 -47
  51. package/.claude/commands/sparc/analyzer.md +51 -51
  52. package/.claude/commands/sparc/architect.md +53 -53
  53. package/.claude/commands/sparc/ask.md +97 -97
  54. package/.claude/commands/sparc/batch-executor.md +54 -54
  55. package/.claude/commands/sparc/code.md +89 -89
  56. package/.claude/commands/sparc/coder.md +54 -54
  57. package/.claude/commands/sparc/debug.md +83 -83
  58. package/.claude/commands/sparc/debugger.md +54 -54
  59. package/.claude/commands/sparc/designer.md +53 -53
  60. package/.claude/commands/sparc/devops.md +109 -109
  61. package/.claude/commands/sparc/docs-writer.md +80 -80
  62. package/.claude/commands/sparc/documenter.md +54 -54
  63. package/.claude/commands/sparc/innovator.md +54 -54
  64. package/.claude/commands/sparc/integration.md +83 -83
  65. package/.claude/commands/sparc/mcp.md +117 -117
  66. package/.claude/commands/sparc/memory-manager.md +54 -54
  67. package/.claude/commands/sparc/optimizer.md +54 -54
  68. package/.claude/commands/sparc/orchestrator.md +131 -131
  69. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  70. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  71. package/.claude/commands/sparc/researcher.md +54 -54
  72. package/.claude/commands/sparc/reviewer.md +54 -54
  73. package/.claude/commands/sparc/security-review.md +80 -80
  74. package/.claude/commands/sparc/sparc-modes.md +174 -174
  75. package/.claude/commands/sparc/sparc.md +111 -111
  76. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  77. package/.claude/commands/sparc/supabase-admin.md +348 -348
  78. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  79. package/.claude/commands/sparc/tdd.md +54 -54
  80. package/.claude/commands/sparc/tester.md +54 -54
  81. package/.claude/commands/sparc/tutorial.md +79 -79
  82. package/.claude/commands/sparc/workflow-manager.md +54 -54
  83. package/.claude/commands/sparc.md +166 -166
  84. package/.claude/commands/swarm/analysis.md +95 -95
  85. package/.claude/commands/swarm/development.md +96 -96
  86. package/.claude/commands/swarm/examples.md +168 -168
  87. package/.claude/commands/swarm/maintenance.md +102 -102
  88. package/.claude/commands/swarm/optimization.md +117 -117
  89. package/.claude/commands/swarm/research.md +136 -136
  90. package/.claude/commands/swarm/testing.md +131 -131
  91. package/.claude/commands/workflows/development.md +77 -77
  92. package/.claude/commands/workflows/research.md +62 -62
  93. package/.claude/guidance/moflo-bootstrap.md +126 -126
  94. package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
  95. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  96. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  97. package/.claude/guidance/shipped/moflo.md +608 -608
  98. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  99. package/.claude/helpers/intelligence.cjs +207 -207
  100. package/.claude/helpers/statusline.cjs +851 -851
  101. package/.claude/skills/fl/SKILL.md +583 -583
  102. package/.claude/skills/flo/SKILL.md +583 -583
  103. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  104. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  105. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  106. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  107. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  108. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  109. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  110. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  111. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  112. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  113. package/LICENSE +21 -21
  114. package/README.md +685 -685
  115. package/bin/cli.js +0 -0
  116. package/bin/gate-hook.mjs +50 -50
  117. package/bin/gate.cjs +138 -138
  118. package/bin/hook-handler.cjs +83 -83
  119. package/bin/hooks.mjs +656 -656
  120. package/bin/index-guidance.mjs +892 -892
  121. package/bin/index-tests.mjs +709 -709
  122. package/bin/lib/process-manager.mjs +243 -243
  123. package/bin/lib/registry-cleanup.cjs +41 -41
  124. package/bin/prompt-hook.mjs +72 -72
  125. package/bin/semantic-search.mjs +472 -472
  126. package/bin/session-start-launcher.mjs +238 -226
  127. package/bin/setup-project.mjs +250 -250
  128. package/package.json +123 -121
  129. package/src/@claude-flow/cli/README.md +452 -452
  130. package/src/@claude-flow/cli/bin/cli.js +175 -175
  131. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  132. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  133. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1091 -1091
  134. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  135. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  136. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  137. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  138. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  139. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  140. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +91 -91
  141. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  142. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  143. package/src/@claude-flow/cli/dist/src/init/executor.js +485 -453
  144. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  145. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  146. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +839 -839
  147. package/src/@claude-flow/cli/dist/src/init/settings-generator.js +6 -2
  148. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +786 -786
  149. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  150. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  151. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  152. package/src/@claude-flow/cli/package.json +1 -1
  153. package/src/@claude-flow/guidance/README.md +1195 -1195
  154. package/src/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  155. package/src/@claude-flow/guidance/dist/adversarial.js +572 -0
  156. package/src/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  157. package/src/@claude-flow/guidance/dist/analyzer.js +2518 -0
  158. package/src/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  159. package/src/@claude-flow/guidance/dist/artifacts.js +356 -0
  160. package/src/@claude-flow/guidance/dist/authority.d.ts +290 -0
  161. package/src/@claude-flow/guidance/dist/authority.js +558 -0
  162. package/src/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  163. package/src/@claude-flow/guidance/dist/capabilities.js +485 -0
  164. package/src/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  165. package/src/@claude-flow/guidance/dist/coherence.js +372 -0
  166. package/src/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  167. package/src/@claude-flow/guidance/dist/compiler.js +419 -0
  168. package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  169. package/src/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  170. package/src/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  171. package/src/@claude-flow/guidance/dist/continue-gate.js +353 -0
  172. package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  173. package/src/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  174. package/src/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  175. package/src/@claude-flow/guidance/dist/evolution.js +500 -0
  176. package/src/@claude-flow/guidance/dist/gates.d.ts +79 -0
  177. package/src/@claude-flow/guidance/dist/gates.js +302 -0
  178. package/src/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  179. package/src/@claude-flow/guidance/dist/gateway.js +452 -0
  180. package/src/@claude-flow/guidance/dist/generators.d.ts +153 -0
  181. package/src/@claude-flow/guidance/dist/generators.js +682 -0
  182. package/src/@claude-flow/guidance/dist/headless.d.ts +177 -0
  183. package/src/@claude-flow/guidance/dist/headless.js +342 -0
  184. package/src/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  185. package/src/@claude-flow/guidance/dist/hooks.js +347 -0
  186. package/src/@claude-flow/guidance/dist/index.d.ts +205 -0
  187. package/src/@claude-flow/guidance/dist/index.js +321 -0
  188. package/src/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  189. package/src/@claude-flow/guidance/dist/ledger.js +375 -0
  190. package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  191. package/src/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  192. package/src/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  193. package/src/@claude-flow/guidance/dist/memory-gate.js +382 -0
  194. package/src/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  195. package/src/@claude-flow/guidance/dist/meta-governance.js +348 -0
  196. package/src/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  197. package/src/@claude-flow/guidance/dist/optimizer.js +329 -0
  198. package/src/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  199. package/src/@claude-flow/guidance/dist/persistence.js +464 -0
  200. package/src/@claude-flow/guidance/dist/proof.d.ts +185 -0
  201. package/src/@claude-flow/guidance/dist/proof.js +238 -0
  202. package/src/@claude-flow/guidance/dist/retriever.d.ts +116 -0
  203. package/src/@claude-flow/guidance/dist/retriever.js +394 -0
  204. package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  205. package/src/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  206. package/src/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  207. package/src/@claude-flow/guidance/dist/temporal.js +658 -0
  208. package/src/@claude-flow/guidance/dist/trust.d.ts +283 -0
  209. package/src/@claude-flow/guidance/dist/trust.js +473 -0
  210. package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  211. package/src/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  212. package/src/@claude-flow/guidance/dist/types.d.ts +378 -0
  213. package/src/@claude-flow/guidance/dist/types.js +10 -0
  214. package/src/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  215. package/src/@claude-flow/guidance/dist/uncertainty.js +619 -0
  216. package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  217. package/src/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  218. package/src/@claude-flow/guidance/package.json +198 -198
  219. package/src/@claude-flow/memory/README.md +587 -587
  220. package/src/@claude-flow/memory/package.json +44 -44
  221. package/src/@claude-flow/shared/README.md +323 -323
  222. package/src/README.md +493 -493
  223. package/.claude/settings.local.json +0 -18
  224. package/.claude/workflow-state.json +0 -9
  225. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +0 -197
  226. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +0 -584
  227. package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +0 -131
  228. package/src/@claude-flow/memory/dist/agent-memory-scope.js +0 -223
  229. package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +0 -8
  230. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +0 -463
  231. package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +0 -165
  232. package/src/@claude-flow/memory/dist/agentdb-adapter.js +0 -806
  233. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +0 -214
  234. package/src/@claude-flow/memory/dist/agentdb-backend.js +0 -844
  235. package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +0 -7
  236. package/src/@claude-flow/memory/dist/agentdb-backend.test.js +0 -258
  237. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +0 -65
  238. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +0 -129
  239. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +0 -48
  240. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +0 -72
  241. package/src/@claude-flow/memory/dist/application/index.d.ts +0 -12
  242. package/src/@claude-flow/memory/dist/application/index.js +0 -15
  243. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +0 -72
  244. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +0 -143
  245. package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +0 -121
  246. package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +0 -190
  247. package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +0 -226
  248. package/src/@claude-flow/memory/dist/auto-memory-bridge.js +0 -709
  249. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +0 -8
  250. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +0 -754
  251. package/src/@claude-flow/memory/dist/benchmark.test.d.ts +0 -2
  252. package/src/@claude-flow/memory/dist/benchmark.test.js +0 -277
  253. package/src/@claude-flow/memory/dist/cache-manager.d.ts +0 -134
  254. package/src/@claude-flow/memory/dist/cache-manager.js +0 -407
  255. package/src/@claude-flow/memory/dist/controller-registry.d.ts +0 -216
  256. package/src/@claude-flow/memory/dist/controller-registry.js +0 -893
  257. package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +0 -14
  258. package/src/@claude-flow/memory/dist/controller-registry.test.js +0 -636
  259. package/src/@claude-flow/memory/dist/database-provider.d.ts +0 -87
  260. package/src/@claude-flow/memory/dist/database-provider.js +0 -375
  261. package/src/@claude-flow/memory/dist/database-provider.test.d.ts +0 -7
  262. package/src/@claude-flow/memory/dist/database-provider.test.js +0 -285
  263. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +0 -143
  264. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +0 -226
  265. package/src/@claude-flow/memory/dist/domain/index.d.ts +0 -11
  266. package/src/@claude-flow/memory/dist/domain/index.js +0 -12
  267. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +0 -102
  268. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +0 -11
  269. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +0 -105
  270. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +0 -297
  271. package/src/@claude-flow/memory/dist/hnsw-index.d.ts +0 -111
  272. package/src/@claude-flow/memory/dist/hnsw-index.js +0 -781
  273. package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +0 -23
  274. package/src/@claude-flow/memory/dist/hnsw-lite.js +0 -168
  275. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +0 -245
  276. package/src/@claude-flow/memory/dist/hybrid-backend.js +0 -569
  277. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +0 -8
  278. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +0 -320
  279. package/src/@claude-flow/memory/dist/index.d.ts +0 -207
  280. package/src/@claude-flow/memory/dist/index.js +0 -361
  281. package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +0 -17
  282. package/src/@claude-flow/memory/dist/infrastructure/index.js +0 -16
  283. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +0 -66
  284. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +0 -409
  285. package/src/@claude-flow/memory/dist/learning-bridge.d.ts +0 -137
  286. package/src/@claude-flow/memory/dist/learning-bridge.js +0 -335
  287. package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +0 -8
  288. package/src/@claude-flow/memory/dist/learning-bridge.test.js +0 -578
  289. package/src/@claude-flow/memory/dist/memory-graph.d.ts +0 -100
  290. package/src/@claude-flow/memory/dist/memory-graph.js +0 -333
  291. package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +0 -8
  292. package/src/@claude-flow/memory/dist/memory-graph.test.js +0 -609
  293. package/src/@claude-flow/memory/dist/migration.d.ts +0 -68
  294. package/src/@claude-flow/memory/dist/migration.js +0 -513
  295. package/src/@claude-flow/memory/dist/persistent-sona.d.ts +0 -144
  296. package/src/@claude-flow/memory/dist/persistent-sona.js +0 -332
  297. package/src/@claude-flow/memory/dist/query-builder.d.ts +0 -211
  298. package/src/@claude-flow/memory/dist/query-builder.js +0 -438
  299. package/src/@claude-flow/memory/dist/rvf-backend.d.ts +0 -51
  300. package/src/@claude-flow/memory/dist/rvf-backend.js +0 -481
  301. package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +0 -139
  302. package/src/@claude-flow/memory/dist/rvf-learning-store.js +0 -295
  303. package/src/@claude-flow/memory/dist/rvf-migration.d.ts +0 -45
  304. package/src/@claude-flow/memory/dist/rvf-migration.js +0 -234
  305. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +0 -121
  306. package/src/@claude-flow/memory/dist/sqlite-backend.js +0 -572
  307. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +0 -128
  308. package/src/@claude-flow/memory/dist/sqljs-backend.js +0 -601
  309. package/src/@claude-flow/memory/dist/types.d.ts +0 -484
  310. package/src/@claude-flow/memory/dist/types.js +0 -58
  311. package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  312. package/src/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  313. package/src/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  314. package/src/@claude-flow/shared/dist/core/config/index.js +0 -12
  315. package/src/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  316. package/src/@claude-flow/shared/dist/core/config/loader.js +0 -222
  317. package/src/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1134
  318. package/src/@claude-flow/shared/dist/core/config/schema.js +0 -158
  319. package/src/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  320. package/src/@claude-flow/shared/dist/core/config/validator.js +0 -147
  321. package/src/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  322. package/src/@claude-flow/shared/dist/core/event-bus.js +0 -197
  323. package/src/@claude-flow/shared/dist/core/index.d.ts +0 -15
  324. package/src/@claude-flow/shared/dist/core/index.js +0 -19
  325. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  326. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  327. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  328. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  329. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  330. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  331. package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  332. package/src/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  333. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  334. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  335. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  336. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  337. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  338. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  339. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  340. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  341. package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  342. package/src/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  343. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  344. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  345. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  346. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  347. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  348. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  349. package/src/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  350. package/src/@claude-flow/shared/dist/events/domain-events.js +0 -165
  351. package/src/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  352. package/src/@claude-flow/shared/dist/events/event-store.js +0 -416
  353. package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  354. package/src/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  355. package/src/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  356. package/src/@claude-flow/shared/dist/events/example-usage.js +0 -193
  357. package/src/@claude-flow/shared/dist/events/index.d.ts +0 -21
  358. package/src/@claude-flow/shared/dist/events/index.js +0 -22
  359. package/src/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  360. package/src/@claude-flow/shared/dist/events/projections.js +0 -421
  361. package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  362. package/src/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  363. package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  364. package/src/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  365. package/src/@claude-flow/shared/dist/events.d.ts +0 -80
  366. package/src/@claude-flow/shared/dist/events.js +0 -249
  367. package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  368. package/src/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  369. package/src/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  370. package/src/@claude-flow/shared/dist/hooks/executor.js +0 -264
  371. package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  372. package/src/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  373. package/src/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  374. package/src/@claude-flow/shared/dist/hooks/index.js +0 -51
  375. package/src/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  376. package/src/@claude-flow/shared/dist/hooks/registry.js +0 -277
  377. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  378. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  379. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  380. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  381. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  382. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  383. package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  384. package/src/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  385. package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  386. package/src/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  387. package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  388. package/src/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  389. package/src/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  390. package/src/@claude-flow/shared/dist/hooks/types.js +0 -62
  391. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  392. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  393. package/src/@claude-flow/shared/dist/index.d.ts +0 -20
  394. package/src/@claude-flow/shared/dist/index.js +0 -50
  395. package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  396. package/src/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  397. package/src/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  398. package/src/@claude-flow/shared/dist/mcp/index.js +0 -84
  399. package/src/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  400. package/src/@claude-flow/shared/dist/mcp/server.js +0 -593
  401. package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  402. package/src/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  403. package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  404. package/src/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  405. package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  406. package/src/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  407. package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  408. package/src/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  409. package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  410. package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  411. package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  412. package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  413. package/src/@claude-flow/shared/dist/mcp/types.d.ts +0 -438
  414. package/src/@claude-flow/shared/dist/mcp/types.js +0 -54
  415. package/src/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  416. package/src/@claude-flow/shared/dist/plugin-interface.js +0 -23
  417. package/src/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  418. package/src/@claude-flow/shared/dist/plugin-loader.js +0 -434
  419. package/src/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  420. package/src/@claude-flow/shared/dist/plugin-registry.js +0 -457
  421. package/src/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  422. package/src/@claude-flow/shared/dist/plugins/index.js +0 -10
  423. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  424. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  425. package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  426. package/src/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  427. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  428. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  429. package/src/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  430. package/src/@claude-flow/shared/dist/plugins/types.js +0 -9
  431. package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  432. package/src/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  433. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  434. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  435. package/src/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  436. package/src/@claude-flow/shared/dist/resilience/index.js +0 -19
  437. package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  438. package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  439. package/src/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  440. package/src/@claude-flow/shared/dist/resilience/retry.js +0 -159
  441. package/src/@claude-flow/shared/dist/security/index.d.ts +0 -10
  442. package/src/@claude-flow/shared/dist/security/index.js +0 -12
  443. package/src/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  444. package/src/@claude-flow/shared/dist/security/input-validation.js +0 -201
  445. package/src/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  446. package/src/@claude-flow/shared/dist/security/secure-random.js +0 -142
  447. package/src/@claude-flow/shared/dist/services/index.d.ts +0 -7
  448. package/src/@claude-flow/shared/dist/services/index.js +0 -7
  449. package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  450. package/src/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  451. package/src/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  452. package/src/@claude-flow/shared/dist/types/agent.types.js +0 -6
  453. package/src/@claude-flow/shared/dist/types/index.d.ts +0 -11
  454. package/src/@claude-flow/shared/dist/types/index.js +0 -17
  455. package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  456. package/src/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  457. package/src/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  458. package/src/@claude-flow/shared/dist/types/memory.types.js +0 -7
  459. package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  460. package/src/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  461. package/src/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  462. package/src/@claude-flow/shared/dist/types/task.types.js +0 -32
  463. package/src/@claude-flow/shared/dist/types.d.ts +0 -197
  464. package/src/@claude-flow/shared/dist/types.js +0 -21
  465. package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  466. package/src/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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/eric-cielo/moflo
867
- - Issues: https://github.com/eric-cielo/moflo/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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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__moflo__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/eric-cielo/moflo
867
+ - Issues: https://github.com/eric-cielo/moflo/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