moflo 4.8.10 → 4.8.12

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 (182) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -0
  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/dual-mode/codex-coordinator.md +224 -224
  8. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  9. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  10. package/.claude/agents/github/code-review-swarm.md +537 -537
  11. package/.claude/agents/github/github-modes.md +172 -172
  12. package/.claude/agents/github/issue-tracker.md +318 -318
  13. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  14. package/.claude/agents/github/pr-manager.md +190 -190
  15. package/.claude/agents/github/project-board-sync.md +508 -508
  16. package/.claude/agents/github/release-manager.md +366 -366
  17. package/.claude/agents/github/release-swarm.md +582 -582
  18. package/.claude/agents/github/repo-architect.md +397 -397
  19. package/.claude/agents/github/swarm-issue.md +572 -572
  20. package/.claude/agents/github/swarm-pr.md +427 -427
  21. package/.claude/agents/github/sync-coordinator.md +451 -451
  22. package/.claude/agents/github/workflow-automation.md +634 -634
  23. package/.claude/agents/goal/code-goal-planner.md +445 -445
  24. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  25. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  26. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  27. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  28. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  29. package/.claude/agents/neural/safla-neural.md +73 -73
  30. package/.claude/agents/reasoning/goal-planner.md +72 -72
  31. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  32. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  33. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  34. package/.claude/agents/templates/migration-plan.md +745 -745
  35. package/.claude/commands/agents/agent-spawning.md +28 -28
  36. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  37. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  38. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  39. package/.claude/commands/analysis/token-efficiency.md +44 -44
  40. package/.claude/commands/automation/auto-agent.md +122 -122
  41. package/.claude/commands/automation/self-healing.md +105 -105
  42. package/.claude/commands/automation/session-memory.md +89 -89
  43. package/.claude/commands/automation/smart-agents.md +72 -72
  44. package/.claude/commands/coordination/init.md +44 -44
  45. package/.claude/commands/coordination/orchestrate.md +43 -43
  46. package/.claude/commands/coordination/spawn.md +45 -45
  47. package/.claude/commands/coordination/swarm-init.md +85 -85
  48. package/.claude/commands/github/github-modes.md +146 -146
  49. package/.claude/commands/github/github-swarm.md +121 -121
  50. package/.claude/commands/github/issue-tracker.md +291 -291
  51. package/.claude/commands/github/pr-manager.md +169 -169
  52. package/.claude/commands/github/release-manager.md +337 -337
  53. package/.claude/commands/github/repo-architect.md +366 -366
  54. package/.claude/commands/github/sync-coordinator.md +300 -300
  55. package/.claude/commands/memory/neural.md +47 -47
  56. package/.claude/commands/monitoring/agents.md +44 -44
  57. package/.claude/commands/monitoring/status.md +46 -46
  58. package/.claude/commands/optimization/auto-topology.md +61 -61
  59. package/.claude/commands/optimization/parallel-execution.md +49 -49
  60. package/.claude/commands/sparc/analyzer.md +51 -51
  61. package/.claude/commands/sparc/architect.md +53 -53
  62. package/.claude/commands/sparc/ask.md +97 -97
  63. package/.claude/commands/sparc/batch-executor.md +54 -54
  64. package/.claude/commands/sparc/code.md +89 -89
  65. package/.claude/commands/sparc/coder.md +54 -54
  66. package/.claude/commands/sparc/debug.md +83 -83
  67. package/.claude/commands/sparc/debugger.md +54 -54
  68. package/.claude/commands/sparc/designer.md +53 -53
  69. package/.claude/commands/sparc/devops.md +109 -109
  70. package/.claude/commands/sparc/docs-writer.md +80 -80
  71. package/.claude/commands/sparc/documenter.md +54 -54
  72. package/.claude/commands/sparc/innovator.md +54 -54
  73. package/.claude/commands/sparc/integration.md +83 -83
  74. package/.claude/commands/sparc/mcp.md +117 -117
  75. package/.claude/commands/sparc/memory-manager.md +54 -54
  76. package/.claude/commands/sparc/optimizer.md +54 -54
  77. package/.claude/commands/sparc/orchestrator.md +131 -131
  78. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  79. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  80. package/.claude/commands/sparc/researcher.md +54 -54
  81. package/.claude/commands/sparc/reviewer.md +54 -54
  82. package/.claude/commands/sparc/security-review.md +80 -80
  83. package/.claude/commands/sparc/sparc-modes.md +174 -174
  84. package/.claude/commands/sparc/sparc.md +111 -111
  85. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  86. package/.claude/commands/sparc/supabase-admin.md +348 -348
  87. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  88. package/.claude/commands/sparc/tdd.md +54 -54
  89. package/.claude/commands/sparc/tester.md +54 -54
  90. package/.claude/commands/sparc/tutorial.md +79 -79
  91. package/.claude/commands/sparc/workflow-manager.md +54 -54
  92. package/.claude/commands/sparc.md +166 -166
  93. package/.claude/commands/swarm/analysis.md +95 -95
  94. package/.claude/commands/swarm/development.md +96 -96
  95. package/.claude/commands/swarm/examples.md +168 -168
  96. package/.claude/commands/swarm/maintenance.md +102 -102
  97. package/.claude/commands/swarm/optimization.md +117 -117
  98. package/.claude/commands/swarm/research.md +136 -136
  99. package/.claude/commands/swarm/testing.md +131 -131
  100. package/.claude/commands/training/neural-patterns.md +73 -73
  101. package/.claude/commands/training/specialization.md +62 -62
  102. package/.claude/commands/workflows/development.md +77 -77
  103. package/.claude/commands/workflows/research.md +62 -62
  104. package/.claude/guidance/moflo-bootstrap.md +129 -0
  105. package/.claude/guidance/{agent-bootstrap.md → shipped/agent-bootstrap.md} +126 -126
  106. package/.claude/guidance/{guidance-memory-strategy.md → shipped/guidance-memory-strategy.md} +262 -262
  107. package/.claude/guidance/{memory-strategy.md → shipped/memory-strategy.md} +204 -204
  108. package/.claude/guidance/{moflo.md → shipped/moflo.md} +45 -31
  109. package/.claude/guidance/{task-swarm-integration.md → shipped/task-swarm-integration.md} +441 -348
  110. package/.claude/helpers/gate-hook.mjs +50 -0
  111. package/.claude/helpers/gate.cjs +138 -236
  112. package/.claude/helpers/hook-handler.cjs +64 -326
  113. package/.claude/helpers/post-commit +16 -0
  114. package/.claude/helpers/pre-commit +26 -0
  115. package/.claude/helpers/prompt-hook.mjs +72 -0
  116. package/.claude/scripts/build-embeddings.mjs +549 -0
  117. package/.claude/scripts/generate-code-map.mjs +697 -0
  118. package/.claude/scripts/hooks.mjs +656 -0
  119. package/.claude/scripts/index-guidance.mjs +893 -0
  120. package/.claude/scripts/index-tests.mjs +710 -0
  121. package/.claude/scripts/semantic-search.mjs +473 -0
  122. package/.claude/scripts/session-start-launcher.mjs +226 -0
  123. package/.claude/settings.json +351 -290
  124. package/.claude/settings.local.json +4 -3
  125. package/.claude/skills/browser/SKILL.md +204 -0
  126. package/.claude/skills/fl/SKILL.md +29 -23
  127. package/.claude/skills/flo/SKILL.md +29 -23
  128. package/.claude/skills/github-code-review/SKILL.md +4 -4
  129. package/.claude/skills/github-multi-repo/SKILL.md +8 -8
  130. package/.claude/skills/github-project-management/SKILL.md +6 -6
  131. package/.claude/skills/github-release-management/SKILL.md +12 -12
  132. package/.claude/skills/github-workflow-automation/SKILL.md +6 -6
  133. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  134. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  135. package/.claude/skills/sparc-methodology/SKILL.md +64 -64
  136. package/.claude/skills/swarm-advanced/SKILL.md +77 -77
  137. package/.claude/workflow-state.json +9 -0
  138. package/.claude-plugin/README.md +3 -3
  139. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +3 -3
  140. package/.claude-plugin/docs/QUICKSTART.md +4 -4
  141. package/.claude-plugin/marketplace.json +3 -3
  142. package/.claude-plugin/plugin.json +3 -3
  143. package/.claude-plugin/scripts/install.sh +9 -9
  144. package/.claude-plugin/scripts/verify.sh +7 -7
  145. package/README.md +311 -116
  146. package/bin/gate-hook.mjs +50 -0
  147. package/bin/gate.cjs +138 -0
  148. package/bin/hook-handler.cjs +83 -0
  149. package/bin/hooks.mjs +72 -12
  150. package/bin/index-guidance.mjs +29 -35
  151. package/bin/index-tests.mjs +710 -0
  152. package/bin/lib/process-manager.mjs +243 -0
  153. package/bin/lib/registry-cleanup.cjs +41 -0
  154. package/bin/prompt-hook.mjs +72 -0
  155. package/bin/semantic-search.mjs +472 -440
  156. package/bin/session-start-launcher.mjs +81 -31
  157. package/bin/setup-project.mjs +65 -65
  158. package/package.json +4 -2
  159. package/src/@claude-flow/cli/README.md +1 -1
  160. package/src/@claude-flow/cli/bin/cli.js +175 -175
  161. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1091 -736
  162. package/src/@claude-flow/cli/dist/src/commands/github.d.ts +12 -0
  163. package/src/@claude-flow/cli/dist/src/commands/github.js +505 -0
  164. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  165. package/src/@claude-flow/cli/dist/src/commands/index.d.ts +1 -0
  166. package/src/@claude-flow/cli/dist/src/commands/index.js +7 -0
  167. package/src/@claude-flow/cli/dist/src/config-adapter.js +1 -1
  168. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -24
  169. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +73 -494
  170. package/src/@claude-flow/cli/dist/src/init/executor.js +109 -5
  171. package/src/@claude-flow/cli/dist/src/init/helpers-generator.d.ts +14 -0
  172. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +156 -24
  173. package/src/@claude-flow/cli/dist/src/init/mcp-generator.js +20 -20
  174. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -23
  175. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +727 -670
  176. package/src/@claude-flow/cli/dist/src/init/settings-generator.js +23 -14
  177. package/src/@claude-flow/cli/dist/src/mcp-server.js +3 -3
  178. package/src/@claude-flow/cli/dist/src/plugins/manager.js +9 -8
  179. package/src/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +1 -0
  180. package/src/@claude-flow/cli/dist/src/services/worker-daemon.js +3 -1
  181. package/src/@claude-flow/cli/dist/src/services/workflow-gate.js +10 -10
  182. package/src/@claude-flow/cli/package.json +106 -106
