@poolzin/pool-bot 2026.3.13 → 2026.3.15

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 (186) hide show
  1. package/CHANGELOG.md +87 -0
  2. package/dist/agents/checkpoint-manager.js +291 -0
  3. package/dist/agents/poolbot-tools.js +5 -0
  4. package/dist/agents/subagent-announce-reliability.js +160 -0
  5. package/dist/agents/tool-result-truncation.js +299 -0
  6. package/dist/agents/tools/nodes-file-tool.js +197 -0
  7. package/dist/build-info.json +3 -3
  8. package/dist/cli/config-cli.js +60 -0
  9. package/dist/cron/cron-improvements.js +195 -0
  10. package/dist/discord/discord-improvements.js +167 -0
  11. package/dist/gateway/auth-rate-limit.js +19 -0
  12. package/dist/gateway/auth.js +41 -0
  13. package/dist/gateway/gateway-improvements.js +294 -0
  14. package/dist/gateway/node-command-policy.js +7 -2
  15. package/dist/infra/net/ssrf.js +15 -2
  16. package/dist/infra/shell-security.js +201 -0
  17. package/dist/memory/memory-improvements.js +239 -0
  18. package/dist/node-host/runner.js +146 -79
  19. package/dist/security/prototype-pollution.js +141 -0
  20. package/dist/security/webhook-security.js +253 -0
  21. package/dist/shared/net/ip.js +52 -1
  22. package/dist/slack/slack-improvements.js +225 -0
  23. package/dist/telegram/telegram-improvements.js +220 -0
  24. package/dist/ui-plugins/ui-plugins-improvements.js +191 -0
  25. package/docs/ANALISE_OPENCLAW_PROFISSIONAL.md +520 -0
  26. package/docs/competitive-analysis.md +421 -0
  27. package/docs/implementation-analysis.md +393 -0
  28. package/docs/plans/2026-03-11-file-operations-security-hardening.md +307 -0
  29. package/docs/plans/2026-03-11-integracao-projetos-poolbot.md +666 -0
  30. package/extensions/agency-agents/README.md +301 -0
  31. package/extensions/agency-agents/agents/CONTRIBUTING.md +353 -0
  32. package/extensions/agency-agents/agents/README.md +602 -0
  33. package/extensions/agency-agents/agents/design/design-brand-guardian.md +320 -0
  34. package/extensions/agency-agents/agents/design/design-image-prompt-engineer.md +234 -0
  35. package/extensions/agency-agents/agents/design/design-ui-designer.md +381 -0
  36. package/extensions/agency-agents/agents/design/design-ux-architect.md +467 -0
  37. package/extensions/agency-agents/agents/design/design-ux-researcher.md +327 -0
  38. package/extensions/agency-agents/agents/design/design-visual-storyteller.md +147 -0
  39. package/extensions/agency-agents/agents/design/design-whimsy-injector.md +436 -0
  40. package/extensions/agency-agents/agents/engineering/engineering-ai-engineer.md +144 -0
  41. package/extensions/agency-agents/agents/engineering/engineering-backend-architect.md +233 -0
  42. package/extensions/agency-agents/agents/engineering/engineering-devops-automator.md +374 -0
  43. package/extensions/agency-agents/agents/engineering/engineering-frontend-developer.md +223 -0
  44. package/extensions/agency-agents/agents/engineering/engineering-mobile-app-builder.md +491 -0
  45. package/extensions/agency-agents/agents/engineering/engineering-rapid-prototyper.md +460 -0
  46. package/extensions/agency-agents/agents/engineering/engineering-security-engineer.md +275 -0
  47. package/extensions/agency-agents/agents/engineering/engineering-senior-developer.md +174 -0
  48. package/extensions/agency-agents/agents/examples/README.md +48 -0
  49. package/extensions/agency-agents/agents/examples/nexus-spatial-discovery.md +852 -0
  50. package/extensions/agency-agents/agents/examples/workflow-landing-page.md +119 -0
  51. package/extensions/agency-agents/agents/examples/workflow-startup-mvp.md +155 -0
  52. package/extensions/agency-agents/agents/integrations/README.md +117 -0
  53. package/extensions/agency-agents/agents/integrations/aider/README.md +38 -0
  54. package/extensions/agency-agents/agents/integrations/antigravity/README.md +49 -0
  55. package/extensions/agency-agents/agents/integrations/claude-code/README.md +31 -0
  56. package/extensions/agency-agents/agents/integrations/cursor/README.md +38 -0
  57. package/extensions/agency-agents/agents/integrations/gemini-cli/README.md +36 -0
  58. package/extensions/agency-agents/agents/integrations/opencode/README.md +58 -0
  59. package/extensions/agency-agents/agents/integrations/windsurf/README.md +26 -0
  60. package/extensions/agency-agents/agents/marketing/marketing-app-store-optimizer.md +319 -0
  61. package/extensions/agency-agents/agents/marketing/marketing-content-creator.md +52 -0
  62. package/extensions/agency-agents/agents/marketing/marketing-growth-hacker.md +52 -0
  63. package/extensions/agency-agents/agents/marketing/marketing-instagram-curator.md +111 -0
  64. package/extensions/agency-agents/agents/marketing/marketing-reddit-community-builder.md +121 -0
  65. package/extensions/agency-agents/agents/marketing/marketing-social-media-strategist.md +123 -0
  66. package/extensions/agency-agents/agents/marketing/marketing-tiktok-strategist.md +123 -0
  67. package/extensions/agency-agents/agents/marketing/marketing-twitter-engager.md +124 -0
  68. package/extensions/agency-agents/agents/marketing/marketing-wechat-official-account.md +143 -0
  69. package/extensions/agency-agents/agents/marketing/marketing-xiaohongshu-specialist.md +136 -0
  70. package/extensions/agency-agents/agents/marketing/marketing-zhihu-strategist.md +160 -0
  71. package/extensions/agency-agents/agents/product/product-feedback-synthesizer.md +117 -0
  72. package/extensions/agency-agents/agents/product/product-sprint-prioritizer.md +152 -0
  73. package/extensions/agency-agents/agents/product/product-trend-researcher.md +157 -0
  74. package/extensions/agency-agents/agents/project-management/project-management-experiment-tracker.md +196 -0
  75. package/extensions/agency-agents/agents/project-management/project-management-project-shepherd.md +192 -0
  76. package/extensions/agency-agents/agents/project-management/project-management-studio-operations.md +198 -0
  77. package/extensions/agency-agents/agents/project-management/project-management-studio-producer.md +201 -0
  78. package/extensions/agency-agents/agents/project-management/project-manager-senior.md +133 -0
  79. package/extensions/agency-agents/agents/scripts/convert.sh +362 -0
  80. package/extensions/agency-agents/agents/scripts/install.sh +465 -0
  81. package/extensions/agency-agents/agents/scripts/lint-agents.sh +115 -0
  82. package/extensions/agency-agents/agents/spatial-computing/macos-spatial-metal-engineer.md +335 -0
  83. package/extensions/agency-agents/agents/spatial-computing/terminal-integration-specialist.md +68 -0
  84. package/extensions/agency-agents/agents/spatial-computing/visionos-spatial-engineer.md +52 -0
  85. package/extensions/agency-agents/agents/spatial-computing/xr-cockpit-interaction-specialist.md +30 -0
  86. package/extensions/agency-agents/agents/spatial-computing/xr-immersive-developer.md +30 -0
  87. package/extensions/agency-agents/agents/spatial-computing/xr-interface-architect.md +30 -0
  88. package/extensions/agency-agents/agents/specialized/agentic-identity-trust.md +367 -0
  89. package/extensions/agency-agents/agents/specialized/agents-orchestrator.md +365 -0
  90. package/extensions/agency-agents/agents/specialized/data-analytics-reporter.md +52 -0
  91. package/extensions/agency-agents/agents/specialized/data-consolidation-agent.md +58 -0
  92. package/extensions/agency-agents/agents/specialized/lsp-index-engineer.md +312 -0
  93. package/extensions/agency-agents/agents/specialized/report-distribution-agent.md +63 -0
  94. package/extensions/agency-agents/agents/specialized/sales-data-extraction-agent.md +65 -0
  95. package/extensions/agency-agents/agents/strategy/EXECUTIVE-BRIEF.md +95 -0
  96. package/extensions/agency-agents/agents/strategy/QUICKSTART.md +194 -0
  97. package/extensions/agency-agents/agents/strategy/coordination/agent-activation-prompts.md +401 -0
  98. package/extensions/agency-agents/agents/strategy/coordination/handoff-templates.md +357 -0
  99. package/extensions/agency-agents/agents/strategy/nexus-strategy.md +1110 -0
  100. package/extensions/agency-agents/agents/strategy/playbooks/phase-0-discovery.md +178 -0
  101. package/extensions/agency-agents/agents/strategy/playbooks/phase-1-strategy.md +238 -0
  102. package/extensions/agency-agents/agents/strategy/playbooks/phase-2-foundation.md +278 -0
  103. package/extensions/agency-agents/agents/strategy/playbooks/phase-3-build.md +286 -0
  104. package/extensions/agency-agents/agents/strategy/playbooks/phase-4-hardening.md +332 -0
  105. package/extensions/agency-agents/agents/strategy/playbooks/phase-5-launch.md +277 -0
  106. package/extensions/agency-agents/agents/strategy/playbooks/phase-6-operate.md +318 -0
  107. package/extensions/agency-agents/agents/strategy/runbooks/scenario-enterprise-feature.md +157 -0
  108. package/extensions/agency-agents/agents/strategy/runbooks/scenario-incident-response.md +217 -0
  109. package/extensions/agency-agents/agents/strategy/runbooks/scenario-marketing-campaign.md +187 -0
  110. package/extensions/agency-agents/agents/strategy/runbooks/scenario-startup-mvp.md +154 -0
  111. package/extensions/agency-agents/agents/support/support-analytics-reporter.md +363 -0
  112. package/extensions/agency-agents/agents/support/support-executive-summary-generator.md +210 -0
  113. package/extensions/agency-agents/agents/support/support-finance-tracker.md +440 -0
  114. package/extensions/agency-agents/agents/support/support-infrastructure-maintainer.md +616 -0
  115. package/extensions/agency-agents/agents/support/support-legal-compliance-checker.md +586 -0
  116. package/extensions/agency-agents/agents/support/support-support-responder.md +583 -0
  117. package/extensions/agency-agents/agents/testing/testing-accessibility-auditor.md +313 -0
  118. package/extensions/agency-agents/agents/testing/testing-api-tester.md +304 -0
  119. package/extensions/agency-agents/agents/testing/testing-evidence-collector.md +208 -0
  120. package/extensions/agency-agents/agents/testing/testing-performance-benchmarker.md +266 -0
  121. package/extensions/agency-agents/agents/testing/testing-reality-checker.md +236 -0
  122. package/extensions/agency-agents/agents/testing/testing-test-results-analyzer.md +303 -0
  123. package/extensions/agency-agents/agents/testing/testing-tool-evaluator.md +392 -0
  124. package/extensions/agency-agents/agents/testing/testing-workflow-optimizer.md +448 -0
  125. package/extensions/agency-agents/index.ts +733 -0
  126. package/extensions/agency-agents/node_modules/.bin/jiti +21 -0
  127. package/extensions/agency-agents/node_modules/.bin/tsc +21 -0
  128. package/extensions/agency-agents/node_modules/.bin/tsserver +21 -0
  129. package/extensions/agency-agents/node_modules/.bin/tsx +21 -0
  130. package/extensions/agency-agents/node_modules/.bin/vite +21 -0
  131. package/extensions/agency-agents/node_modules/.bin/vitest +21 -0
  132. package/extensions/agency-agents/node_modules/.bin/yaml +21 -0
  133. package/extensions/agency-agents/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -0
  134. package/extensions/agency-agents/package.json +25 -0
  135. package/extensions/agency-agents/poolbot.plugin.json +11 -0
  136. package/extensions/agency-agents/src/AgencyAgentsService.test.ts +443 -0
  137. package/extensions/agency-agents/src/AgencyAgentsService.ts +288 -0
  138. package/extensions/agency-agents/src/types.ts +147 -0
  139. package/extensions/agency-agents/vitest.config.ts +8 -0
  140. package/extensions/hexstrike-ai/README.md +98 -0
  141. package/extensions/hexstrike-ai/node_modules/.bin/tsc +21 -0
  142. package/extensions/hexstrike-ai/node_modules/.bin/tsserver +21 -0
  143. package/extensions/hexstrike-ai/package.json +29 -0
  144. package/extensions/hexstrike-ai/poolbot.plugin.json +31 -0
  145. package/extensions/hexstrike-ai/src/client.ts +91 -0
  146. package/extensions/hexstrike-ai/src/index.ts +170 -0
  147. package/extensions/hexstrike-ai/src/server/hexstrike_mcp.py +5470 -0
  148. package/extensions/hexstrike-ai/src/server/hexstrike_server.py +17289 -0
  149. package/extensions/hexstrike-ai/src/server/requirements.txt +84 -0
  150. package/extensions/hexstrike-ai/src/server-manager.ts +83 -0
  151. package/extensions/hexstrike-ai/tsconfig.json +20 -0
  152. package/extensions/page-agent/README.md +159 -0
  153. package/extensions/page-agent/index.ts +595 -0
  154. package/extensions/page-agent/node_modules/.bin/jiti +21 -0
  155. package/extensions/page-agent/node_modules/.bin/playwright +21 -0
  156. package/extensions/page-agent/node_modules/.bin/tsc +21 -0
  157. package/extensions/page-agent/node_modules/.bin/tsserver +21 -0
  158. package/extensions/page-agent/node_modules/.bin/tsx +21 -0
  159. package/extensions/page-agent/node_modules/.bin/vitest +21 -0
  160. package/extensions/page-agent/node_modules/.bin/yaml +21 -0
  161. package/extensions/page-agent/package.json +43 -0
  162. package/extensions/page-agent/poolbot.plugin.json +24 -0
  163. package/extensions/page-agent/src/PageAgentService.test.ts +517 -0
  164. package/extensions/page-agent/src/PageAgentService.ts +636 -0
  165. package/extensions/page-agent/src/PoolBotPageController.test.ts +358 -0
  166. package/extensions/page-agent/src/PoolBotPageController.ts +245 -0
  167. package/extensions/page-agent/src/index.ts +20 -0
  168. package/extensions/page-agent/src/tools.test.ts +231 -0
  169. package/extensions/page-agent/src/tools.ts +167 -0
  170. package/extensions/page-agent/src/types.ts +198 -0
  171. package/extensions/xyops/README.md +227 -0
  172. package/extensions/xyops/index.ts +342 -0
  173. package/extensions/xyops/node_modules/.bin/jiti +21 -0
  174. package/extensions/xyops/node_modules/.bin/tsc +21 -0
  175. package/extensions/xyops/node_modules/.bin/tsserver +21 -0
  176. package/extensions/xyops/node_modules/.bin/tsx +21 -0
  177. package/extensions/xyops/node_modules/.bin/vitest +21 -0
  178. package/extensions/xyops/node_modules/.bin/yaml +21 -0
  179. package/extensions/xyops/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -0
  180. package/extensions/xyops/package.json +39 -0
  181. package/extensions/xyops/poolbot.plugin.json +21 -0
  182. package/extensions/xyops/src/client.test.ts +467 -0
  183. package/extensions/xyops/src/client.ts +157 -0
  184. package/extensions/xyops/src/types.ts +147 -0
  185. package/extensions/xyops/vitest.config.ts +8 -0
  186. package/package.json +1 -1
