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
@@ -0,0 +1,204 @@
1
+ ---
2
+ name: browser
3
+ description: Web browser automation with AI-optimized snapshots for claude-flow agents
4
+ version: 1.0.0
5
+ triggers:
6
+ - /browser
7
+ - browse
8
+ - web automation
9
+ - scrape
10
+ - navigate
11
+ - screenshot
12
+ tools:
13
+ - browser/open
14
+ - browser/snapshot
15
+ - browser/click
16
+ - browser/fill
17
+ - browser/screenshot
18
+ - browser/close
19
+ ---
20
+
21
+ # Browser Automation Skill
22
+
23
+ Web browser automation using agent-browser with AI-optimized snapshots. Reduces context by 93% using element refs (@e1, @e2) instead of full DOM.
24
+
25
+ ## Core Workflow
26
+
27
+ ```bash
28
+ # 1. Navigate to page
29
+ agent-browser open <url>
30
+
31
+ # 2. Get accessibility tree with element refs
32
+ agent-browser snapshot -i # -i = interactive elements only
33
+
34
+ # 3. Interact using refs from snapshot
35
+ agent-browser click @e2
36
+ agent-browser fill @e3 "text"
37
+
38
+ # 4. Re-snapshot after page changes
39
+ agent-browser snapshot -i
40
+ ```
41
+
42
+ ## Quick Reference
43
+
44
+ ### Navigation
45
+ | Command | Description |
46
+ |---------|-------------|
47
+ | `open <url>` | Navigate to URL |
48
+ | `back` | Go back |
49
+ | `forward` | Go forward |
50
+ | `reload` | Reload page |
51
+ | `close` | Close browser |
52
+
53
+ ### Snapshots (AI-Optimized)
54
+ | Command | Description |
55
+ |---------|-------------|
56
+ | `snapshot` | Full accessibility tree |
57
+ | `snapshot -i` | Interactive elements only (buttons, links, inputs) |
58
+ | `snapshot -c` | Compact (remove empty elements) |
59
+ | `snapshot -d 3` | Limit depth to 3 levels |
60
+ | `screenshot [path]` | Capture screenshot (base64 if no path) |
61
+
62
+ ### Interaction
63
+ | Command | Description |
64
+ |---------|-------------|
65
+ | `click <sel>` | Click element |
66
+ | `fill <sel> <text>` | Clear and fill input |
67
+ | `type <sel> <text>` | Type with key events |
68
+ | `press <key>` | Press key (Enter, Tab, etc.) |
69
+ | `hover <sel>` | Hover element |
70
+ | `select <sel> <val>` | Select dropdown option |
71
+ | `check/uncheck <sel>` | Toggle checkbox |
72
+ | `scroll <dir> [px]` | Scroll page |
73
+
74
+ ### Get Info
75
+ | Command | Description |
76
+ |---------|-------------|
77
+ | `get text <sel>` | Get text content |
78
+ | `get html <sel>` | Get innerHTML |
79
+ | `get value <sel>` | Get input value |
80
+ | `get attr <sel> <attr>` | Get attribute |
81
+ | `get title` | Get page title |
82
+ | `get url` | Get current URL |
83
+
84
+ ### Wait
85
+ | Command | Description |
86
+ |---------|-------------|
87
+ | `wait <selector>` | Wait for element |
88
+ | `wait <ms>` | Wait milliseconds |
89
+ | `wait --text "text"` | Wait for text |
90
+ | `wait --url "pattern"` | Wait for URL |
91
+ | `wait --load networkidle` | Wait for load state |
92
+
93
+ ### Sessions
94
+ | Command | Description |
95
+ |---------|-------------|
96
+ | `--session <name>` | Use isolated session |
97
+ | `session list` | List active sessions |
98
+
99
+ ## Selectors
100
+
101
+ ### Element Refs (Recommended)
102
+ ```bash
103
+ # Get refs from snapshot
104
+ agent-browser snapshot -i
105
+ # Output: button "Submit" [ref=e2]
106
+
107
+ # Use ref to interact
108
+ agent-browser click @e2
109
+ ```
110
+
111
+ ### CSS Selectors
112
+ ```bash
113
+ agent-browser click "#submit"
114
+ agent-browser fill ".email-input" "test@test.com"
115
+ ```
116
+
117
+ ### Semantic Locators
118
+ ```bash
119
+ agent-browser find role button click --name "Submit"
120
+ agent-browser find label "Email" fill "test@test.com"
121
+ agent-browser find testid "login-btn" click
122
+ ```
123
+
124
+ ## Examples
125
+
126
+ ### Login Flow
127
+ ```bash
128
+ agent-browser open https://example.com/login
129
+ agent-browser snapshot -i
130
+ agent-browser fill @e2 "user@example.com"
131
+ agent-browser fill @e3 "password123"
132
+ agent-browser click @e4
133
+ agent-browser wait --url "**/dashboard"
134
+ ```
135
+
136
+ ### Form Submission
137
+ ```bash
138
+ agent-browser open https://example.com/contact
139
+ agent-browser snapshot -i
140
+ agent-browser fill @e1 "John Doe"
141
+ agent-browser fill @e2 "john@example.com"
142
+ agent-browser fill @e3 "Hello, this is my message"
143
+ agent-browser click @e4
144
+ agent-browser wait --text "Thank you"
145
+ ```
146
+
147
+ ### Data Extraction
148
+ ```bash
149
+ agent-browser open https://example.com/products
150
+ agent-browser snapshot -i
151
+ # Iterate through product refs
152
+ agent-browser get text @e1 # Product name
153
+ agent-browser get text @e2 # Price
154
+ agent-browser get attr @e3 href # Link
155
+ ```
156
+
157
+ ### Multi-Session (Swarm)
158
+ ```bash
159
+ # Session 1: Navigator
160
+ agent-browser --session nav open https://example.com
161
+ agent-browser --session nav state save auth.json
162
+
163
+ # Session 2: Scraper (uses same auth)
164
+ agent-browser --session scrape state load auth.json
165
+ agent-browser --session scrape open https://example.com/data
166
+ agent-browser --session scrape snapshot -i
167
+ ```
168
+
169
+ ## Integration with Claude Flow
170
+
171
+ ### MCP Tools
172
+ All browser operations are available as MCP tools with `browser/` prefix:
173
+ - `browser/open`
174
+ - `browser/snapshot`
175
+ - `browser/click`
176
+ - `browser/fill`
177
+ - `browser/screenshot`
178
+ - etc.
179
+
180
+ ### Memory Integration
181
+ ```bash
182
+ # Store successful patterns
183
+ npx @claude-flow/cli memory store --namespace browser-patterns --key "login-flow" --value "snapshot->fill->click->wait"
184
+
185
+ # Retrieve before similar task
186
+ npx @claude-flow/cli memory search --query "login automation"
187
+ ```
188
+
189
+ ### Hooks
190
+ ```bash
191
+ # Pre-browse hook (get context)
192
+ npx @claude-flow/cli hooks pre-edit --file "browser-task.ts"
193
+
194
+ # Post-browse hook (record success)
195
+ npx @claude-flow/cli hooks post-task --task-id "browse-1" --success true
196
+ ```
197
+
198
+ ## Tips
199
+
200
+ 1. **Always use snapshots** - They're optimized for AI with refs
201
+ 2. **Prefer `-i` flag** - Gets only interactive elements, smaller output
202
+ 3. **Use refs, not selectors** - More reliable, deterministic
203
+ 4. **Re-snapshot after navigation** - Page state changes
204
+ 5. **Use sessions for parallel work** - Each session is isolated
@@ -13,7 +13,7 @@ Research, create tickets for, and execute GitHub issues automatically.
13
13
  ## Usage
