moflo 4.8.21 → 4.8.22

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 +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 +668 -653
  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/settings.local.json +18 -0
  102. package/.claude/skills/fl/SKILL.md +583 -583
  103. package/.claude/skills/flo/SKILL.md +583 -583
  104. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  105. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  106. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  107. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  108. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  109. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  110. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  111. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  112. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  113. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  114. package/.claude/workflow-state.json +4 -4
  115. package/LICENSE +21 -21
  116. package/README.md +685 -685
  117. package/bin/cli.js +0 -0
  118. package/bin/gate-hook.mjs +50 -50
  119. package/bin/gate.cjs +138 -138
  120. package/bin/generate-code-map.mjs +775 -775
  121. package/bin/hook-handler.cjs +83 -83
  122. package/bin/hooks.mjs +656 -656
  123. package/bin/index-guidance.mjs +892 -892
  124. package/bin/index-tests.mjs +709 -709
  125. package/bin/lib/process-manager.mjs +243 -243
  126. package/bin/lib/registry-cleanup.cjs +41 -41
  127. package/bin/prompt-hook.mjs +72 -72
  128. package/bin/semantic-search.mjs +472 -472
  129. package/bin/session-start-launcher.mjs +238 -238
  130. package/bin/setup-project.mjs +250 -250
  131. package/package.json +123 -123
  132. package/src/@claude-flow/cli/README.md +452 -452
  133. package/src/@claude-flow/cli/bin/cli.js +180 -180
  134. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  135. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  136. package/src/@claude-flow/cli/dist/src/commands/doctor.js +5 -1
  137. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  138. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  139. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  140. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  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 +3 -0
  144. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
  145. package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
  146. package/src/@claude-flow/cli/dist/src/index.js +44 -0
  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 -43
  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 +140 -140
  153. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  154. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  155. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  156. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +197 -0
  157. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
  158. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
  159. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  160. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  161. package/src/@claude-flow/cli/package.json +1 -1
  162. package/src/@claude-flow/guidance/README.md +1195 -1195
  163. package/src/@claude-flow/guidance/package.json +198 -198
  164. package/src/@claude-flow/memory/README.md +587 -587
  165. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +4 -7
  166. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +2 -0
  167. package/src/@claude-flow/memory/dist/agentdb-backend.js +28 -26
  168. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +36 -39
  169. package/src/@claude-flow/memory/dist/benchmark.test.js +1 -1
  170. package/src/@claude-flow/memory/dist/controller-registry.test.js +43 -0
  171. package/src/@claude-flow/memory/dist/database-provider.d.ts +2 -2
  172. package/src/@claude-flow/memory/dist/database-provider.js +6 -3
  173. package/src/@claude-flow/memory/dist/database-provider.test.js +1 -3
  174. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
  175. package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
  176. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
  177. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
  178. package/src/@claude-flow/memory/dist/index.d.ts +3 -0
  179. package/src/@claude-flow/memory/dist/index.js +3 -0
  180. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
  181. package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
  182. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +4 -3
  183. package/src/@claude-flow/memory/dist/sqljs-backend.js +31 -30
  184. package/src/@claude-flow/memory/package.json +44 -44
  185. package/src/@claude-flow/shared/README.md +323 -323
  186. package/src/@claude-flow/shared/dist/core/config/defaults.js +1 -1
  187. package/src/@claude-flow/shared/dist/core/config/loader.js +1 -1
  188. package/src/@claude-flow/shared/dist/core/config/schema.js +1 -1
  189. package/src/@claude-flow/shared/dist/events/event-store.js +34 -50
  190. package/src/@claude-flow/shared/dist/events/event-store.test.js +4 -8
  191. package/src/@claude-flow/shared/dist/hooks/executor.js +4 -7
  192. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +1 -1
  193. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  194. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +6 -6
  195. package/src/@claude-flow/shared/dist/utils/secure-logger.js +1 -1
  196. package/src/README.md +493 -493
  197. package/src/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
  198. package/src/@claude-flow/guidance/dist/adversarial.js +0 -572
  199. package/src/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
  200. package/src/@claude-flow/guidance/dist/analyzer.js +0 -2518
  201. package/src/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
  202. package/src/@claude-flow/guidance/dist/artifacts.js +0 -356
  203. package/src/@claude-flow/guidance/dist/authority.d.ts +0 -290
  204. package/src/@claude-flow/guidance/dist/authority.js +0 -558
  205. package/src/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
  206. package/src/@claude-flow/guidance/dist/capabilities.js +0 -485
  207. package/src/@claude-flow/guidance/dist/coherence.d.ts +0 -233
  208. package/src/@claude-flow/guidance/dist/coherence.js +0 -372
  209. package/src/@claude-flow/guidance/dist/compiler.d.ts +0 -87
  210. package/src/@claude-flow/guidance/dist/compiler.js +0 -419
  211. package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
  212. package/src/@claude-flow/guidance/dist/conformance-kit.js +0 -629
  213. package/src/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
  214. package/src/@claude-flow/guidance/dist/continue-gate.js +0 -353
  215. package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
  216. package/src/@claude-flow/guidance/dist/crypto-utils.js +0 -24
  217. package/src/@claude-flow/guidance/dist/evolution.d.ts +0 -282
  218. package/src/@claude-flow/guidance/dist/evolution.js +0 -500
  219. package/src/@claude-flow/guidance/dist/gates.d.ts +0 -79
  220. package/src/@claude-flow/guidance/dist/gates.js +0 -302
  221. package/src/@claude-flow/guidance/dist/gateway.d.ts +0 -206
  222. package/src/@claude-flow/guidance/dist/gateway.js +0 -452
  223. package/src/@claude-flow/guidance/dist/generators.d.ts +0 -153
  224. package/src/@claude-flow/guidance/dist/generators.js +0 -682
  225. package/src/@claude-flow/guidance/dist/headless.d.ts +0 -177
  226. package/src/@claude-flow/guidance/dist/headless.js +0 -342
  227. package/src/@claude-flow/guidance/dist/hooks.d.ts +0 -109
  228. package/src/@claude-flow/guidance/dist/hooks.js +0 -347
  229. package/src/@claude-flow/guidance/dist/index.d.ts +0 -205
  230. package/src/@claude-flow/guidance/dist/index.js +0 -321
  231. package/src/@claude-flow/guidance/dist/ledger.d.ts +0 -162
  232. package/src/@claude-flow/guidance/dist/ledger.js +0 -375
  233. package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
  234. package/src/@claude-flow/guidance/dist/manifest-validator.js +0 -838
  235. package/src/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
  236. package/src/@claude-flow/guidance/dist/memory-gate.js +0 -382
  237. package/src/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
  238. package/src/@claude-flow/guidance/dist/meta-governance.js +0 -348
  239. package/src/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
  240. package/src/@claude-flow/guidance/dist/optimizer.js +0 -329
  241. package/src/@claude-flow/guidance/dist/persistence.d.ts +0 -189
  242. package/src/@claude-flow/guidance/dist/persistence.js +0 -464
  243. package/src/@claude-flow/guidance/dist/proof.d.ts +0 -185
  244. package/src/@claude-flow/guidance/dist/proof.js +0 -238
  245. package/src/@claude-flow/guidance/dist/retriever.d.ts +0 -116
  246. package/src/@claude-flow/guidance/dist/retriever.js +0 -394
  247. package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
  248. package/src/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
  249. package/src/@claude-flow/guidance/dist/temporal.d.ts +0 -426
  250. package/src/@claude-flow/guidance/dist/temporal.js +0 -658
  251. package/src/@claude-flow/guidance/dist/trust.d.ts +0 -283
  252. package/src/@claude-flow/guidance/dist/trust.js +0 -473
  253. package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
  254. package/src/@claude-flow/guidance/dist/truth-anchors.js +0 -488
  255. package/src/@claude-flow/guidance/dist/types.d.ts +0 -378
  256. package/src/@claude-flow/guidance/dist/types.js +0 -10
  257. package/src/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
  258. package/src/@claude-flow/guidance/dist/uncertainty.js +0 -619
  259. package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
  260. package/src/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
@@ -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