moflo 4.9.19 → 4.9.21

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 (82) hide show
  1. package/.claude/commands/{simplify.md → flo-simplify.md} +4 -4
  2. package/.claude/guidance/shipped/moflo-agent-rules.md +172 -0
  3. package/.claude/guidance/shipped/moflo-claude-swarm-cohesion.md +73 -265
  4. package/.claude/guidance/shipped/moflo-cli-reference.md +6 -6
  5. package/.claude/guidance/shipped/moflo-core-guidance.md +66 -184
  6. package/.claude/guidance/shipped/moflo-cross-platform.md +1 -1
  7. package/.claude/guidance/shipped/moflo-error-handling.md +3 -3
  8. package/.claude/guidance/shipped/moflo-guidance-rules.md +17 -7
  9. package/.claude/guidance/shipped/moflo-memory-strategy.md +76 -182
  10. package/.claude/guidance/shipped/moflo-memorydb-maintenance.md +6 -8
  11. package/.claude/guidance/shipped/moflo-settings-injection.md +7 -9
  12. package/.claude/guidance/shipped/moflo-source-hygiene.md +5 -5
  13. package/.claude/guidance/shipped/moflo-spell-connectors.md +3 -4
  14. package/.claude/guidance/shipped/moflo-spell-custom-steps.md +3 -4
  15. package/.claude/guidance/shipped/moflo-spell-engine.md +40 -162
  16. package/.claude/guidance/shipped/moflo-spell-runner.md +134 -0
  17. package/.claude/guidance/shipped/moflo-spell-sandboxing.md +10 -57
  18. package/.claude/guidance/shipped/moflo-spell-troubleshooting.md +149 -0
  19. package/.claude/guidance/shipped/moflo-subagents.md +43 -114
  20. package/.claude/guidance/shipped/moflo-task-icons.md +4 -4
  21. package/.claude/guidance/shipped/moflo-user-facing-language.md +3 -3
  22. package/.claude/guidance/shipped/moflo-verbose-command-filtering.md +3 -3
  23. package/.claude/guidance/shipped/moflo-yaml-reference.md +4 -5
  24. package/.claude/helpers/gate.cjs +124 -14
  25. package/.claude/helpers/prompt-hook.mjs +4 -38
  26. package/.claude/helpers/simplify-classify.cjs +32 -11
  27. package/.claude/helpers/subagent-bootstrap.json +1 -1
  28. package/.claude/helpers/subagent-start.cjs +1 -1
  29. package/.claude/skills/connector-builder/SKILL.md +42 -429
  30. package/.claude/skills/connector-builder/templates/connector.md +189 -0
  31. package/.claude/skills/connector-builder/templates/step-command.md +176 -0
  32. package/.claude/skills/eldar/SKILL.md +7 -7
  33. package/.claude/skills/fl/SKILL.md +3 -3
  34. package/.claude/skills/fl/execution-modes.md +3 -3
  35. package/.claude/skills/fl/phases.md +3 -3
  36. package/.claude/skills/{simplify → flo-simplify}/SKILL.md +11 -11
  37. package/.claude/skills/guidance/SKILL.md +17 -9
  38. package/.claude/skills/memory-patterns/SKILL.md +1 -1
  39. package/.claude/skills/publish/SKILL.md +121 -36
  40. package/.claude/skills/reset-epic/SKILL.md +2 -2
  41. package/.claude/skills/spell-builder/SKILL.md +39 -226
  42. package/.claude/skills/spell-builder/architecture.md +1 -1
  43. package/.claude/skills/spell-builder/permissions.md +107 -0
  44. package/.claude/skills/spell-builder/preflight.md +101 -0
  45. package/.claude/skills/spell-schedule/SKILL.md +2 -3
  46. package/bin/gate.cjs +124 -14
  47. package/bin/prompt-hook.mjs +4 -38
  48. package/bin/session-start-launcher.mjs +66 -1
  49. package/bin/setup-project.mjs +63 -69
  50. package/bin/simplify-classify.cjs +32 -11
  51. package/dist/src/cli/commands/doctor-checks-deep.js +4 -0
  52. package/dist/src/cli/init/claudemd-generator.js +30 -33
  53. package/dist/src/cli/init/executor.js +28 -16
  54. package/dist/src/cli/init/helpers-generator.js +101 -51
  55. package/dist/src/cli/init/moflo-init.js +41 -114
  56. package/dist/src/cli/init/settings-generator.js +32 -14
  57. package/dist/src/cli/services/hook-block-hash.js +7 -2
  58. package/dist/src/cli/services/hook-wiring.js +86 -3
  59. package/dist/src/cli/services/subagent-bootstrap.js +1 -1
  60. package/dist/src/cli/version.js +1 -1
  61. package/package.json +2 -2
  62. package/scripts/post-install-bootstrap.mjs +19 -0
  63. package/.claude/guidance/shipped/moflo-session-start.md +0 -154
  64. package/.claude/guidance/shipped/moflo-spell-engine-architecture.md +0 -145
  65. package/.claude/skills/browser/SKILL.md +0 -204
  66. package/.claude/skills/github-code-review/SKILL.md +0 -1140
  67. package/.claude/skills/github-multi-repo/SKILL.md +0 -866
  68. package/.claude/skills/github-project-management/SKILL.md +0 -1272
  69. package/.claude/skills/github-release-management/SKILL.md +0 -1074
  70. package/.claude/skills/github-workflow-automation/SKILL.md +0 -1060
  71. package/.claude/skills/hive-mind-advanced/SKILL.md +0 -712
  72. package/.claude/skills/hooks-automation/SKILL.md +0 -1193
  73. package/.claude/skills/pair-programming/SKILL.md +0 -1202
  74. package/.claude/skills/performance-analysis/SKILL.md +0 -563
  75. package/.claude/skills/skill-builder/SKILL.md +0 -910
  76. package/.claude/skills/sparc-methodology/SKILL.md +0 -904
  77. package/.claude/skills/stream-chain/SKILL.md +0 -563
  78. package/.claude/skills/swarm-advanced/SKILL.md +0 -811
  79. package/.claude/skills/swarm-orchestration/SKILL.md +0 -179
  80. package/.claude/skills/verification-quality/SKILL.md +0 -649
  81. package/.claude/skills/worker-benchmarks/skill.md +0 -135
  82. package/.claude/skills/worker-integration/skill.md +0 -154
@@ -1,204 +0,0 @@
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 moflo memory store --namespace browser-patterns --key "login-flow" --value "snapshot->fill->click->wait"
184
-
185
- # Retrieve before similar task
186
- npx moflo memory search --query "login automation"
187
- ```
188
-
189
- ### Hooks
190
- ```bash
191
- # Pre-browse hook (get context)
192
- npx moflo hooks pre-edit --file "browser-task.ts"
193
-
194
- # Post-browse hook (record success)
195
- npx moflo 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