14
14
 
15
15
  ```
16
- /flo <issue-number> # Full workflow with SWARM (default)
16
+ /flo <issue-number> # Full workflow in NORMAL mode (default)
17
17
  /flo -t <issue-number> # Ticket only: research and update ticket, then STOP
18
18
  /flo -t <title> # Create a NEW ticket with description, acceptance criteria, test cases
19
19
  /flo --ticket <issue-number|title> # Same as -t
@@ -26,8 +26,8 @@ Also available as `/fl` (shorthand alias).
26
26
  ### Execution Mode (how work is done)
27
27
 
28
28
  ```
29
- /flo 123 # SWARM mode (default) - multi-agent coordination
30
- /flo -s 123 # SWARM mode (explicit)
29
+ /flo 123 # NORMAL mode (default) - single-agent execution
30
+ /flo -s 123 # SWARM mode - multi-agent coordination
31
31
  /flo --swarm 123 # Same as -s
32
32
  /flo -h 123 # HIVE-MIND mode - consensus-based coordination
33
33
  /flo --hive 123 # Same as -h
@@ -58,22 +58,27 @@ Also available as `/fl` (shorthand alias).
58
58
  ### Combined Examples
59
59
 
60
60
  ```
61
- /flo 123 # Swarm + full workflow (default) - includes ALL tests
61
+ /flo 123 # Normal + full workflow (default) - includes ALL tests
62
62
  /flo 42 # If #42 is epic, processes stories sequentially
63
- /flo -t 123 # Swarm + ticket only (no implementation)
63
+ /flo -s 123 # Swarm + full workflow (multi-agent coordination)
64
+ /flo -t 123 # Normal + ticket only (no implementation)
64
65
  /flo -h -t 123 # Hive-mind + ticket only
65
- /flo -n -r 123 # Normal + research only
66
+ /flo -s -r 123 # Swarm + research only
66
67
  /flo --swarm --ticket 123 # Explicit swarm + ticket only
67
- /flo -n 123 # Normal + full workflow (still runs all tests)
68
+ /flo -n 123 # Normal (explicit, same as default)
68
69
  ```