@@ -1,85 +1,85 @@
1
- # swarm init
2
-
3
- Initialize a Claude Flow swarm with specified topology and configuration.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- npx claude-flow swarm init [options]
9
- ```
10
-
11
- ## Options
12
-
13
- - `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
14
- - `--max-agents, -m <number>` - Maximum number of agents (default: 8)
15
- - `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
16
- - `--auto-spawn` - Automatically spawn agents based on task complexity
17
- - `--memory` - Enable cross-session memory persistence
18
- - `--github` - Enable GitHub integration features
19
-
20
- ## Examples
21
-
22
- ### Basic initialization
23
-
24
- ```bash
25
- npx claude-flow swarm init
26
- ```
27
-
28
- ### Mesh topology for research
29
-
30
- ```bash
31
- npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
32
- ```
33
-
34
- ### Hierarchical for development
35
-
36
- ```bash
37
- npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
38
- ```
39
-
40
- ### GitHub-focused swarm
41
-
42
- ```bash
43
- npx claude-flow swarm init --topology star --github --memory
44
- ```
45
-
46
- ## Topologies
47
-
48
- ### Mesh
49
-
50
- - All agents connect to all others
51
- - Best for: Research, exploration, brainstorming
52
- - Communication: High overhead, maximum information sharing
53
-
54
- ### Hierarchical
55
-
56
- - Tree structure with clear command chain
57
- - Best for: Development, structured tasks, large projects
58
- - Communication: Efficient, clear responsibilities
59
-
60
- ### Ring
61
-
62
- - Agents connect in a circle
63
- - Best for: Pipeline processing, sequential workflows
64
- - Communication: Low overhead, ordered processing
65
-
66
- ### Star
67
-
68
- - Central coordinator with satellite agents
69
- - Best for: Simple tasks, centralized control
70
- - Communication: Minimal overhead, clear coordination
71
-
72
- ## Integration with Claude Code
73
-
74
- Once initialized, use MCP tools in Claude Code:
75
-
76
- ```javascript
77
- mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 8 }
78
- ```
79
-
80
- ## See Also
81
-
82
- - `agent spawn` - Create swarm agents
83
- - `task orchestrate` - Coordinate task execution
84
- - `swarm status` - Check swarm state
85
- - `swarm monitor` - Real-time monitoring
1
+ # swarm init
2
+
3
+ Initialize a Claude Flow swarm with specified topology and configuration.
4
+
5
+ ## Usage
6
+
7
+ ```bash
8
+ npx claude-flow swarm init [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ - `--topology, -t <type>` - Swarm topology: mesh, hierarchical, ring, star (default: hierarchical)
14
+ - `--max-agents, -m <number>` - Maximum number of agents (default: 8)
15
+ - `--strategy, -s <type>` - Execution strategy: balanced, parallel, sequential (default: parallel)
16
+ - `--auto-spawn` - Automatically spawn agents based on task complexity
17
+ - `--memory` - Enable cross-session memory persistence
18
+ - `--github` - Enable GitHub integration features
19
+
20
+ ## Examples
21
+
22
+ ### Basic initialization
23
+
24
+ ```bash
25
+ npx claude-flow swarm init
26
+ ```
27
+
28
+ ### Mesh topology for research
29
+
30
+ ```bash
31
+ npx claude-flow swarm init --topology mesh --max-agents 5 --strategy balanced
32
+ ```
33
+
34
+ ### Hierarchical for development
35
+
36
+ ```bash
37
+ npx claude-flow swarm init --topology hierarchical --max-agents 10 --strategy parallel --auto-spawn
38
+ ```
39
+
40
+ ### GitHub-focused swarm
41
+
42
+ ```bash
43
+ npx claude-flow swarm init --topology star --github --memory
44
+ ```
45
+
46
+ ## Topologies
47
+
48
+ ### Mesh
49
+
50
+ - All agents connect to all others
51
+ - Best for: Research, exploration, brainstorming
52
+ - Communication: High overhead, maximum information sharing
53
+
54
+ ### Hierarchical
55
+
56
+ - Tree structure with clear command chain
57
+ - Best for: Development, structured tasks, large projects
58
+ - Communication: Efficient, clear responsibilities
59
+
60
+ ### Ring
61
+
62
+ - Agents connect in a circle
63
+ - Best for: Pipeline processing, sequential workflows
64
+ - Communication: Low overhead, ordered processing
65
+
66
+ ### Star
67
+
68
+ - Central coordinator with satellite agents
69
+ - Best for: Simple tasks, centralized control
70
+ - Communication: Minimal overhead, clear coordination
71
+
72
+ ## Integration with Claude Code
73
+
74
+ Once initialized, use MCP tools in Claude Code:
75
+
76
+ ```javascript
77
+ mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 8 }
78
+ ```
79
+
80
+ ## See Also
81
+
82
+ - `agent spawn` - Create swarm agents
83
+ - `task orchestrate` - Coordinate task execution
84
+ - `swarm status` - Check swarm state
85
+ - `swarm monitor` - Real-time monitoring
@@ -1,147 +1,147 @@
1
- # GitHub Integration Modes
2
-
3
- ## Overview
4
- This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
5
-
6
- ## GitHub Workflow Modes
7
-
8
- ### gh-coordinator
9
- **GitHub workflow orchestration and coordination**
10
- - **Coordination Mode**: Hierarchical
11
- - **Max Parallel Operations**: 10
12
- - **Batch Optimized**: Yes
13
- - **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
14
- - **Usage**: `/github gh-coordinator <GitHub workflow description>`
15
- - **Best For**: Complex GitHub workflows, multi-repo coordination
16
-
17
- ### pr-manager
18
- **Pull request management and review coordination**
19
- - **Review Mode**: Automated
20
- - **Multi-reviewer**: Yes
21
- - **Conflict Resolution**: Intelligent
22
- - **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
23
- - **Usage**: `/github pr-manager <PR management task>`
24
- - **Best For**: PR reviews, merge coordination, conflict resolution
25
-
26
- ### issue-tracker
27
- **Issue management and project coordination**
28
- - **Issue Workflow**: Automated
29
- - **Label Management**: Smart
30
- - **Progress Tracking**: Real-time
31
- - **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
32
- - **Usage**: `/github issue-tracker <issue management task>`
33
- - **Best For**: Project management, issue coordination, progress tracking
34
-
35
- ### release-manager
36
- **Release coordination and deployment**
37
- - **Release Pipeline**: Automated
38
- - **Versioning**: Semantic
39
- - **Deployment**: Multi-stage
40
- - **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
41
- - **Usage**: `/github release-manager <release task>`
42
- - **Best For**: Release management, version coordination, deployment pipelines
43
-
44
- ## Repository Management Modes
45
-
46
- ### repo-architect
47
- **Repository structure and organization**
48
- - **Structure Optimization**: Yes
49
- - **Multi-repo**: Support
50
- - **Template Management**: Advanced
51
- - **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash
52
- - **Usage**: `/github repo-architect <repository management task>`
53
- - **Best For**: Repository setup, structure optimization, multi-repo management
54
-
55
- ### code-reviewer
56
- **Automated code review and quality assurance**
57
- - **Review Quality**: Deep
58
- - **Security Analysis**: Yes
59
- - **Performance Check**: Automated
60
- - **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write
61
- - **Usage**: `/github code-reviewer <review task>`
62
- - **Best For**: Code quality, security reviews, performance analysis
63
-
64
- ### branch-manager
65
- **Branch management and workflow coordination**
66
- - **Branch Strategy**: GitFlow
67
- - **Merge Strategy**: Intelligent
68
- - **Conflict Prevention**: Proactive
69
- - **Tools**: gh api (for branch operations), git commands, Bash
70
- - **Usage**: `/github branch-manager <branch management task>`
71
- - **Best For**: Branch coordination, merge strategies, workflow management
72
-
73
- ## Integration Commands
74
-
75
- ### sync-coordinator
76
- **Multi-package synchronization**
77
- - **Package Sync**: Intelligent
78
- - **Version Alignment**: Automatic
79
- - **Dependency Resolution**: Advanced
80
- - **Tools**: git commands, gh pr create, Read, Write, Bash
81
- - **Usage**: `/github sync-coordinator <sync task>`
82
- - **Best For**: Package synchronization, version management, dependency updates
83
-
84
- ### ci-orchestrator
85
- **CI/CD pipeline coordination**
86
- - **Pipeline Management**: Advanced
87
- - **Test Coordination**: Parallel
88
- - **Deployment**: Automated
89
- - **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
90
- - **Usage**: `/github ci-orchestrator <CI/CD task>`
91
- - **Best For**: CI/CD coordination, test management, deployment automation
92
-
93
- ### security-guardian
94
- **Security and compliance management**
95
- - **Security Scan**: Automated
96
- - **Compliance Check**: Continuous
97
- - **Vulnerability Management**: Proactive
98
- - **Tools**: gh search code, gh issue create, gh secret list, Read, Write
99
- - **Usage**: `/github security-guardian <security task>`
100
- - **Best For**: Security audits, compliance checks, vulnerability management
101
-
102
- ## Usage Examples
103
-
104
- ### Creating a coordinated pull request workflow:
105
- ```bash
106
- /github pr-manager "Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination"
107
- ```
108
-
109
- ### Managing repository synchronization:
110
- ```bash
111
- /github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
112
- ```
113
-
114
- ### Setting up automated issue tracking:
115
- ```bash
116
- /github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
117
- ```
118
-
119
- ## Batch Operations
120
-
121
- All GitHub modes support batch operations for maximum efficiency:
122
-
123
- ### Parallel GitHub Operations Example:
124
- ```javascript
125
- [Single Message with BatchTool]:
126
- Bash("gh issue create --title 'Feature A' --body '...'")
127
- Bash("gh issue create --title 'Feature B' --body '...'")
128
- Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
129
- Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
130
- TodoWrite { todos: [todo1, todo2, todo3] }
131
- Bash("git checkout main && git pull")
132
- ```
133
-
134
- ## Integration with ruv-swarm
135
-
136
- All GitHub modes can be enhanced with ruv-swarm coordination:
137
-
138
- ```javascript
139
- // Initialize swarm for GitHub workflow
140
- mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
141
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
142
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
143
- mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
144
-
145
- // Execute GitHub workflow with coordination
146
- mcp__claude-flow__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
1
+ # GitHub Integration Modes
2
+
3
+ ## Overview
4
+ This document describes all GitHub integration modes available in Claude-Flow with ruv-swarm coordination. Each mode is optimized for specific GitHub workflows and includes batch tool integration for maximum efficiency.
5
+
6
+ ## GitHub Workflow Modes
7
+
8
+ ### gh-coordinator
9
+ **GitHub workflow orchestration and coordination**
10
+ - **Coordination Mode**: Hierarchical
11
+ - **Max Parallel Operations**: 10
12
+ - **Batch Optimized**: Yes
13
+ - **Tools**: gh CLI commands, TodoWrite, TodoRead, Task, Memory, Bash
14
+ - **Usage**: `/github gh-coordinator <GitHub workflow description>`
15
+ - **Best For**: Complex GitHub workflows, multi-repo coordination
16
+
17
+ ### pr-manager
18
+ **Pull request management and review coordination**
19
+ - **Review Mode**: Automated
20
+ - **Multi-reviewer**: Yes
21
+ - **Conflict Resolution**: Intelligent
22
+ - **Tools**: gh pr create, gh pr view, gh pr review, gh pr merge, TodoWrite, Task
23
+ - **Usage**: `/github pr-manager <PR management task>`
24
+ - **Best For**: PR reviews, merge coordination, conflict resolution
25
+
26
+ ### issue-tracker
27
+ **Issue management and project coordination**
28
+ - **Issue Workflow**: Automated
29
+ - **Label Management**: Smart
30
+ - **Progress Tracking**: Real-time
31
+ - **Tools**: gh issue create, gh issue edit, gh issue comment, gh issue list, TodoWrite
32
+ - **Usage**: `/github issue-tracker <issue management task>`
33
+ - **Best For**: Project management, issue coordination, progress tracking
34
+
35
+ ### release-manager
36
+ **Release coordination and deployment**
37
+ - **Release Pipeline**: Automated
38
+ - **Versioning**: Semantic
39
+ - **Deployment**: Multi-stage
40
+ - **Tools**: gh pr create, gh pr merge, gh release create, Bash, TodoWrite
41
+ - **Usage**: `/github release-manager <release task>`
42
+ - **Best For**: Release management, version coordination, deployment pipelines
43
+
44
+ ## Repository Management Modes
45
+
46
+ ### repo-architect
47
+ **Repository structure and organization**
48
+ - **Structure Optimization**: Yes
49
+ - **Multi-repo**: Support
50
+ - **Template Management**: Advanced
51
+ - **Tools**: gh repo create, gh repo clone, git commands, Write, Read, Bash
52
+ - **Usage**: `/github repo-architect <repository management task>`
53
+ - **Best For**: Repository setup, structure optimization, multi-repo management
54
+
55
+ ### code-reviewer
56
+ **Automated code review and quality assurance**
57
+ - **Review Quality**: Deep
58
+ - **Security Analysis**: Yes
59
+ - **Performance Check**: Automated
60
+ - **Tools**: gh pr view --json files, gh pr review, gh pr comment, Read, Write
61
+ - **Usage**: `/github code-reviewer <review task>`
62
+ - **Best For**: Code quality, security reviews, performance analysis
63
+
64
+ ### branch-manager
65
+ **Branch management and workflow coordination**
66
+ - **Branch Strategy**: GitFlow
67
+ - **Merge Strategy**: Intelligent
68
+ - **Conflict Prevention**: Proactive
69
+ - **Tools**: gh api (for branch operations), git commands, Bash
70
+ - **Usage**: `/github branch-manager <branch management task>`
71
+ - **Best For**: Branch coordination, merge strategies, workflow management
72
+
73
+ ## Integration Commands
74
+
75
+ ### sync-coordinator
76
+ **Multi-package synchronization**
77
+ - **Package Sync**: Intelligent
78
+ - **Version Alignment**: Automatic
79
+ - **Dependency Resolution**: Advanced
80
+ - **Tools**: git commands, gh pr create, Read, Write, Bash
81
+ - **Usage**: `/github sync-coordinator <sync task>`
82
+ - **Best For**: Package synchronization, version management, dependency updates
83
+
84
+ ### ci-orchestrator
85
+ **CI/CD pipeline coordination**
86
+ - **Pipeline Management**: Advanced
87
+ - **Test Coordination**: Parallel
88
+ - **Deployment**: Automated
89
+ - **Tools**: gh pr checks, gh workflow list, gh run list, Bash, TodoWrite, Task
90
+ - **Usage**: `/github ci-orchestrator <CI/CD task>`
91
+ - **Best For**: CI/CD coordination, test management, deployment automation
92
+
93
+ ### security-guardian
94
+ **Security and compliance management**
95
+ - **Security Scan**: Automated
96
+ - **Compliance Check**: Continuous
97
+ - **Vulnerability Management**: Proactive
98
+ - **Tools**: gh search code, gh issue create, gh secret list, Read, Write
99
+ - **Usage**: `/github security-guardian <security task>`
100
+ - **Best For**: Security audits, compliance checks, vulnerability management
101
+
102
+ ## Usage Examples
103
+
104
+ ### Creating a coordinated pull request workflow:
105
+ ```bash
106
+ /github pr-manager "Review and merge feature/new-integration branch with automated testing and multi-reviewer coordination"
107
+ ```
108
+
109
+ ### Managing repository synchronization:
110
+ ```bash
111
+ /github sync-coordinator "Synchronize claude-code-flow and ruv-swarm packages, align versions, and update cross-dependencies"
112
+ ```
113
+
114
+ ### Setting up automated issue tracking:
115
+ ```bash
116
+ /github issue-tracker "Create and manage integration issues with automated progress tracking and swarm coordination"
117
+ ```
118
+
119
+ ## Batch Operations
120
+
121
+ All GitHub modes support batch operations for maximum efficiency:
122
+
123
+ ### Parallel GitHub Operations Example:
124
+ ```javascript
125
+ [Single Message with BatchTool]:
126
+ Bash("gh issue create --title 'Feature A' --body '...'")
127
+ Bash("gh issue create --title 'Feature B' --body '...'")
128
+ Bash("gh pr create --title 'PR 1' --head 'feature-a' --base 'main'")
129
+ Bash("gh pr create --title 'PR 2' --head 'feature-b' --base 'main'")
130
+ TodoWrite { todos: [todo1, todo2, todo3] }
131
+ Bash("git checkout main && git pull")
132
+ ```
133
+
134
+ ## Integration with ruv-swarm
135
+
136
+ All GitHub modes can be enhanced with ruv-swarm coordination:
137
+
138
+ ```javascript
139
+ // Initialize swarm for GitHub workflow
140
+ mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 5 }
141
+ mcp__moflo__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
142
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Code Reviewer" }
143
+ mcp__moflo__agent_spawn { type: "tester", name: "QA Agent" }
144
+
145
+ // Execute GitHub workflow with coordination
146
+ mcp__moflo__task_orchestrate { task: "GitHub workflow", strategy: "parallel" }
147
147
  ```