moflo 4.8.24 → 4.8.26

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 (260) 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 +143 -131
  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 +675 -668
  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/.claude/workflow-state.json +5 -5
  114. package/LICENSE +21 -21
  115. package/README.md +685 -698
  116. package/bin/cli.js +0 -0
  117. package/bin/gate-hook.mjs +50 -50
  118. package/bin/gate.cjs +138 -138
  119. package/bin/generate-code-map.mjs +937 -775
  120. package/bin/hook-handler.cjs +83 -83
  121. package/bin/hooks.mjs +696 -656
  122. package/bin/index-guidance.mjs +892 -892
  123. package/bin/index-tests.mjs +709 -709
  124. package/bin/lib/process-manager.mjs +256 -243
  125. package/bin/lib/registry-cleanup.cjs +41 -41
  126. package/bin/prompt-hook.mjs +72 -72
  127. package/bin/semantic-search.mjs +472 -472
  128. package/bin/session-start-launcher.mjs +238 -238
  129. package/bin/setup-project.mjs +250 -252
  130. package/package.json +123 -123
  131. package/src/@claude-flow/cli/README.md +452 -452
  132. package/src/@claude-flow/cli/bin/cli.js +180 -180
  133. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  134. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  135. package/src/@claude-flow/cli/dist/src/commands/doctor.js +2 -18
  136. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  137. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  138. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  139. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  140. package/src/@claude-flow/cli/dist/src/commands/init.js +8 -3
  141. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  142. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  143. package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +0 -3
  144. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +91 -101
  145. package/src/@claude-flow/cli/dist/src/index.d.ts +0 -5
  146. package/src/@claude-flow/cli/dist/src/index.js +0 -44
  147. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  148. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -45
  149. package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
  150. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  151. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  152. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +144 -200
  153. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  154. package/src/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +11 -5
  155. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  156. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  157. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +0 -14
  158. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  159. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  160. package/src/@claude-flow/cli/package.json +1 -1
  161. package/src/@claude-flow/guidance/README.md +1195 -1195
  162. package/src/@claude-flow/guidance/package.json +198 -198
  163. package/src/@claude-flow/memory/README.md +587 -587
  164. package/src/@claude-flow/memory/dist/agentdb-backend.js +26 -26
  165. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +27 -27
  166. package/src/@claude-flow/memory/dist/sqljs-backend.js +26 -26
  167. package/src/@claude-flow/memory/package.json +44 -44
  168. package/src/@claude-flow/shared/README.md +323 -323
  169. package/src/@claude-flow/shared/dist/events/event-store.js +31 -31
  170. package/src/README.md +493 -493
  171. package/.claude/agents/flow-nexus/app-store.md +0 -88
  172. package/.claude/agents/flow-nexus/authentication.md +0 -69
  173. package/.claude/agents/flow-nexus/challenges.md +0 -81
  174. package/.claude/agents/flow-nexus/neural-network.md +0 -88
  175. package/.claude/agents/flow-nexus/payments.md +0 -83
  176. package/.claude/agents/flow-nexus/sandbox.md +0 -76
  177. package/.claude/agents/flow-nexus/swarm.md +0 -76
  178. package/.claude/agents/flow-nexus/user-tools.md +0 -96
  179. package/.claude/agents/flow-nexus/workflow.md +0 -84
  180. package/.claude/agents/payments/agentic-payments.md +0 -126
  181. package/.claude/agents/sona/sona-learning-optimizer.md +0 -74
  182. package/.claude/agents/sublinear/consensus-coordinator.md +0 -338
  183. package/.claude/agents/sublinear/matrix-optimizer.md +0 -185
  184. package/.claude/agents/sublinear/pagerank-analyzer.md +0 -299
  185. package/.claude/agents/sublinear/performance-optimizer.md +0 -368
  186. package/.claude/agents/sublinear/trading-predictor.md +0 -246
  187. package/.claude/agents/v3/adr-architect.md +0 -184
  188. package/.claude/agents/v3/aidefence-guardian.md +0 -282
  189. package/.claude/agents/v3/claims-authorizer.md +0 -208
  190. package/.claude/agents/v3/collective-intelligence-coordinator.md +0 -993
  191. package/.claude/agents/v3/ddd-domain-expert.md +0 -220
  192. package/.claude/agents/v3/injection-analyst.md +0 -236
  193. package/.claude/agents/v3/memory-specialist.md +0 -995
  194. package/.claude/agents/v3/performance-engineer.md +0 -1233
  195. package/.claude/agents/v3/pii-detector.md +0 -151
  196. package/.claude/agents/v3/reasoningbank-learner.md +0 -213
  197. package/.claude/agents/v3/security-architect-aidefence.md +0 -410
  198. package/.claude/agents/v3/security-architect.md +0 -867
  199. package/.claude/agents/v3/security-auditor.md +0 -771
  200. package/.claude/agents/v3/sparc-orchestrator.md +0 -182
  201. package/.claude/agents/v3/swarm-memory-manager.md +0 -157
  202. package/.claude/agents/v3/v3-integration-architect.md +0 -205
  203. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +0 -54
  204. package/.claude/commands/analysis/README.md +0 -9
  205. package/.claude/commands/analysis/bottleneck-detect.md +0 -162
  206. package/.claude/commands/analysis/performance-bottlenecks.md +0 -59
  207. package/.claude/commands/analysis/performance-report.md +0 -25
  208. package/.claude/commands/analysis/token-efficiency.md +0 -45
  209. package/.claude/commands/analysis/token-usage.md +0 -25
  210. package/.claude/commands/automation/README.md +0 -9
  211. package/.claude/commands/automation/auto-agent.md +0 -122
  212. package/.claude/commands/automation/self-healing.md +0 -106
  213. package/.claude/commands/automation/session-memory.md +0 -90
  214. package/.claude/commands/automation/smart-agents.md +0 -73
  215. package/.claude/commands/automation/smart-spawn.md +0 -25
  216. package/.claude/commands/automation/workflow-select.md +0 -25
  217. package/.claude/commands/monitoring/README.md +0 -9
  218. package/.claude/commands/monitoring/agent-metrics.md +0 -25
  219. package/.claude/commands/monitoring/agents.md +0 -44
  220. package/.claude/commands/monitoring/real-time-view.md +0 -25
  221. package/.claude/commands/monitoring/status.md +0 -46
  222. package/.claude/commands/monitoring/swarm-monitor.md +0 -25
  223. package/.claude/commands/optimization/README.md +0 -9
  224. package/.claude/commands/optimization/auto-topology.md +0 -62
  225. package/.claude/commands/optimization/cache-manage.md +0 -25
  226. package/.claude/commands/optimization/parallel-execute.md +0 -25
  227. package/.claude/commands/optimization/parallel-execution.md +0 -50
  228. package/.claude/commands/optimization/topology-optimize.md +0 -25
  229. package/.claude/guidance/shipped/task-icons.md +0 -42
  230. package/.claude/helpers/gate-hook.mjs +0 -50
  231. package/.claude/helpers/gate.cjs +0 -138
  232. package/.claude/helpers/hook-handler.cjs +0 -76
  233. package/.claude/helpers/prompt-hook.mjs +0 -72
  234. package/.claude/scripts/build-embeddings.mjs +0 -549
  235. package/.claude/scripts/generate-code-map.mjs +0 -776
  236. package/.claude/scripts/hooks.mjs +0 -656
  237. package/.claude/scripts/index-guidance.mjs +0 -893
  238. package/.claude/scripts/index-tests.mjs +0 -710
  239. package/.claude/scripts/semantic-search.mjs +0 -473
  240. package/.claude/scripts/session-start-launcher.mjs +0 -238
  241. package/.claude/settings.local.json +0 -18
  242. package/.claude/skills/pair-programming/SKILL.md +0 -1202
  243. package/.claude/skills/stream-chain/SKILL.md +0 -563
  244. package/.claude/skills/v3-cli-modernization/SKILL.md +0 -872
  245. package/.claude/skills/v3-core-implementation/SKILL.md +0 -797
  246. package/.claude/skills/v3-ddd-architecture/SKILL.md +0 -442
  247. package/.claude/skills/v3-integration-deep/SKILL.md +0 -241
  248. package/.claude/skills/v3-mcp-optimization/SKILL.md +0 -777
  249. package/.claude/skills/v3-memory-unification/SKILL.md +0 -174
  250. package/.claude/skills/v3-performance-optimization/SKILL.md +0 -390
  251. package/.claude/skills/v3-security-overhaul/SKILL.md +0 -82
  252. package/.claude/skills/v3-swarm-coordination/SKILL.md +0 -340
  253. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +0 -197
  254. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +0 -584
  255. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +0 -245
  256. package/src/@claude-flow/memory/dist/hybrid-backend.js +0 -569
  257. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +0 -8
  258. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +0 -320
  259. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +0 -121
  260. package/src/@claude-flow/memory/dist/sqlite-backend.js +0 -572