69
70
 
70
- ## SWARM IS MANDATORY BY DEFAULT
71
+ ## NORMAL MODE IS THE DEFAULT
71
72
 
72
- Even if a task "looks simple", you MUST use swarm coordination unless
73
- the user explicitly passes -n/--normal. "Simple" is a trap. Tasks have
74
- hidden complexity. Swarm catches it.
73
+ By default, /flo runs in NORMAL mode single-agent execution without
74
+ spawning sub-agents. This is efficient for most tasks.
75
75
 
76
- THE ONLY WAY TO SKIP SWARM: User passes -n or --normal explicitly.
76
+ Use `-s`/`--swarm` for multi-agent coordination when the task warrants it.
77
+ Use `-h`/`--hive` for consensus-based coordination on architecture decisions.
78
+
79
+ POST-TASK NEURAL LEARNING ALWAYS RUNS regardless of execution mode.
80
+ The hooks system collects learnings after every task completion — normal,
81
+ swarm, or hive-mind.
77
82
 
78
83
  ## COMPREHENSIVE TESTING REQUIREMENT
79
84
 
@@ -107,9 +112,9 @@ PR+Done: Create PR, update issue status, store learnings
107
112
 
108
113
  | Mode | Description |
109
114
  |------|-------------|
110
- | **SWARM** (default) | Multi-agent via Task tool: researcher, coder, tester, reviewer |
115
+ | **NORMAL** (default) | Single Claude execution. Efficient for most tasks. |
116
+ | **SWARM** (-s) | Multi-agent via Task tool: researcher, coder, tester, reviewer |
111
117
  | **HIVE-MIND** (-h) | Consensus-based coordination for architecture decisions |
112
- | **NORMAL** (-n) | Single Claude, no agent spawning. Only when user explicitly requests. |
113
118
 
114
119
  ## Phase 1: Research (-r or default first step)
115
120
 
@@ -133,7 +138,7 @@ npx flo memory search --query "<issue title keywords>" --namespace patterns
133
138
  npx flo memory search --query "<domain keywords>" --namespace guidance