@@ -0,0 +1,119 @@
1
+ # Multi-Agent Workflow: Landing Page Sprint
2
+
3
+ > Ship a conversion-optimized landing page in one day using 4 agents.
4
+
5
+ ## The Scenario
6
+
7
+ You need a landing page for a new product launch. It needs to look great, convert visitors, and be live by end of day.
8
+
9
+ ## Agent Team
10
+
11
+ | Agent | Role in this workflow |
12
+ |-------|---------------------|
13
+ | Content Creator | Write the copy |
14
+ | UI Designer | Design the layout and component specs |
15
+ | Frontend Developer | Build it |
16
+ | Growth Hacker | Optimize for conversion |
17
+
18
+ ## The Workflow
19
+
20
+ ### Morning: Copy + Design (parallel)
21
+
22
+ **Step 1a — Activate Content Creator**
23
+
24
+ ```
25
+ Activate Content Creator.
26
+
27
+ Write landing page copy for "FlowSync" — an API integration platform
28
+ that connects any two SaaS tools in under 5 minutes.
29
+
30
+ Target audience: developers and technical PMs at mid-size companies.
31
+ Tone: confident, concise, slightly playful.
32
+
33
+ Sections needed:
34
+ 1. Hero (headline + subheadline + CTA)
35
+ 2. Problem statement (3 pain points)
36
+ 3. How it works (3 steps)
37
+ 4. Social proof (placeholder testimonial format)
38
+ 5. Pricing (3 tiers: Free, Pro, Enterprise)
39
+ 6. Final CTA
40
+
41
+ Keep it scannable. No fluff.
42
+ ```
43
+
44
+ **Step 1b — Activate UI Designer (in parallel)**
45
+
46
+ ```
47
+ Activate UI Designer.
48
+
49
+ Design specs for a SaaS landing page. Product: FlowSync (API integration platform).
50
+ Style: clean, modern, dark mode option. Think Linear or Vercel aesthetic.
51
+
52
+ Deliver:
53
+ 1. Layout wireframe (section order + spacing)
54
+ 2. Color palette (primary, secondary, accent, background)
55
+ 3. Typography (font pairing, heading sizes, body size)
56
+ 4. Component specs: hero section, feature cards, pricing table, CTA buttons
57
+ 5. Responsive breakpoints (mobile, tablet, desktop)
58
+ ```
59
+
60
+ ### Midday: Build
61
+
62
+ **Step 2 — Activate Frontend Developer**
63
+
64
+ ```
65
+ Activate Frontend Developer.
66
+
67
+ Build a landing page from these specs:
68
+
69
+ Copy: [paste Content Creator output]
70
+ Design: [paste UI Designer output]
71
+
72
+ Stack: HTML, Tailwind CSS, minimal vanilla JS (no framework needed).
73
+ Requirements:
74
+ - Responsive (mobile-first)
75
+ - Fast (no heavy assets, system fonts OK)
76
+ - Accessible (proper headings, alt text, focus states)
77
+ - Include a working email signup form (action URL: /api/subscribe)
78
+
79
+ Deliver a single index.html file ready to deploy.
80
+ ```
81
+
82
+ ### Afternoon: Optimize
83
+
84
+ **Step 3 — Activate Growth Hacker**
85
+
86
+ ```
87
+ Activate Growth Hacker.
88
+
89
+ Review this landing page for conversion optimization:
90
+
91
+ [paste the HTML or describe the current page]
92
+
93
+ Evaluate:
94
+ 1. Is the CTA above the fold?
95
+ 2. Is the value proposition clear in under 5 seconds?
96
+ 3. Any friction in the signup flow?
97
+ 4. What A/B tests would you run first?
98
+ 5. SEO basics: meta tags, OG tags, structured data
99
+
100
+ Give me specific changes, not general advice.
101
+ ```
102
+
103
+ ## Timeline
104
+
105
+ | Time | Activity | Agent |
106
+ |------|----------|-------|
107
+ | 9:00 | Copy + design kick off (parallel) | Content Creator + UI Designer |
108
+ | 11:00 | Build starts | Frontend Developer |
109
+ | 14:00 | First version ready | — |
110
+ | 14:30 | Conversion review | Growth Hacker |
111
+ | 15:30 | Apply feedback | Frontend Developer |
112
+ | 16:30 | Ship | Deploy to Vercel/Netlify |
113
+
114
+ ## Key Patterns
115
+
116
+ 1. **Parallel kickoff**: Copy and design happen at the same time since they're independent
117
+ 2. **Merge point**: Frontend Developer needs both outputs before starting
118
+ 3. **Feedback loop**: Growth Hacker reviews, then Frontend Developer applies changes
119
+ 4. **Time-boxed**: Each step has a clear timebox to prevent scope creep
@@ -0,0 +1,155 @@
1
+ # Multi-Agent Workflow: Startup MVP
2
+
3
+ > A step-by-step example of how to coordinate multiple agents to go from idea to shipped MVP.
4
+
5
+ ## The Scenario
6
+
7
+ You're building a SaaS MVP — a team retrospective tool for remote teams. You have 4 weeks to ship a working product with user signups, a core feature, and a landing page.
8
+
9
+ ## Agent Team
10
+
11
+ | Agent | Role in this workflow |
12
+ |-------|---------------------|
13
+ | Sprint Prioritizer | Break the project into weekly sprints |
14
+ | UX Researcher | Validate the idea with quick user interviews |
15
+ | Backend Architect | Design the API and data model |
16
+ | Frontend Developer | Build the React app |
17
+ | Rapid Prototyper | Get the first version running fast |
18
+ | Growth Hacker | Plan launch strategy while building |
19
+ | Reality Checker | Gate each milestone before moving on |
20
+
21
+ ## The Workflow
22
+
23
+ ### Week 1: Discovery + Architecture
24
+
25
+ **Step 1 — Activate Sprint Prioritizer**
26
+
27
+ ```
28
+ Activate Sprint Prioritizer.
29
+
30
+ Project: RetroBoard — a real-time team retrospective tool for remote teams.
31
+ Timeline: 4 weeks to MVP launch.
32
+ Core features: user auth, create retro boards, add cards, vote, action items.
33
+ Constraints: solo developer, React + Node.js stack, deploy to Vercel + Railway.
34
+
35
+ Break this into 4 weekly sprints with clear deliverables and acceptance criteria.
36
+ ```
37
+
38
+ **Step 2 — Activate UX Researcher (in parallel)**
39
+
40
+ ```
41
+ Activate UX Researcher.
42
+
43
+ I'm building a team retrospective tool for remote teams (5-20 people).
44
+ Competitors: EasyRetro, Retrium, Parabol.
45
+
46
+ Run a quick competitive analysis and identify:
47
+ 1. What features are table stakes
48
+ 2. Where competitors fall short
49
+ 3. One differentiator we could own
50
+
51
+ Output a 1-page research brief.
52
+ ```
53
+
54
+ **Step 3 — Hand off to Backend Architect**
55
+
56
+ ```
57
+ Activate Backend Architect.
58
+
59
+ Here's our sprint plan: [paste Sprint Prioritizer output]
60
+ Here's our research brief: [paste UX Researcher output]
61
+
62
+ Design the API and database schema for RetroBoard.
63
+ Stack: Node.js, Express, PostgreSQL, Socket.io for real-time.
64
+
65
+ Deliver:
66
+ 1. Database schema (SQL)
67
+ 2. REST API endpoints list
68
+ 3. WebSocket events for real-time board updates
69
+ 4. Auth strategy recommendation
70
+ ```
71
+
72
+ ### Week 2: Build Core Features
73
+
74
+ **Step 4 — Activate Frontend Developer + Rapid Prototyper**
75
+
76
+ ```
77
+ Activate Frontend Developer.
78
+
79
+ Here's the API spec: [paste Backend Architect output]
80
+
81
+ Build the RetroBoard React app:
82
+ - Stack: React, TypeScript, Tailwind, Socket.io-client
83
+ - Pages: Login, Dashboard, Board view
84
+ - Components: RetroCard, VoteButton, ActionItem, BoardColumn
85
+
86
+ Start with the Board view — it's the core experience.
87
+ Focus on real-time: when one user adds a card, everyone sees it.
88
+ ```
89
+
90
+ **Step 5 — Reality Check at midpoint**
91
+
92
+ ```
93
+ Activate Reality Checker.
94
+
95
+ We're at week 2 of a 4-week MVP build for RetroBoard.
96
+
97
+ Here's what we have so far:
98
+ - Database schema: [paste]
99
+ - API endpoints: [paste]
100
+ - Frontend components: [paste]
101
+
102
+ Evaluate:
103
+ 1. Can we realistically ship in 2 more weeks?
104
+ 2. What should we cut to make the deadline?
105
+ 3. Any technical debt that will bite us at launch?
106
+ ```
107
+
108
+ ### Week 3: Polish + Landing Page
109
+
110
+ **Step 6 — Frontend Developer continues, Growth Hacker starts**
111
+
112
+ ```
113
+ Activate Growth Hacker.
114
+
115
+ Product: RetroBoard — team retrospective tool, launching in 1 week.
116
+ Target: Engineering managers and scrum masters at remote-first companies.
117
+ Budget: $0 (organic launch only).
118
+
119
+ Create a launch plan:
120
+ 1. Landing page copy (hero, features, CTA)
121
+ 2. Launch channels (Product Hunt, Reddit, Hacker News, Twitter)
122
+ 3. Day-by-day launch sequence
123
+ 4. Metrics to track in week 1
124
+ ```
125
+
126
+ ### Week 4: Launch
127
+
128
+ **Step 7 — Final Reality Check**
129
+
130
+ ```
131
+ Activate Reality Checker.
132
+
133
+ RetroBoard is ready to launch. Evaluate production readiness:
134
+
135
+ - Live URL: [url]
136
+ - Test accounts created: yes
137
+ - Error monitoring: Sentry configured
138
+ - Database backups: daily automated
139
+
140
+ Run through the launch checklist and give a GO / NO-GO decision.
141
+ Require evidence for each criterion.
142
+ ```
143
+
144
+ ## Key Patterns
145
+
146
+ 1. **Sequential handoffs**: Each agent's output becomes the next agent's input
147
+ 2. **Parallel work**: UX Researcher and Sprint Prioritizer can run simultaneously in Week 1
148
+ 3. **Quality gates**: Reality Checker at midpoint and before launch prevents shipping broken code
149
+ 4. **Context passing**: Always paste previous agent outputs into the next prompt — agents don't share memory
150
+
151
+ ## Tips
152
+
153
+ - Copy-paste agent outputs between steps — don't summarize, use the full output
154
+ - If a Reality Checker flags an issue, loop back to the relevant specialist to fix it
155
+ - Keep the Orchestrator agent in mind for automating this flow once you're comfortable with the manual version
@@ -0,0 +1,117 @@
1
+ # 🔌 Integrations
2
+
3
+ This directory contains The Agency's 61 AI agents converted into formats
4
+ compatible with popular agentic coding tools.
5
+
6
+ ## Supported Tools
7
+
8
+ - **[Claude Code](#claude-code)** — `.md` agents, use the repo directly
9
+ - **[Antigravity](#antigravity)** — `SKILL.md` per agent in `antigravity/`
10
+ - **[Gemini CLI](#gemini-cli)** — extension + `SKILL.md` files in `gemini-cli/`
11
+ - **[OpenCode](#opencode)** — `.md` agent files in `opencode/`
12
+ - **[Cursor](#cursor)** — `.mdc` rule files in `cursor/`
13
+ - **[Aider](#aider)** — `CONVENTIONS.md` in `aider/`
14
+ - **[Windsurf](#windsurf)** — `.windsurfrules` in `windsurf/`
15
+
16
+ ## Quick Install
17
+
18
+ ```bash
19
+ # Install for all detected tools automatically
20
+ ./scripts/install.sh
21
+
22
+ # Install for a specific tool
23
+ ./scripts/install.sh --tool antigravity
24
+ ./scripts/install.sh --tool gemini-cli
25
+ ./scripts/install.sh --tool cursor
26
+ ./scripts/install.sh --tool aider
27
+ ./scripts/install.sh --tool windsurf
28
+ ./scripts/install.sh --tool claude-code
29
+ ```
30
+
31
+ ## Regenerating Integration Files
32
+
33
+ If you add or modify agents, regenerate all integration files:
34
+
35
+ ```bash
36
+ ./scripts/convert.sh
37
+ ```
38
+
39
+ ---
40
+
41
+ ## Claude Code
42
+
43
+ The Agency was originally designed for Claude Code. Agents work natively
44
+ without conversion.
45
+
46
+ ```bash
47
+ cp -r <category>/*.md ~/.claude/agents/
48
+ # or install everything at once:
49
+ ./scripts/install.sh --tool claude-code
50
+ ```
51
+
52
+ See [claude-code/README.md](claude-code/README.md) for details.
53
+
54
+ ---
55
+
56
+ ## Antigravity
57
+
58
+ Skills are installed to `~/.gemini/antigravity/skills/`. Each agent becomes
59
+ a separate skill prefixed with `agency-` to avoid naming conflicts.
60
+
61
+ ```bash
62
+ ./scripts/install.sh --tool antigravity
63
+ ```
64
+
65
+ See [antigravity/README.md](antigravity/README.md) for details.
66
+
67
+ ---
68
+
69
+ ## Gemini CLI
70
+
71
+ Agents are packaged as a Gemini CLI extension with individual skill files.
72
+ The extension is installed to `~/.gemini/extensions/agency-agents/`.
73
+
74
+ ```bash
75
+ ./scripts/install.sh --tool gemini-cli
76
+ ```
77
+
78
+ See [gemini-cli/README.md](gemini-cli/README.md) for details.
79
+
80
+ ---
81
+
82
+ ## Cursor
83
+
84
+ Each agent becomes a `.mdc` rule file. Rules are project-scoped — run the
85
+ installer from your project root.
86
+
87
+ ```bash
88
+ cd /your/project && /path/to/agency-agents/scripts/install.sh --tool cursor
89
+ ```
90
+
91
+ See [cursor/README.md](cursor/README.md) for details.
92
+
93
+ ---
94
+
95
+ ## Aider
96
+
97
+ All agents are consolidated into a single `CONVENTIONS.md` file that Aider
98
+ reads automatically when present in your project root.
99
+
100
+ ```bash
101
+ cd /your/project && /path/to/agency-agents/scripts/install.sh --tool aider
102
+ ```
103
+
104
+ See [aider/README.md](aider/README.md) for details.
105
+
106
+ ---
107
+
108
+ ## Windsurf
109
+
110
+ All agents are consolidated into a single `.windsurfrules` file for your
111
+ project root.
112
+
113
+ ```bash
114
+ cd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurf
115
+ ```
116
+
117
+ See [windsurf/README.md](windsurf/README.md) for details.
@@ -0,0 +1,38 @@
1
+ # Aider Integration
2
+
3
+ All 61 Agency agents are consolidated into a single `CONVENTIONS.md` file.
4
+ Aider reads this file automatically when it's present in your project root.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ # Run from your project root
10
+ cd /your/project
11
+ /path/to/agency-agents/scripts/install.sh --tool aider
12
+ ```
13
+
14
+ ## Activate an Agent
15
+
16
+ In your Aider session, reference the agent by name:
17
+
18
+ ```
19
+ Use the Frontend Developer agent to refactor this component.
20
+ ```
21
+
22
+ ```
23
+ Apply the Reality Checker agent to verify this is production-ready.
24
+ ```
25
+
26
+ ## Manual Usage
27
+
28
+ You can also pass the conventions file directly:
29
+
30
+ ```bash
31
+ aider --read CONVENTIONS.md
32
+ ```
33
+
34
+ ## Regenerate
35
+
36
+ ```bash
37
+ ./scripts/convert.sh --tool aider
38
+ ```
@@ -0,0 +1,49 @@
1
+ # Antigravity Integration
2
+
3
+ Installs all 61 Agency agents as Antigravity skills. Each agent is prefixed
4
+ with `agency-` to avoid conflicts with existing skills.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ ./scripts/install.sh --tool antigravity
10
+ ```
11
+
12
+ This copies files from `integrations/antigravity/` to
13
+ `~/.gemini/antigravity/skills/`.
14
+
15
+ ## Activate a Skill
16
+
17
+ In Antigravity, activate an agent by its slug:
18
+
19
+ ```
20
+ Use the agency-frontend-developer skill to review this component.
21
+ ```
22
+
23
+ Available slugs follow the pattern `agency-<agent-name>`, e.g.:
24
+ - `agency-frontend-developer`
25
+ - `agency-backend-architect`
26
+ - `agency-reality-checker`
27
+ - `agency-growth-hacker`
28
+
29
+ ## Regenerate
30
+
31
+ After modifying agents, regenerate the skill files:
32
+
33
+ ```bash
34
+ ./scripts/convert.sh --tool antigravity
35
+ ```
36
+
37
+ ## File Format
38
+
39
+ Each skill is a `SKILL.md` file with Antigravity-compatible frontmatter:
40
+
41
+ ```yaml
42
+ ---
43
+ name: agency-frontend-developer
44
+ description: Expert frontend developer specializing in...
45
+ risk: low
46
+ source: community
47
+ date_added: '2026-03-08'
48
+ ---
49
+ ```
@@ -0,0 +1,31 @@
1
+ # Claude Code Integration
2
+
3
+ The Agency was built for Claude Code. No conversion needed — agents work
4
+ natively with the existing `.md` + YAML frontmatter format.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ # Copy all agents to your Claude Code agents directory
10
+ ./scripts/install.sh --tool claude-code
11
+
12
+ # Or manually copy a category
13
+ cp engineering/*.md ~/.claude/agents/
14
+ ```
15
+
16
+ ## Activate an Agent
17
+
18
+ In any Claude Code session, reference an agent by name:
19
+
20
+ ```
21
+ Activate Frontend Developer and help me build a React component.
22
+ ```
23
+
24
+ ```
25
+ Use the Reality Checker agent to verify this feature is production-ready.
26
+ ```
27
+
28
+ ## Agent Directory
29
+
30
+ Agents are organized into divisions. See the [main README](../../README.md) for
31
+ the full roster of 61 specialists.
@@ -0,0 +1,38 @@
1
+ # Cursor Integration
2
+
3
+ Converts all 61 Agency agents into Cursor `.mdc` rule files. Rules are
4
+ **project-scoped** — install them from your project root.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ # Run from your project root
10
+ cd /your/project
11
+ /path/to/agency-agents/scripts/install.sh --tool cursor
12
+ ```
13
+
14
+ This creates `.cursor/rules/<agent-slug>.mdc` files in your project.
15
+
16
+ ## Activate a Rule
17
+
18
+ In Cursor, reference an agent in your prompt:
19
+
20
+ ```
21
+ @frontend-developer Review this React component for performance issues.
22
+ ```
23
+
24
+ Or enable a rule as always-on by editing its frontmatter:
25
+
26
+ ```yaml
27
+ ---
28
+ description: Expert frontend developer...
29
+ globs: "**/*.tsx,**/*.ts"
30
+ alwaysApply: true
31
+ ---
32
+ ```
33
+
34
+ ## Regenerate
35
+
36
+ ```bash
37
+ ./scripts/convert.sh --tool cursor
38
+ ```
@@ -0,0 +1,36 @@
1
+ # Gemini CLI Integration
2
+
3
+ Packages all 61 Agency agents as a Gemini CLI extension. The extension
4
+ installs to `~/.gemini/extensions/agency-agents/`.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ ./scripts/install.sh --tool gemini-cli
10
+ ```
11
+
12
+ ## Activate a Skill
13
+
14
+ In Gemini CLI, reference an agent by name:
15
+
16
+ ```
17
+ Use the frontend-developer skill to help me build this UI.
18
+ ```
19
+
20
+ ## Extension Structure
21
+
22
+ ```
23
+ ~/.gemini/extensions/agency-agents/
24
+ gemini-extension.json
25
+ skills/
26
+ frontend-developer/SKILL.md
27
+ backend-architect/SKILL.md
28
+ reality-checker/SKILL.md
29
+ ...
30
+ ```
31
+
32
+ ## Regenerate
33
+
34
+ ```bash
35
+ ./scripts/convert.sh --tool gemini-cli
36
+ ```
@@ -0,0 +1,58 @@
1
+ # OpenCode Integration
2
+
3
+ OpenCode uses the same agent format as Claude Code — `.md` files with YAML
4
+ frontmatter stored in `.opencode/agent/`. No conversion is technically
5
+ needed, but this integration packages the agents into the correct directory
6
+ structure for drop-in use.
7
+
8
+ ## Install
9
+
10
+ ```bash
11
+ # Run from your project root
12
+ cd /your/project
13
+ /path/to/agency-agents/scripts/install.sh --tool opencode
14
+ ```
15
+
16
+ This creates `.opencode/agent/<slug>.md` files in your project directory.
17
+
18
+ ## Activate an Agent
19
+
20
+ In OpenCode, reference an agent by its name or description:
21
+
22
+ ```
23
+ Use the Frontend Developer agent to help build this component.
24
+ ```
25
+
26
+ ```
27
+ Activate the Reality Checker agent and review this PR.
28
+ ```
29
+
30
+ You can also select agents from the OpenCode UI's agent picker.
31
+
32
+ ## Agent Format
33
+
34
+ OpenCode agents use the same frontmatter as Claude Code:
35
+
36
+ ```yaml
37
+ ---
38
+ name: Frontend Developer
39
+ description: Expert frontend developer specializing in modern web technologies...
40
+ color: cyan
41
+ ---
42
+ ```
43
+
44
+ ## Project vs Global
45
+
46
+ Agents in `.opencode/agent/` are **project-scoped**. To make them available
47
+ globally across all projects, copy them to your OpenCode config directory:
48
+
49
+ ```bash
50
+ mkdir -p ~/.config/opencode/agent
51
+ cp integrations/opencode/agent/*.md ~/.config/opencode/agent/
52
+ ```
53
+
54
+ ## Regenerate
55
+
56
+ ```bash
57
+ ./scripts/convert.sh --tool opencode
58
+ ```
@@ -0,0 +1,26 @@
1
+ # Windsurf Integration
2
+
3
+ All 61 Agency agents are consolidated into a single `.windsurfrules` file.
4
+ Rules are **project-scoped** — install them from your project root.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ # Run from your project root
10
+ cd /your/project
11
+ /path/to/agency-agents/scripts/install.sh --tool windsurf
12
+ ```
13
+
14
+ ## Activate an Agent
15
+
16
+ In Windsurf, reference an agent by name in your prompt:
17
+
18
+ ```
19
+ Use the Frontend Developer agent to build this component.
20
+ ```
21
+
22
+ ## Regenerate
23
+
24
+ ```bash
25
+ ./scripts/convert.sh --tool windsurf
26
+ ```