@@ -1,398 +1,398 @@
1
- ---
2
- name: repo-architect
3
- description: Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows
4
- type: architecture
5
- color: "#9B59B6"
6
- tools:
7
- - Bash
8
- - Read
9
- - Write
10
- - Edit
11
- - LS
12
- - Glob
13
- - TodoWrite
14
- - TodoRead
15
- - Task
16
- - WebFetch
17
- - mcp__github__create_repository
18
- - mcp__github__fork_repository
19
- - mcp__github__search_repositories
20
- - mcp__github__push_files
21
- - mcp__github__create_or_update_file
22
- - mcp__moflo__swarm_init
23
- - mcp__moflo__agent_spawn
24
- - mcp__moflo__task_orchestrate
25
- - mcp__moflo__memory_usage
26
- hooks:
27
- pre_task: |
28
- echo "🏗️ Initializing repository architecture analysis..."
29
- npx ruv-swarm hook pre-task --mode repo-architect --analyze-structure
30
- post_edit: |
31
- echo "📐 Validating architecture changes and updating structure documentation..."
32
- npx ruv-swarm hook post-edit --mode repo-architect --validate-structure
33
- post_task: |
34
- echo "🏛️ Architecture task completed. Generating structure recommendations..."
35
- npx ruv-swarm hook post-task --mode repo-architect --generate-recommendations
36
- notification: |
37
- echo "📋 Notifying stakeholders of architecture improvements..."
38
- npx ruv-swarm hook notification --mode repo-architect
39
- ---
40
-
41
- # GitHub Repository Architect
42
-
43
- ## Purpose
44
- Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.
45
-
46
- ## Capabilities
47
- - **Repository structure optimization** with best practices
48
- - **Multi-repository coordination** and synchronization
49
- - **Template management** for consistent project setup
50
- - **Architecture analysis** and improvement recommendations
51
- - **Cross-repo workflow** coordination and management
52
-
53
- ## Usage Patterns
54
-
55
- ### 1. Repository Structure Analysis and Optimization
56
- ```javascript
57
- // Initialize architecture analysis swarm
58
- mcp__moflo__swarm_init { topology: "mesh", maxAgents: 4 }
59
- mcp__moflo__agent_spawn { type: "analyst", name: "Structure Analyzer" }
60
- mcp__moflo__agent_spawn { type: "architect", name: "Repository Architect" }
61
- mcp__moflo__agent_spawn { type: "optimizer", name: "Structure Optimizer" }
62
- mcp__moflo__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
63
-
64
- // Analyze current repository structure
65
- LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
66
- LS("/workspaces/ruv-FANN/ruv-swarm/npm")
67
-
68
- // Search for related repositories
69
- mcp__github__search_repositories {
70
- query: "user:ruvnet claude",
71
- sort: "updated",
72
- order: "desc"
73
- }
74
-
75
- // Orchestrate structure optimization
76
- mcp__moflo__task_orchestrate {
77
- task: "Analyze and optimize repository structure for scalability and maintainability",
78
- strategy: "adaptive",
79
- priority: "medium"
80
- }
81
- ```
82
-
83
- ### 2. Multi-Repository Template Creation
84
- ```javascript
85
- // Create standardized repository template
86
- mcp__github__create_repository {
87
- name: "claude-project-template",
88
- description: "Standardized template for Claude Code projects with ruv-swarm integration",
89
- private: false,
90
- autoInit: true
91
- }
92
-
93
- // Push template structure
94
- mcp__github__push_files {
95
- owner: "ruvnet",
96
- repo: "claude-project-template",
97
- branch: "main",
98
- files: [
99
- {
100
- path: ".claude/commands/github/github-modes.md",
101
- content: "[GitHub modes template]"
102
- },
103
- {
104
- path: ".claude/commands/sparc/sparc-modes.md",
105
- content: "[SPARC modes template]"
106
- },
107
- {
108
- path: ".claude/config.json",
109
- content: JSON.stringify({
110
- version: "1.0",
111
- mcp_servers: {
112
- "ruv-swarm": {
113
- command: "npx",
114
- args: ["ruv-swarm", "mcp", "start"],
115
- stdio: true
116
- }
117
- },
118
- hooks: {
119
- pre_task: "npx ruv-swarm hook pre-task",
120
- post_edit: "npx ruv-swarm hook post-edit",
121
- notification: "npx ruv-swarm hook notification"
122
- }
123
- }, null, 2)
124
- },
125
- {
126
- path: "CLAUDE.md",
127
- content: "[Standardized CLAUDE.md template]"
128
- },
129
- {
130
- path: "package.json",
131
- content: JSON.stringify({
132
- name: "claude-project-template",
133
- version: "1.0.0",
134
- description: "Claude Code project with ruv-swarm integration",
135
- engines: { node: ">=20.0.0" },
136
- dependencies: {
137
- "ruv-swarm": "^1.0.11"
138
- }
139
- }, null, 2)
140
- },
141
- {
142
- path: "README.md",
143
- content: `# Claude Project Template
144
-
145
- ## Quick Start
146
- \`\`\`bash
147
- npx claude-flow init --sparc
148
- npm install
149
- npx claude-flow start --ui
150
- \`\`\`
151
-
152
- ## Features
153
- - 🧠 ruv-swarm integration
154
- - 🎯 SPARC development modes
155
- - 🔧 GitHub workflow automation
156
- - 📊 Advanced coordination capabilities
157
-
158
- ## Documentation
159
- See CLAUDE.md for complete integration instructions.`
160
- }
161
- ],
162
- message: "feat: Create standardized Claude project template with ruv-swarm integration"
163
- }
164
- ```
165
-
166
- ### 3. Cross-Repository Synchronization
167
- ```javascript
168
- // Synchronize structure across related repositories
169
- const repositories = [
170
- "claude-code-flow",
171
- "ruv-swarm",
172
- "claude-extensions"
173
- ]
174
-
175
- // Update common files across repositories
176
- repositories.forEach(repo => {
177
- mcp__github__create_or_update_file({
178
- owner: "ruvnet",
179
- repo: "ruv-FANN",
180
- path: `${repo}/.github/workflows/integration.yml`,
181
- content: `name: Integration Tests
182
- on: [push, pull_request]
183
- jobs:
184
- test:
185
- runs-on: ubuntu-latest
186
- steps:
187
- - uses: actions/checkout@v3
188
- - uses: actions/setup-node@v3
189
- with: { node-version: '20' }
190
- - run: npm install && npm test`,
191
- message: "ci: Standardize integration workflow across repositories",
192
- branch: "structure/standardization"
193
- })
194
- })
195
- ```
196
-
197
- ## Batch Architecture Operations
198
-
199
- ### Complete Repository Architecture Optimization:
200
- ```javascript
201
- [Single Message - Repository Architecture Review]:
202
- // Initialize comprehensive architecture swarm
203
- mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 6 }
204
- mcp__moflo__agent_spawn { type: "architect", name: "Senior Architect" }
205
- mcp__moflo__agent_spawn { type: "analyst", name: "Structure Analyst" }
206
- mcp__moflo__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
207
- mcp__moflo__agent_spawn { type: "researcher", name: "Best Practices Researcher" }
208
- mcp__moflo__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
209
-
210
- // Analyze current repository structures
211
- LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
212
- LS("/workspaces/ruv-FANN/ruv-swarm/npm")
213
- Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
214
- Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
215
-
216
- // Search for architectural patterns using gh CLI
217
- ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \
218
- --limit 10 \
219
- --json fullName,description,stargazersCount \
220
- --sort stars \
221
- --order desc`))
222
-
223
- // Create optimized structure files
224
- mcp__github__push_files {
225
- branch: "architecture/optimization",
226
- files: [
227
- {
228
- path: "claude-code-flow/claude-code-flow/.github/ISSUE_TEMPLATE/integration.yml",
229
- content: "[Integration issue template]"
230
- },
231
- {
232
- path: "claude-code-flow/claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",
233
- content: "[Standardized PR template]"
234
- },
235
- {
236
- path: "claude-code-flow/claude-code-flow/docs/ARCHITECTURE.md",
237
- content: "[Architecture documentation]"
238
- },
239
- {
240
- path: "ruv-swarm/npm/.github/workflows/cross-package-test.yml",
241
- content: "[Cross-package testing workflow]"
242
- }
243
- ],
244
- message: "feat: Optimize repository architecture for scalability and maintainability"
245
- }
246
-
247
- // Track architecture improvements
248
- TodoWrite { todos: [
249
- { id: "arch-analysis", content: "Analyze current repository structure", status: "completed", priority: "high" },
250
- { id: "arch-research", content: "Research best practices and patterns", status: "completed", priority: "medium" },
251
- { id: "arch-templates", content: "Create standardized templates", status: "completed", priority: "high" },
252
- { id: "arch-workflows", content: "Implement improved workflows", status: "completed", priority: "medium" },
253
- { id: "arch-docs", content: "Document architecture decisions", status: "pending", priority: "medium" }
254
- ]}
255
-
256
- // Store architecture analysis
257
- mcp__moflo__memory_usage {
258
- action: "store",
259
- key: "architecture/analysis/results",
260
- value: {
261
- timestamp: Date.now(),
262
- repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
263
- optimization_areas: ["structure", "workflows", "templates", "documentation"],
264
- recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],
265
- implementation_status: "in_progress"
266
- }
267
- }
268
- ```
269
-
270
- ## Architecture Patterns
271
-
272
- ### 1. **Monorepo Structure Pattern**
273
- ```
274
- ruv-FANN/
275
- ├── packages/
276
- │ ├── claude-code-flow/
277
- │ │ ├── src/
278
- │ │ ├── .claude/
279
- │ │ └── package.json
280
- │ ├── ruv-swarm/
281
- │ │ ├── src/
282
- │ │ ├── wasm/
283
- │ │ └── package.json
284
- │ └── shared/
285
- │ ├── types/
286
- │ ├── utils/
287
- │ └── config/
288
- ├── tools/
289
- │ ├── build/
290
- │ ├── test/
291
- │ └── deploy/
292
- ├── docs/
293
- │ ├── architecture/
294
- │ ├── integration/
295
- │ └── examples/
296
- └── .github/
297
- ├── workflows/
298
- ├── templates/
299
- └── actions/
300
- ```
301
-
302
- ### 2. **Command Structure Pattern**
303
- ```
304
- .claude/
305
- ├── commands/
306
- │ ├── github/
307
- │ │ ├── github-modes.md
308
- │ │ ├── pr-manager.md
309
- │ │ ├── issue-tracker.md
310
- │ │ └── sync-coordinator.md
311
- │ ├── sparc/
312
- │ │ ├── sparc-modes.md
313
- │ │ ├── coder.md
314
- │ │ └── tester.md
315
- │ └── swarm/
316
- │ ├── coordination.md
317
- │ └── orchestration.md
318
- ├── templates/
319
- │ ├── issue.md
320
- │ ├── pr.md
321
- │ └── project.md
322
- └── config.json
323
- ```
324
-
325
- ### 3. **Integration Pattern**
326
- ```javascript
327
- const integrationPattern = {
328
- packages: {
329
- "claude-code-flow": {
330
- role: "orchestration_layer",
331
- dependencies: ["ruv-swarm"],
332
- provides: ["CLI", "workflows", "commands"]
333
- },
334
- "ruv-swarm": {
335
- role: "coordination_engine",
336
- dependencies: [],
337
- provides: ["MCP_tools", "neural_networks", "memory"]
338
- }
339
- },
340
- communication: "MCP_protocol",
341
- coordination: "swarm_based",
342
- state_management: "persistent_memory"
343
- }
344
- ```
345
-
346
- ## Best Practices
347
-
348
- ### 1. **Structure Optimization**
349
- - Consistent directory organization across repositories
350
- - Standardized configuration files and formats
351
- - Clear separation of concerns and responsibilities
352
- - Scalable architecture for future growth
353
-
354
- ### 2. **Template Management**
355
- - Reusable project templates for consistency
356
- - Standardized issue and PR templates
357
- - Workflow templates for common operations
358
- - Documentation templates for clarity
359
-
360
- ### 3. **Multi-Repository Coordination**
361
- - Cross-repository dependency management
362
- - Synchronized version and release management
363
- - Consistent coding standards and practices
364
- - Automated cross-repo validation
365
-
366
- ### 4. **Documentation Architecture**
367
- - Comprehensive architecture documentation
368
- - Clear integration guides and examples
369
- - Maintainable and up-to-date documentation
370
- - User-friendly onboarding materials
371
-
372
- ## Monitoring and Analysis
373
-
374
- ### Architecture Health Metrics:
375
- - Repository structure consistency score
376
- - Documentation coverage percentage
377
- - Cross-repository integration success rate
378
- - Template adoption and usage statistics
379
-
380
- ### Automated Analysis:
381
- - Structure drift detection
382
- - Best practices compliance checking
383
- - Performance impact analysis
384
- - Scalability assessment and recommendations
385
-
386
- ## Integration with Development Workflow
387
-
388
- ### Seamless integration with:
389
- - `/github sync-coordinator` - For cross-repo synchronization
390
- - `/github release-manager` - For coordinated releases
391
- - `/sparc architect` - For detailed architecture design
392
- - `/sparc optimizer` - For performance optimization
393
-
394
- ### Workflow Enhancement:
395
- - Automated structure validation
396
- - Continuous architecture improvement
397
- - Best practices enforcement
1
+ ---
2
+ name: repo-architect
3
+ description: Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows
4
+ type: architecture
5
+ color: "#9B59B6"
6
+ tools:
7
+ - Bash
8
+ - Read
9
+ - Write
10
+ - Edit
11
+ - LS
12
+ - Glob
13
+ - TodoWrite
14
+ - TodoRead
15
+ - Task
16
+ - WebFetch
17
+ - mcp__github__create_repository
18
+ - mcp__github__fork_repository
19
+ - mcp__github__search_repositories
20
+ - mcp__github__push_files
21
+ - mcp__github__create_or_update_file
22
+ - mcp__moflo__swarm_init
23
+ - mcp__moflo__agent_spawn
24
+ - mcp__moflo__task_orchestrate
25
+ - mcp__moflo__memory_usage
26
+ hooks:
27
+ pre_task: |
28
+ echo "🏗️ Initializing repository architecture analysis..."
29
+ npx ruv-swarm hook pre-task --mode repo-architect --analyze-structure
30
+ post_edit: |
31
+ echo "📐 Validating architecture changes and updating structure documentation..."
32
+ npx ruv-swarm hook post-edit --mode repo-architect --validate-structure
33
+ post_task: |
34
+ echo "🏛️ Architecture task completed. Generating structure recommendations..."
35
+ npx ruv-swarm hook post-task --mode repo-architect --generate-recommendations
36
+ notification: |
37
+ echo "📋 Notifying stakeholders of architecture improvements..."
38
+ npx ruv-swarm hook notification --mode repo-architect
39
+ ---
40
+
41
+ # GitHub Repository Architect
42
+
43
+ ## Purpose
44
+ Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows.
45
+
46
+ ## Capabilities
47
+ - **Repository structure optimization** with best practices
48
+ - **Multi-repository coordination** and synchronization
49
+ - **Template management** for consistent project setup
50
+ - **Architecture analysis** and improvement recommendations
51
+ - **Cross-repo workflow** coordination and management
52
+
53
+ ## Usage Patterns
54
+
55
+ ### 1. Repository Structure Analysis and Optimization
56
+ ```javascript
57
+ // Initialize architecture analysis swarm
58
+ mcp__moflo__swarm_init { topology: "mesh", maxAgents: 4 }
59
+ mcp__moflo__agent_spawn { type: "analyst", name: "Structure Analyzer" }
60
+ mcp__moflo__agent_spawn { type: "architect", name: "Repository Architect" }
61
+ mcp__moflo__agent_spawn { type: "optimizer", name: "Structure Optimizer" }
62
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
63
+
64
+ // Analyze current repository structure
65
+ LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
66
+ LS("/workspaces/ruv-FANN/ruv-swarm/npm")
67
+
68
+ // Search for related repositories
69
+ mcp__github__search_repositories {
70
+ query: "user:ruvnet claude",
71
+ sort: "updated",
72
+ order: "desc"
73
+ }
74
+
75
+ // Orchestrate structure optimization
76
+ mcp__moflo__task_orchestrate {
77
+ task: "Analyze and optimize repository structure for scalability and maintainability",
78
+ strategy: "adaptive",
79
+ priority: "medium"
80
+ }
81
+ ```
82
+
83
+ ### 2. Multi-Repository Template Creation
84
+ ```javascript
85
+ // Create standardized repository template
86
+ mcp__github__create_repository {
87
+ name: "claude-project-template",
88
+ description: "Standardized template for Claude Code projects with ruv-swarm integration",
89
+ private: false,
90
+ autoInit: true
91
+ }
92
+
93
+ // Push template structure
94
+ mcp__github__push_files {
95
+ owner: "ruvnet",
96
+ repo: "claude-project-template",
97
+ branch: "main",
98
+ files: [
99
+ {
100
+ path: ".claude/commands/github/github-modes.md",
101
+ content: "[GitHub modes template]"
102
+ },
103
+ {
104
+ path: ".claude/commands/sparc/sparc-modes.md",
105
+ content: "[SPARC modes template]"
106
+ },
107
+ {
108
+ path: ".claude/config.json",
109
+ content: JSON.stringify({
110
+ version: "1.0",
111
+ mcp_servers: {
112
+ "ruv-swarm": {
113
+ command: "npx",
114
+ args: ["ruv-swarm", "mcp", "start"],
115
+ stdio: true
116
+ }
117
+ },
118
+ hooks: {
119
+ pre_task: "npx ruv-swarm hook pre-task",
120
+ post_edit: "npx ruv-swarm hook post-edit",
121
+ notification: "npx ruv-swarm hook notification"
122
+ }
123
+ }, null, 2)
124
+ },
125
+ {
126
+ path: "CLAUDE.md",
127
+ content: "[Standardized CLAUDE.md template]"
128
+ },
129
+ {
130
+ path: "package.json",
131
+ content: JSON.stringify({
132
+ name: "claude-project-template",
133
+ version: "1.0.0",
134
+ description: "Claude Code project with ruv-swarm integration",
135
+ engines: { node: ">=20.0.0" },
136
+ dependencies: {
137
+ "ruv-swarm": "^1.0.11"
138
+ }
139
+ }, null, 2)
140
+ },
141
+ {
142
+ path: "README.md",
143
+ content: `# Claude Project Template
144
+
145
+ ## Quick Start
146
+ \`\`\`bash
147
+ npx claude-flow init --sparc
148
+ npm install
149
+ npx claude-flow start --ui
150
+ \`\`\`
151
+
152
+ ## Features
153
+ - 🧠 ruv-swarm integration
154
+ - 🎯 SPARC development modes
155
+ - 🔧 GitHub workflow automation
156
+ - 📊 Advanced coordination capabilities
157
+
158
+ ## Documentation
159
+ See CLAUDE.md for complete integration instructions.`
160
+ }
161
+ ],
162
+ message: "feat: Create standardized Claude project template with ruv-swarm integration"
163
+ }
164
+ ```
165
+
166
+ ### 3. Cross-Repository Synchronization
167
+ ```javascript
168
+ // Synchronize structure across related repositories
169
+ const repositories = [
170
+ "claude-code-flow",
171
+ "ruv-swarm",
172
+ "claude-extensions"
173
+ ]
174
+
175
+ // Update common files across repositories
176
+ repositories.forEach(repo => {
177
+ mcp__github__create_or_update_file({
178
+ owner: "ruvnet",
179
+ repo: "ruv-FANN",
180
+ path: `${repo}/.github/workflows/integration.yml`,
181
+ content: `name: Integration Tests
182
+ on: [push, pull_request]
183
+ jobs:
184
+ test:
185
+ runs-on: ubuntu-latest
186
+ steps:
187
+ - uses: actions/checkout@v3
188
+ - uses: actions/setup-node@v3
189
+ with: { node-version: '20' }
190
+ - run: npm install && npm test`,
191
+ message: "ci: Standardize integration workflow across repositories",
192
+ branch: "structure/standardization"
193
+ })
194
+ })
195
+ ```
196
+
197
+ ## Batch Architecture Operations
198
+
199
+ ### Complete Repository Architecture Optimization:
200
+ ```javascript
201
+ [Single Message - Repository Architecture Review]:
202
+ // Initialize comprehensive architecture swarm
203
+ mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 6 }
204
+ mcp__moflo__agent_spawn { type: "architect", name: "Senior Architect" }
205
+ mcp__moflo__agent_spawn { type: "analyst", name: "Structure Analyst" }
206
+ mcp__moflo__agent_spawn { type: "optimizer", name: "Performance Optimizer" }
207
+ mcp__moflo__agent_spawn { type: "researcher", name: "Best Practices Researcher" }
208
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Multi-Repo Coordinator" }
209
+
210
+ // Analyze current repository structures
211
+ LS("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow")
212
+ LS("/workspaces/ruv-FANN/ruv-swarm/npm")
213
+ Read("/workspaces/ruv-FANN/claude-code-flow/claude-code-flow/package.json")
214
+ Read("/workspaces/ruv-FANN/ruv-swarm/npm/package.json")
215
+
216
+ // Search for architectural patterns using gh CLI
217
+ ARCH_PATTERNS=$(Bash(`gh search repos "language:javascript template architecture" \
218
+ --limit 10 \
219
+ --json fullName,description,stargazersCount \
220
+ --sort stars \
221
+ --order desc`))
222
+
223
+ // Create optimized structure files
224
+ mcp__github__push_files {
225
+ branch: "architecture/optimization",
226
+ files: [
227
+ {
228
+ path: "claude-code-flow/claude-code-flow/.github/ISSUE_TEMPLATE/integration.yml",
229
+ content: "[Integration issue template]"
230
+ },
231
+ {
232
+ path: "claude-code-flow/claude-code-flow/.github/PULL_REQUEST_TEMPLATE.md",
233
+ content: "[Standardized PR template]"
234
+ },
235
+ {
236
+ path: "claude-code-flow/claude-code-flow/docs/ARCHITECTURE.md",
237
+ content: "[Architecture documentation]"
238
+ },
239
+ {
240
+ path: "ruv-swarm/npm/.github/workflows/cross-package-test.yml",
241
+ content: "[Cross-package testing workflow]"
242
+ }
243
+ ],
244
+ message: "feat: Optimize repository architecture for scalability and maintainability"
245
+ }
246
+
247
+ // Track architecture improvements
248
+ TodoWrite { todos: [
249
+ { id: "arch-analysis", content: "Analyze current repository structure", status: "completed", priority: "high" },
250
+ { id: "arch-research", content: "Research best practices and patterns", status: "completed", priority: "medium" },
251
+ { id: "arch-templates", content: "Create standardized templates", status: "completed", priority: "high" },
252
+ { id: "arch-workflows", content: "Implement improved workflows", status: "completed", priority: "medium" },
253
+ { id: "arch-docs", content: "Document architecture decisions", status: "pending", priority: "medium" }
254
+ ]}
255
+
256
+ // Store architecture analysis
257
+ mcp__moflo__memory_usage {
258
+ action: "store",
259
+ key: "architecture/analysis/results",
260
+ value: {
261
+ timestamp: Date.now(),
262
+ repositories_analyzed: ["claude-code-flow", "ruv-swarm"],
263
+ optimization_areas: ["structure", "workflows", "templates", "documentation"],
264
+ recommendations: ["standardize_structure", "improve_workflows", "enhance_templates"],
265
+ implementation_status: "in_progress"
266
+ }
267
+ }
268
+ ```
269
+
270
+ ## Architecture Patterns
271
+
272
+ ### 1. **Monorepo Structure Pattern**
273
+ ```
274
+ ruv-FANN/
275
+ ├── packages/
276
+ │ ├── claude-code-flow/
277
+ │ │ ├── src/
278
+ │ │ ├── .claude/
279
+ │ │ └── package.json
280
+ │ ├── ruv-swarm/
281
+ │ │ ├── src/
282
+ │ │ ├── wasm/
283
+ │ │ └── package.json
284
+ │ └── shared/
285
+ │ ├── types/
286
+ │ ├── utils/
287
+ │ └── config/
288
+ ├── tools/
289
+ │ ├── build/
290
+ │ ├── test/
291
+ │ └── deploy/
292
+ ├── docs/
293
+ │ ├── architecture/
294
+ │ ├── integration/
295
+ │ └── examples/
296
+ └── .github/
297
+ ├── workflows/
298
+ ├── templates/
299
+ └── actions/
300
+ ```
301
+
302
+ ### 2. **Command Structure Pattern**
303
+ ```
304
+ .claude/
305
+ ├── commands/
306
+ │ ├── github/
307
+ │ │ ├── github-modes.md
308
+ │ │ ├── pr-manager.md
309
+ │ │ ├── issue-tracker.md
310
+ │ │ └── sync-coordinator.md
311
+ │ ├── sparc/
312
+ │ │ ├── sparc-modes.md
313
+ │ │ ├── coder.md
314
+ │ │ └── tester.md
315
+ │ └── swarm/
316
+ │ ├── coordination.md
317
+ │ └── orchestration.md
318
+ ├── templates/
319
+ │ ├── issue.md
320
+ │ ├── pr.md
321
+ │ └── project.md
322
+ └── config.json
323
+ ```
324
+
325
+ ### 3. **Integration Pattern**
326
+ ```javascript
327
+ const integrationPattern = {
328
+ packages: {
329
+ "claude-code-flow": {
330
+ role: "orchestration_layer",
331
+ dependencies: ["ruv-swarm"],
332
+ provides: ["CLI", "workflows", "commands"]
333
+ },
334
+ "ruv-swarm": {
335
+ role: "coordination_engine",
336
+ dependencies: [],
337
+ provides: ["MCP_tools", "neural_networks", "memory"]
338
+ }
339
+ },
340
+ communication: "MCP_protocol",
341
+ coordination: "swarm_based",
342
+ state_management: "persistent_memory"
343
+ }
344
+ ```
345
+
346
+ ## Best Practices
347
+
348
+ ### 1. **Structure Optimization**
349
+ - Consistent directory organization across repositories
350
+ - Standardized configuration files and formats
351
+ - Clear separation of concerns and responsibilities
352
+ - Scalable architecture for future growth
353
+
354
+ ### 2. **Template Management**
355
+ - Reusable project templates for consistency
356
+ - Standardized issue and PR templates
357
+ - Workflow templates for common operations
358
+ - Documentation templates for clarity
359
+
360
+ ### 3. **Multi-Repository Coordination**
361
+ - Cross-repository dependency management
362
+ - Synchronized version and release management
363
+ - Consistent coding standards and practices
364
+ - Automated cross-repo validation
365
+
366
+ ### 4. **Documentation Architecture**
367
+ - Comprehensive architecture documentation
368
+ - Clear integration guides and examples
369
+ - Maintainable and up-to-date documentation
370
+ - User-friendly onboarding materials
371
+
372
+ ## Monitoring and Analysis
373
+
374
+ ### Architecture Health Metrics:
375
+ - Repository structure consistency score
376
+ - Documentation coverage percentage
377
+ - Cross-repository integration success rate
378
+ - Template adoption and usage statistics
379
+
380
+ ### Automated Analysis:
381
+ - Structure drift detection
382
+ - Best practices compliance checking
383
+ - Performance impact analysis
384
+ - Scalability assessment and recommendations
385
+
386
+ ## Integration with Development Workflow
387
+
388
+ ### Seamless integration with:
389
+ - `/github sync-coordinator` - For cross-repo synchronization
390
+ - `/github release-manager` - For coordinated releases
391
+ - `/sparc architect` - For detailed architecture design
392
+ - `/sparc optimizer` - For performance optimization
393
+
394
+ ### Workflow Enhancement:
395
+ - Automated structure validation
396
+ - Continuous architecture improvement
397
+ - Best practices enforcement
398
398
  - Documentation generation and maintenance