134
139
  ```
135
140
 
136
- Or via MCP: `mcp__claude-flow__memory_search`
141
+ Or via MCP: `mcp__moflo__memory_search`
137
142
 
138
143
  ### 1.4 Read Guidance Docs (ONLY if memory insufficient)
139
144
  **Only if memory search returned < 3 relevant results**, read guidance files:
@@ -305,7 +310,7 @@ WORKFLOW STOPS HERE until tests pass. No shortcuts. No exceptions.
305
310
 
306
311
  ### 4.1 Write and Run Tests
307
312
  Write unit, integration, and E2E tests as appropriate for the change type.
308
- Use the project's existing test runner and patterns.
313
+ Follow the project's established test style, runner, and patterns. If no existing tests or test guidance is present, choose the best options for the project's language and stack, taking compatibility with existing dependencies into account.
309
314
 
310
315
  ### 4.2 Test Auto-Fix Loop
311
316
  If any tests fail, enter the auto-fix loop (max 3 retries OR 10 minutes):
@@ -450,7 +455,7 @@ function extractStories(epicBody) {
450
455
  ```javascript
451
456
  const args = "$ARGUMENTS".trim().split(/\s+/);
452
457
  let workflowMode = "full"; // full, ticket, research
453
- let execMode = "swarm"; // swarm (default), hive, normal
458
+ let execMode = "normal"; // normal (default), swarm, hive
454
459
  let issueNumber = null;
455
460
  let titleWords = [];
456
461
 
@@ -515,15 +520,15 @@ console.log("SIMPLIFY: /simplify command runs on changed code before PR.");
515
520
 
516
521
  | Mode | Flag | Description | When to Use |
517
522
  |------|------|-------------|-------------|
518
- | **Swarm** (DEFAULT) | `-s`, `--swarm` | Multi-agent via Task tool | Always, unless explicitly overridden |
523
+ | **Normal** (DEFAULT) | `-n`, `--normal` | Single Claude, no agents | Default for most tasks |
524
+ | **Swarm** | `-s`, `--swarm` | Multi-agent via Task tool | Complex multi-file changes |
519
525
  | **Hive-Mind** | `-h`, `--hive` | Consensus-based coordination | Architecture decisions, tradeoffs |
520
- | **Normal** | `-n`, `--normal` | Single Claude, no agents | User explicitly wants simple mode |
521
526
 
522
527
  ## Execution Mode Details
523
528
 
524
- ### SWARM Mode (Default) - ALWAYS USE UNLESS TOLD OTHERWISE
529
+ ### SWARM Mode (-s, --swarm)
525
530
 
526
- You MUST use the Task tool to spawn agents. No exceptions.
531
+ When swarm is requested, you MUST use the Task tool to spawn agents. No exceptions.
527
532
 
528
533
  **Swarm spawns these agents via Task tool:**
529
534
  - `researcher` - Analyzes issue, searches memory, finds patterns
@@ -558,11 +563,12 @@ Use for consensus-based decisions:
558
563
  - Approach tradeoffs
559
564
  - Design decisions with multiple valid options
560
565
 
561
- ### NORMAL Mode (-n, --normal)
566
+ ### NORMAL Mode (Default)
562
567
 
563
- **Only when user explicitly requests.** Single Claude execution without agents.
568
+ Single Claude execution without spawning sub-agents.
564
569
  - Still uses Task tool for tracking
565
570
  - Still creates tasks for visibility
571
+ - Post-task neural learning hooks still fire
566
572
  - Just doesn't spawn multiple agents
567
573
 
568
574
  ---
@@ -13,7 +13,7 @@ Research, create tickets for, and execute GitHub issues automatically.
13
13
  ## Usage
14
14
 
15
15
  ```
16
- /flo <issue-number> # Full workflow with SWARM (default)
16
+ /flo <issue-number> # Full workflow in NORMAL mode (default)
17
17
  /flo -t <issue-number> # Ticket only: research and update ticket, then STOP
18
18
  /flo -t <title> # Create a NEW ticket with description, acceptance criteria, test cases
19
19
  /flo --ticket <issue-number|title> # Same as -t
@@ -26,8 +26,8 @@ Also available as `/fl` (shorthand alias).
26
26
  ### Execution Mode (how work is done)
27
27
 
28
28
  ```
29
- /flo 123 # SWARM mode (default) - multi-agent coordination
30
- /flo -s 123 # SWARM mode (explicit)
29
+ /flo 123 # NORMAL mode (default) - single-agent execution
30
+ /flo -s 123 # SWARM mode - multi-agent coordination
31
31
  /flo --swarm 123 # Same as -s
