moflo 4.8.16 → 4.8.19

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