moflo 4.8.21 → 4.8.23

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 (178) 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 +698 -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 +18 -2
  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/init.js +3 -8
  142. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  143. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  144. package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +3 -0
  145. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
  146. package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
  147. package/src/@claude-flow/cli/dist/src/index.js +44 -0
  148. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  149. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  150. package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
  151. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  152. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  153. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +140 -140
  154. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  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/container-worker-pool.d.ts +197 -0
  158. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
  159. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
  160. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  161. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  162. package/src/@claude-flow/cli/package.json +1 -1
  163. package/src/@claude-flow/guidance/README.md +1195 -1195
  164. package/src/@claude-flow/guidance/package.json +198 -198
  165. package/src/@claude-flow/memory/README.md +587 -587
  166. package/src/@claude-flow/memory/dist/agentdb-backend.js +26 -26
  167. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +27 -27
  168. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
  169. package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
  170. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
  171. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
  172. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
  173. package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
  174. package/src/@claude-flow/memory/dist/sqljs-backend.js +26 -26
  175. package/src/@claude-flow/memory/package.json +44 -44
  176. package/src/@claude-flow/shared/README.md +323 -323
  177. package/src/@claude-flow/shared/dist/events/event-store.js +31 -31
  178. package/src/README.md +493 -493
@@ -1,21 +1,21 @@
1
- # TypeScript development specialist
2
- name: typescript-specialist
3
- type: typescript-developer
4
- description: TypeScript development specialist
5
- capabilities:
6
- - types
7
- - generics
8
- - decorators
9
- - async-await
10
- - modules
11
- focus:
12
- - security-audit
13
- - input-validation
14
- - authentication
15
- - encryption
16
- temperature: 0.2
17
- systemPrompt: |
18
- You are a TypeScript specialist.
19
- Focus on: strict typing, type inference, generic patterns, module organization.
20
- Prefer type safety over any, use discriminated unions, leverage utility types.
21
- Security-first development with vulnerability awareness
1
+ # TypeScript development specialist
2
+ name: typescript-specialist
3
+ type: typescript-developer
4
+ description: TypeScript development specialist
5
+ capabilities:
6
+ - types
7
+ - generics
8
+ - decorators
9
+ - async-await
10
+ - modules
11
+ focus:
12
+ - security-audit
13
+ - input-validation
14
+ - authentication
15
+ - encryption
16
+ temperature: 0.2
17
+ systemPrompt: |
18
+ You are a TypeScript specialist.
19
+ Focus on: strict typing, type inference, generic patterns, module organization.
20
+ Prefer type safety over any, use discriminated unions, leverage utility types.
21
+ Security-first development with vulnerability awareness
@@ -1,8 +1,8 @@
1
- {
2
- "tag": "checkpoint-20260107-025420",
3
- "file": ".claude/settings.json",
4
- "timestamp": "2026-01-07T02:54:20Z",
5
- "type": "post-edit",
6
- "branch": "v3",
7
- "diff_summary": " .claude/helpers/standard-checkpoint-hooks.sh | 14 +- .claude/settings.json | 20 +- v3/.agentic-flow/intelligence.json | 6 +- v3/@claude-flow/claims/package.json | 2 +- v3/@claude-flow/claims/src/api/cli-types.ts | 2 +- v3/@claude-flow/claims/src/api/mcp-tools.ts | 4 +- v3/@claude-flow/cli/package.json | 2 +- v3/@claude-flow/cli/src/commands/agent.ts | 2 +- v3/@claude-flow/cli/src/commands/config.ts | 4 +- v3/@claude-flow/cli/src/commands/hooks.ts | 2 +- v3/@claude-flow/cli/src/commands/mcp.ts | 2 +- v3/@claude-flow/cli/src/commands/memory.ts | 460 +++++++++++++-------- v3/@claude-flow/cli/src/commands/migrate.ts | 2 +- v3/@claude-flow/cli/src/commands/process.ts | 118 +++++- v3/@claude-flow/cli/src/commands/start.ts | 4 +- v3/@claude-flow/cli/src/commands/status.ts | 35 +- v3/@claude-flow/cli/src/commands/swarm.ts | 12 +- v3/@claude-flow/cli/src/init/settings-generator.ts | 6 +- v3/@claude-flow/cli/src/mcp-client.ts | 4 +- v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts | 52 ++- v3/@claude-flow/cli/src/mcp-tools/index.ts | 2 + v3/@claude-flow/cli/src/mcp-tools/memory-tools.ts | 199 ++++++++- v3/@claude-flow/cli/src/mcp-tools/swarm-tools.ts | 40 +- v3/@claude-flow/deployment/package.json | 2 +- v3/@claude-flow/embeddings/package.json | 2 +- v3/@claude-flow/hooks/package.json | 2 +- v3/@claude-flow/hooks/src/swarm/index.ts | 2 +- v3/@claude-flow/integration/package.json | 2 +- .../integration/src/agentic-flow-agent.ts | 6 +- .../integration/src/long-running-worker.ts | 4 +- .../integration/src/multi-model-router.ts | 10 +- .../integration/src/provider-adapter.ts | 2 +- v3/@claude-flow/integration/src/sdk-bridge.ts | 11 +- v3/@claude-flow/integration/src/sona-adapter.ts | 2 +- v3/@claude-flow/integration/src/swarm-adapter.ts | 4 +- v3/@claude-flow/mcp/package.json | 2 +- v3/@claude-flow/mcp/src/sampling.ts | 2 +- v3/@claude-flow/memory/package.json | 2 +- v3/@claude-flow/neural/package.json | 2 +- .../neural/src/algorithms/decision-transformer.js | 2 +- .../neural/src/algorithms/decision-transformer.ts | 2 +- v3/@claude-flow/performance/package.json | 2 +- v3/@claude-flow/plugins/package.json | 2 +- .../plugins/src/integrations/agentic-flow.ts | 70 +++- v3/@claude-flow/plugins/src/workers/index.ts | 8 +- v3/@claude-flow/providers/package.json | 2 +- v3/@claude-flow/security/package.json | 2 +- v3/@claude-flow/shared/package.json | 2 +- v3/@claude-flow/shared/src/events/example-usage.ts | 2 +- v3/@claude-flow/shared/src/hooks/example-usage.ts | 6 +- .../src/plugins/official/hive-mind-plugin.ts | 4 +- .../shared/src/plugins/official/maestro-plugin.ts | 6 +- v3/@claude-flow/swarm/package.json | 2 +- v3/@claude-flow/swarm/src/attention-coordinator.ts | 4 +- v3/@claude-flow/swarm/src/consensus/byzantine.ts | 2 +- v3/@claude-flow/swarm/src/consensus/gossip.ts | 2 +- v3/@claude-flow/swarm/src/consensus/raft.ts | 6 +- v3/@claude-flow/swarm/src/federation-hub.ts | 2 +- v3/@claude-flow/swarm/src/queen-coordinator.ts | 7 +- .../swarm/src/workers/worker-dispatch.d.ts | 2 +- .../swarm/src/workers/worker-dispatch.ts | 86 ++-- v3/@claude-flow/testing/package.json | 2 +- v3/implementation/adrs/README.md | 18 +- v3/mcp/tools/hooks-tools.ts | 6 +- v3/mcp/tools/sona-tools.ts | 96 ++++- v3/mcp/tools/system-tools.ts | 2 +- v3/package-lock.json | 125 +++--- v3/src/agent-lifecycle/domain/Agent.ts | 25 +- 68 files changed, 1085 insertions(+), 463 deletions(-) "
8
- }
1
+ {
2
+ "tag": "checkpoint-20260107-025420",
3
+ "file": ".claude/settings.json",
4
+ "timestamp": "2026-01-07T02:54:20Z",
5
+ "type": "post-edit",
6
+ "branch": "v3",
7
+ "diff_summary": " .claude/helpers/standard-checkpoint-hooks.sh | 14 +- .claude/settings.json | 20 +- v3/.agentic-flow/intelligence.json | 6 +- v3/@claude-flow/claims/package.json | 2 +- v3/@claude-flow/claims/src/api/cli-types.ts | 2 +- v3/@claude-flow/claims/src/api/mcp-tools.ts | 4 +- v3/@claude-flow/cli/package.json | 2 +- v3/@claude-flow/cli/src/commands/agent.ts | 2 +- v3/@claude-flow/cli/src/commands/config.ts | 4 +- v3/@claude-flow/cli/src/commands/hooks.ts | 2 +- v3/@claude-flow/cli/src/commands/mcp.ts | 2 +- v3/@claude-flow/cli/src/commands/memory.ts | 460 +++++++++++++-------- v3/@claude-flow/cli/src/commands/migrate.ts | 2 +- v3/@claude-flow/cli/src/commands/process.ts | 118 +++++- v3/@claude-flow/cli/src/commands/start.ts | 4 +- v3/@claude-flow/cli/src/commands/status.ts | 35 +- v3/@claude-flow/cli/src/commands/swarm.ts | 12 +- v3/@claude-flow/cli/src/init/settings-generator.ts | 6 +- v3/@claude-flow/cli/src/mcp-client.ts | 4 +- v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts | 52 ++- v3/@claude-flow/cli/src/mcp-tools/index.ts | 2 + v3/@claude-flow/cli/src/mcp-tools/memory-tools.ts | 199 ++++++++- v3/@claude-flow/cli/src/mcp-tools/swarm-tools.ts | 40 +- v3/@claude-flow/deployment/package.json | 2 +- v3/@claude-flow/embeddings/package.json | 2 +- v3/@claude-flow/hooks/package.json | 2 +- v3/@claude-flow/hooks/src/swarm/index.ts | 2 +- v3/@claude-flow/integration/package.json | 2 +- .../integration/src/agentic-flow-agent.ts | 6 +- .../integration/src/long-running-worker.ts | 4 +- .../integration/src/multi-model-router.ts | 10 +- .../integration/src/provider-adapter.ts | 2 +- v3/@claude-flow/integration/src/sdk-bridge.ts | 11 +- v3/@claude-flow/integration/src/sona-adapter.ts | 2 +- v3/@claude-flow/integration/src/swarm-adapter.ts | 4 +- v3/@claude-flow/mcp/package.json | 2 +- v3/@claude-flow/mcp/src/sampling.ts | 2 +- v3/@claude-flow/memory/package.json | 2 +- v3/@claude-flow/neural/package.json | 2 +- .../neural/src/algorithms/decision-transformer.js | 2 +- .../neural/src/algorithms/decision-transformer.ts | 2 +- v3/@claude-flow/performance/package.json | 2 +- v3/@claude-flow/plugins/package.json | 2 +- .../plugins/src/integrations/agentic-flow.ts | 70 +++- v3/@claude-flow/plugins/src/workers/index.ts | 8 +- v3/@claude-flow/providers/package.json | 2 +- v3/@claude-flow/security/package.json | 2 +- v3/@claude-flow/shared/package.json | 2 +- v3/@claude-flow/shared/src/events/example-usage.ts | 2 +- v3/@claude-flow/shared/src/hooks/example-usage.ts | 6 +- .../src/plugins/official/hive-mind-plugin.ts | 4 +- .../shared/src/plugins/official/maestro-plugin.ts | 6 +- v3/@claude-flow/swarm/package.json | 2 +- v3/@claude-flow/swarm/src/attention-coordinator.ts | 4 +- v3/@claude-flow/swarm/src/consensus/byzantine.ts | 2 +- v3/@claude-flow/swarm/src/consensus/gossip.ts | 2 +- v3/@claude-flow/swarm/src/consensus/raft.ts | 6 +- v3/@claude-flow/swarm/src/federation-hub.ts | 2 +- v3/@claude-flow/swarm/src/queen-coordinator.ts | 7 +- .../swarm/src/workers/worker-dispatch.d.ts | 2 +- .../swarm/src/workers/worker-dispatch.ts | 86 ++-- v3/@claude-flow/testing/package.json | 2 +- v3/implementation/adrs/README.md | 18 +- v3/mcp/tools/hooks-tools.ts | 6 +- v3/mcp/tools/sona-tools.ts | 96 ++++- v3/mcp/tools/system-tools.ts | 2 +- v3/package-lock.json | 125 +++--- v3/src/agent-lifecycle/domain/Agent.ts | 25 +- 68 files changed, 1085 insertions(+), 463 deletions(-) "
8
+ }
@@ -1,28 +1,28 @@
1
- # agent-spawning
2
-
3
- Guide to spawning agents with Claude Code's Task tool.
4
-
5
- ## Using Claude Code's Task Tool
6
-
7
- **CRITICAL**: Always use Claude Code's Task tool for actual agent execution:
8
-
9
- ```javascript
10
- // Spawn ALL agents in ONE message
11
- Task("Researcher", "Analyze requirements...", "researcher")
12
- Task("Coder", "Implement features...", "coder")
13
- Task("Tester", "Create tests...", "tester")
14
- ```
15
-
16
- ## MCP Coordination Setup (Optional)
17
-
18
- MCP tools are ONLY for coordination:
19
- ```javascript
20
- mcp__moflo__swarm_init { topology: "mesh" }
21
- mcp__moflo__agent_spawn { type: "researcher" }
22
- ```
23
-
24
- ## Best Practices
25
- 1. Always spawn agents concurrently
26
- 2. Use Task tool for execution
27
- 3. MCP only for coordination
28
- 4. Batch all operations
1
+ # agent-spawning
2
+
3
+ Guide to spawning agents with Claude Code's Task tool.
4
+
5
+ ## Using Claude Code's Task Tool
6
+
7
+ **CRITICAL**: Always use Claude Code's Task tool for actual agent execution:
8
+
9
+ ```javascript
10
+ // Spawn ALL agents in ONE message
11
+ Task("Researcher", "Analyze requirements...", "researcher")
12
+ Task("Coder", "Implement features...", "coder")
13
+ Task("Tester", "Create tests...", "tester")
14
+ ```
15
+
16
+ ## MCP Coordination Setup (Optional)
17
+
18
+ MCP tools are ONLY for coordination:
19
+ ```javascript
20
+ mcp__moflo__swarm_init { topology: "mesh" }
21
+ mcp__moflo__agent_spawn { type: "researcher" }
22
+ ```
23
+
24
+ ## Best Practices
25
+ 1. Always spawn agents concurrently
26
+ 2. Use Task tool for execution
27
+ 3. MCP only for coordination
28
+ 4. Batch all operations
@@ -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__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" }
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
  ```