32
32
  /flo -h 123 # HIVE-MIND mode - consensus-based coordination
33
33
  /flo --hive 123 # Same as -h
@@ -58,22 +58,27 @@ Also available as `/fl` (shorthand alias).
58
58
  ### Combined Examples
59
59
 
60
60
  ```
61
- /flo 123 # Swarm + full workflow (default) - includes ALL tests
61
+ /flo 123 # Normal + full workflow (default) - includes ALL tests
62
62
  /flo 42 # If #42 is epic, processes stories sequentially
63
- /flo -t 123 # Swarm + ticket only (no implementation)
63
+ /flo -s 123 # Swarm + full workflow (multi-agent coordination)
64
+ /flo -t 123 # Normal + ticket only (no implementation)
64
65
  /flo -h -t 123 # Hive-mind + ticket only
65
- /flo -n -r 123 # Normal + research only
66
+ /flo -s -r 123 # Swarm + research only
66
67
  /flo --swarm --ticket 123 # Explicit swarm + ticket only
67
- /flo -n 123 # Normal + full workflow (still runs all tests)
68
+ /flo -n 123 # Normal (explicit, same as default)
68
69
  ```
69
70
 
70
- ## SWARM IS MANDATORY BY DEFAULT
71
+ ## NORMAL MODE IS THE DEFAULT
71
72
 
72
- Even if a task "looks simple", you MUST use swarm coordination unless
73
- the user explicitly passes -n/--normal. "Simple" is a trap. Tasks have
74
- hidden complexity. Swarm catches it.
73
+ By default, /flo runs in NORMAL mode single-agent execution without
74
+ spawning sub-agents. This is efficient for most tasks.
75
75
 
76
- THE ONLY WAY TO SKIP SWARM: User passes -n or --normal explicitly.
76
+ Use `-s`/`--swarm` for multi-agent coordination when the task warrants it.
77
+ Use `-h`/`--hive` for consensus-based coordination on architecture decisions.
78
+
79
+ POST-TASK NEURAL LEARNING ALWAYS RUNS regardless of execution mode.
80
+ The hooks system collects learnings after every task completion — normal,
81
+ swarm, or hive-mind.
77
82
 
78
83
  ## COMPREHENSIVE TESTING REQUIREMENT
79
84
 
@@ -107,9 +112,9 @@ PR+Done: Create PR, update issue status, store learnings
107
112
 
108
113
  | Mode | Description |
109
114
  |------|-------------|
110
- | **SWARM** (default) | Multi-agent via Task tool: researcher, coder, tester, reviewer |
115
+ | **NORMAL** (default) | Single Claude execution. Efficient for most tasks. |
116
+ | **SWARM** (-s) | Multi-agent via Task tool: researcher, coder, tester, reviewer |
111
117
  | **HIVE-MIND** (-h) | Consensus-based coordination for architecture decisions |
112
- | **NORMAL** (-n) | Single Claude, no agent spawning. Only when user explicitly requests. |
113
118
 
114
119
  ## Phase 1: Research (-r or default first step)
115
120
 
@@ -133,7 +138,7 @@ npx flo memory search --query "<issue title keywords>" --namespace patterns
133
138
  npx flo memory search --query "<domain keywords>" --namespace guidance
134
139
  ```
135
140
 
136
- Or via MCP: `mcp__claude-flow__memory_search`
141
+ Or via MCP: `mcp__moflo__memory_search`
137
142
 
138
143
  ### 1.4 Read Guidance Docs (ONLY if memory insufficient)
139
144
  **Only if memory search returned < 3 relevant results**, read guidance files:
@@ -305,7 +310,7 @@ WORKFLOW STOPS HERE until tests pass. No shortcuts. No exceptions.
305
310
 
306
311
  ### 4.1 Write and Run Tests
307
312
  Write unit, integration, and E2E tests as appropriate for the change type.
308
- Use the project's existing test runner and patterns.
313
+ Follow the project's established test style, runner, and patterns. If no existing tests or test guidance is present, choose the best options for the project's language and stack, taking compatibility with existing dependencies into account.
309
314
 
310
315
  ### 4.2 Test Auto-Fix Loop
311
316
  If any tests fail, enter the auto-fix loop (max 3 retries OR 10 minutes):
@@ -450,7 +455,7 @@ function extractStories(epicBody) {
450
455
  ```javascript
451
456
  const args = "$ARGUMENTS".trim().split(/\s+/);
452
457
  let workflowMode = "full"; // full, ticket, research
453
- let execMode = "swarm"; // swarm (default), hive, normal
458
+ let execMode = "normal"; // normal (default), swarm, hive
454
459
  let issueNumber = null;
455
460
  let titleWords = [];
456
461
 
@@ -515,15 +520,15 @@ console.log("SIMPLIFY: /simplify command runs on changed code before PR.");
515
520
 
516
521
  | Mode | Flag | Description | When to Use |
517
522
  |------|------|-------------|-------------|
518
- | **Swarm** (DEFAULT) | `-s`, `--swarm` | Multi-agent via Task tool | Always, unless explicitly overridden |
523
+ | **Normal** (DEFAULT) | `-n`, `--normal` | Single Claude, no agents | Default for most tasks |
524
+ | **Swarm** | `-s`, `--swarm` | Multi-agent via Task tool | Complex multi-file changes |
519
525
  | **Hive-Mind** | `-h`, `--hive` | Consensus-based coordination | Architecture decisions, tradeoffs |
520
- | **Normal** | `-n`, `--normal` | Single Claude, no agents | User explicitly wants simple mode |
521
526
 
522
527
  ## Execution Mode Details
523
528
 
524
- ### SWARM Mode (Default) - ALWAYS USE UNLESS TOLD OTHERWISE
529
+ ### SWARM Mode (-s, --swarm)
525
530
 
526
- You MUST use the Task tool to spawn agents. No exceptions.
531
+ When swarm is requested, you MUST use the Task tool to spawn agents. No exceptions.
527
532
 
528
533
  **Swarm spawns these agents via Task tool:**
529
534
  - `researcher` - Analyzes issue, searches memory, finds patterns
@@ -558,11 +563,12 @@ Use for consensus-based decisions:
558
563
  - Approach tradeoffs
559
564
  - Design decisions with multiple valid options
560
565
 
561
- ### NORMAL Mode (-n, --normal)
566
+ ### NORMAL Mode (Default)
562
567
 
563
- **Only when user explicitly requests.** Single Claude execution without agents.
568
+ Single Claude execution without spawning sub-agents.
564
569
  - Still uses Task tool for tracking
565
570
  - Still creates tasks for visibility
571
+ - Post-task neural learning hooks still fire
566
572
  - Just doesn't spawn multiple agents
567
573
 
568
574
  ---
@@ -1027,10 +1027,10 @@ fi
1027
1027
  ```javascript
1028
1028
  [Single Message - Parallel Execution]:
1029
1029
  // Initialize coordination
1030
- mcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }
1031
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
1032
- mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
1033
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "Merge Coordinator" }
1030
+ mcp__moflo__swarm_init { topology: "hierarchical", maxAgents: 5 }
1031
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Senior Reviewer" }
1032
+ mcp__moflo__agent_spawn { type: "tester", name: "QA Engineer" }
1033
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Merge Coordinator" }
1034
1034
 
1035
1035
  // Create and manage PR using gh CLI
1036
1036
  Bash("gh pr create --title 'Feature: Add authentication' --base main")
@@ -90,7 +90,7 @@ const DEPS = Bash(`gh repo list my-organization --json name | \
90
90
  done | jq -s '.'`)
91
91
 
92
92
  // Initialize swarm with discovered repositories
93
- mcp__claude-flow__swarm_init({
93
+ mcp__moflo__swarm_init({
94
94
  topology: "hierarchical",
95
95
  maxAgents: 8,
96
96
  metadata: { repos: REPOS, dependencies: DEPS }
@@ -145,7 +145,7 @@ mcp__claude-flow__swarm_init({
145
145
  // Synchronize package dependencies and versions
146
146
  [Complete Package Sync]:
147
147
  // Initialize sync swarm
148
- mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 5 })
148
+ mcp__moflo__swarm_init({ topology: "mesh", maxAgents: 5 })
149
149
 
150
150
  // Spawn sync agents
151
151
  Task("Sync Coordinator", "Coordinate version alignment", "coordinator")
@@ -169,7 +169,7 @@ mcp__claude-flow__swarm_init({
169
169
  -f content="$(cat aligned-package.json | base64)"`)
170
170
 
171
171
  // Store sync state
172
- mcp__claude-flow__memory_usage({
172
+ mcp__moflo__memory_usage({
173
173
  action: "store",
174
174
  key: "sync/packages/status",
175
175
  value: {
@@ -196,7 +196,7 @@ mcp__claude-flow__swarm_init({
196
196
  -f content="$(cat /tmp/claude-source.md | base64)"`)
197
197
 
198
198
  // Track sync status
199
- mcp__claude-flow__memory_usage({
199
+ mcp__moflo__memory_usage({
200
200
  action: "store",
201
201
  key: "sync/documentation/status",
202
202
  value: { status: "synchronized", files: ["CLAUDE.md"] }
@@ -246,7 +246,7 @@ mcp__claude-flow__swarm_init({
246
246
  // Analyze and optimize repository structure
247
247
  [Architecture Analysis]:
248
248
  // Initialize architecture swarm
249
- mcp__claude-flow__swarm_init({ topology: "hierarchical", maxAgents: 6 })
249
+ mcp__moflo__swarm_init({ topology: "hierarchical", maxAgents: 6 })
250
250
 
251
251
  // Spawn architecture agents
252
252
  Task("Senior Architect", "Analyze repository structure", "architect")
@@ -266,7 +266,7 @@ mcp__claude-flow__swarm_init({
266
266
  --order desc`)
267
267
 
268
268
  // Store analysis results
269
- mcp__claude-flow__memory_usage({
269
+ mcp__moflo__memory_usage({
270
270
  action: "store",
271
271
  key: "architecture/analysis/results",
272
272
  value: {
@@ -406,7 +406,7 @@ Part of #$TRACKING_ISSUE"
406
406
  // Coordinate large-scale refactoring
407
407
  [Cross-Repo Refactoring]:
408
408
  // Initialize refactoring swarm
409
- mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 8 })
409
+ mcp__moflo__swarm_init({ topology: "mesh", maxAgents: 8 })
410
410
 
411
411
  // Spawn specialized agents
412
412
  Task("Refactoring Coordinator", "Coordinate refactoring across repos", "coordinator")
@@ -416,7 +416,7 @@ Part of #$TRACKING_ISSUE"
416
416
  Task("Integration Tester", "Validate refactored code", "tester")
417
417
 
418
418
  // Execute refactoring
419
- mcp__claude-flow__task_orchestrate({
419
+ mcp__moflo__task_orchestrate({
420
420
  task: "Rename OldAPI to NewAPI across all repositories",
421
421
  strategy: "sequential",
422
422
  priority: "high"
@@ -20,7 +20,7 @@ prerequisites:
20
20
  - Repository access permissions
21
21
  tools_required:
22
22
  - mcp__github__*
23
- - mcp__claude-flow__*
23
+ - mcp__moflo__*
24
24
  - Bash
25
25
  - Read
26
26
  - Write
@@ -79,10 +79,10 @@ npx ruv-swarm github board-init \
79
79
 
80
80
  ```javascript
81
81
  // Initialize issue management swarm
82
- mcp__claude-flow__swarm_init { topology: "star", maxAgents: 3 }
83
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
84
- mcp__claude-flow__agent_spawn { type: "researcher", name: "Requirements Analyst" }
85
- mcp__claude-flow__agent_spawn { type: "coder", name: "Implementation Planner" }
82
+ mcp__moflo__swarm_init { topology: "star", maxAgents: 3 }
83
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Issue Coordinator" }
84
+ mcp__moflo__agent_spawn { type: "researcher", name: "Requirements Analyst" }
85
+ mcp__moflo__agent_spawn { type: "coder", name: "Implementation Planner" }
86
86
 
87
87
  // Create comprehensive issue
88
88
  mcp__github__create_issue {
@@ -107,7 +107,7 @@ mcp__github__create_issue {
107
107
  }
108
108
 
109
109
  // Set up automated tracking
110
- mcp__claude-flow__task_orchestrate {
110
+ mcp__moflo__task_orchestrate {
111
111
  task: "Monitor and coordinate issue progress with automated updates",
112
112
  strategy: "adaptive",
113
113
  priority: "medium"
@@ -150,19 +150,19 @@ gh release create $(npm pkg get version) \
150
150
  ```javascript
151
151
  // Set up coordinated release team
152
152
  [Single Message - Swarm Initialization]:
153
- mcp__claude-flow__swarm_init {
153
+ mcp__moflo__swarm_init {
154
154
  topology: "hierarchical",
155
155
  maxAgents: 6,
156
156
  strategy: "balanced"
157
157
  }
158
158
 
159
159
  // Spawn specialized agents
160
- mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
161
- mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
162
- mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
163
- mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
164
- mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
165
- mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
160
+ mcp__moflo__agent_spawn { type: "coordinator", name: "Release Director" }
161
+ mcp__moflo__agent_spawn { type: "coder", name: "Version Manager" }
162
+ mcp__moflo__agent_spawn { type: "tester", name: "QA Engineer" }
163
+ mcp__moflo__agent_spawn { type: "reviewer", name: "Release Reviewer" }
164
+ mcp__moflo__agent_spawn { type: "analyst", name: "Deployment Analyst" }
165
+ mcp__moflo__agent_spawn { type: "researcher", name: "Compatibility Checker" }
166
166
  ```
167
167
 
168
168
  #### Coordinated Release Workflow
@@ -172,7 +172,7 @@ gh release create $(npm pkg get version) \
172
172
  Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v2.0.0' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
173
173
 
174
174
  // Orchestrate release preparation
175
- mcp__claude-flow__task_orchestrate {
175
+ mcp__moflo__task_orchestrate {
176
176
  task: "Prepare release v2.0.0 with comprehensive testing and validation",
177
177
  strategy: "sequential",
178
178
  priority: "critical",
@@ -204,7 +204,7 @@ gh release create $(npm pkg get version) \
204
204
  ]}
205
205
 
206
206
  // Store release state
207
- mcp__claude-flow__memory_usage {
207
+ mcp__moflo__memory_usage {
208
208
  action: "store",
209
209
  key: "release/v2.0.0/status",
210
210
  value: JSON.stringify({
@@ -309,7 +309,7 @@ npx claude-flow github release-deploy \
309
309
  ```javascript
310
310
  [Single Message - Multi-Package Release]:
311
311
  // Initialize mesh topology for cross-package coordination
312
- mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 8 }
312
+ mcp__moflo__swarm_init { topology: "mesh", maxAgents: 8 }
313
313
 
314
314
  // Spawn package-specific agents
315
315
  Task("Package A Manager", "Coordinate claude-flow package release v1.0.72", "coder")
@@ -394,7 +394,7 @@ npx claude-flow github multi-release \
394
394
  ```javascript
395
395
  [Single Message - Cross-Repo Release]:
396
396
  // Initialize star topology for centralized coordination
397
- mcp__claude-flow__swarm_init { topology: "star", maxAgents: 6 }
397
+ mcp__moflo__swarm_init { topology: "star", maxAgents: 6 }
398
398
 
399
399
  // Spawn repo-specific coordinators
400
400
  Task("Frontend Release", "Release frontend v2.0.0 with API compatibility", "coordinator")
@@ -408,7 +408,7 @@ npx claude-flow github multi-release \
408
408
  Bash("gh api repos/org/cli/dispatches --method POST -f event_type='release' -F client_payload[version]=v1.5.0")
409
409
 
410
410
  // Monitor all releases
411
- mcp__claude-flow__swarm_monitor { interval: 5, duration: 300 }
411
+ mcp__moflo__swarm_monitor { interval: 5, duration: 300 }
412
412
  ```
413
413
 
414
414
  ### Hotfix Emergency Procedures