@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.
- package/CHANGELOG.md +87 -0
- package/dist/agents/checkpoint-manager.js +291 -0
- package/dist/agents/poolbot-tools.js +5 -0
- package/dist/agents/subagent-announce-reliability.js +160 -0
- package/dist/agents/tool-result-truncation.js +299 -0
- package/dist/agents/tools/nodes-file-tool.js +197 -0
- package/dist/build-info.json +3 -3
- package/dist/cli/config-cli.js +60 -0
- package/dist/cron/cron-improvements.js +195 -0
- package/dist/discord/discord-improvements.js +167 -0
- package/dist/gateway/auth-rate-limit.js +19 -0
- package/dist/gateway/auth.js +41 -0
- package/dist/gateway/gateway-improvements.js +294 -0
- package/dist/gateway/node-command-policy.js +7 -2
- package/dist/infra/net/ssrf.js +15 -2
- package/dist/infra/shell-security.js +201 -0
- package/dist/memory/memory-improvements.js +239 -0
- package/dist/node-host/runner.js +146 -79
- package/dist/security/prototype-pollution.js +141 -0
- package/dist/security/webhook-security.js +253 -0
- package/dist/shared/net/ip.js +52 -1
- package/dist/slack/slack-improvements.js +225 -0
- package/dist/telegram/telegram-improvements.js +220 -0
- package/dist/ui-plugins/ui-plugins-improvements.js +191 -0
- package/docs/ANALISE_OPENCLAW_PROFISSIONAL.md +520 -0
- package/docs/competitive-analysis.md +421 -0
- package/docs/implementation-analysis.md +393 -0
- package/docs/plans/2026-03-11-file-operations-security-hardening.md +307 -0
- package/docs/plans/2026-03-11-integracao-projetos-poolbot.md +666 -0
- package/extensions/agency-agents/README.md +301 -0
- package/extensions/agency-agents/agents/CONTRIBUTING.md +353 -0
- package/extensions/agency-agents/agents/README.md +602 -0
- package/extensions/agency-agents/agents/design/design-brand-guardian.md +320 -0
- package/extensions/agency-agents/agents/design/design-image-prompt-engineer.md +234 -0
- package/extensions/agency-agents/agents/design/design-ui-designer.md +381 -0
- package/extensions/agency-agents/agents/design/design-ux-architect.md +467 -0
- package/extensions/agency-agents/agents/design/design-ux-researcher.md +327 -0
- package/extensions/agency-agents/agents/design/design-visual-storyteller.md +147 -0
- package/extensions/agency-agents/agents/design/design-whimsy-injector.md +436 -0
- package/extensions/agency-agents/agents/engineering/engineering-ai-engineer.md +144 -0
- package/extensions/agency-agents/agents/engineering/engineering-backend-architect.md +233 -0
- package/extensions/agency-agents/agents/engineering/engineering-devops-automator.md +374 -0
- package/extensions/agency-agents/agents/engineering/engineering-frontend-developer.md +223 -0
- package/extensions/agency-agents/agents/engineering/engineering-mobile-app-builder.md +491 -0
- package/extensions/agency-agents/agents/engineering/engineering-rapid-prototyper.md +460 -0
- package/extensions/agency-agents/agents/engineering/engineering-security-engineer.md +275 -0
- package/extensions/agency-agents/agents/engineering/engineering-senior-developer.md +174 -0
- package/extensions/agency-agents/agents/examples/README.md +48 -0
- package/extensions/agency-agents/agents/examples/nexus-spatial-discovery.md +852 -0
- package/extensions/agency-agents/agents/examples/workflow-landing-page.md +119 -0
- package/extensions/agency-agents/agents/examples/workflow-startup-mvp.md +155 -0
- package/extensions/agency-agents/agents/integrations/README.md +117 -0
- package/extensions/agency-agents/agents/integrations/aider/README.md +38 -0
- package/extensions/agency-agents/agents/integrations/antigravity/README.md +49 -0
- package/extensions/agency-agents/agents/integrations/claude-code/README.md +31 -0
- package/extensions/agency-agents/agents/integrations/cursor/README.md +38 -0
- package/extensions/agency-agents/agents/integrations/gemini-cli/README.md +36 -0
- package/extensions/agency-agents/agents/integrations/opencode/README.md +58 -0
- package/extensions/agency-agents/agents/integrations/windsurf/README.md +26 -0
- package/extensions/agency-agents/agents/marketing/marketing-app-store-optimizer.md +319 -0
- package/extensions/agency-agents/agents/marketing/marketing-content-creator.md +52 -0
- package/extensions/agency-agents/agents/marketing/marketing-growth-hacker.md +52 -0
- package/extensions/agency-agents/agents/marketing/marketing-instagram-curator.md +111 -0
- package/extensions/agency-agents/agents/marketing/marketing-reddit-community-builder.md +121 -0
- package/extensions/agency-agents/agents/marketing/marketing-social-media-strategist.md +123 -0
- package/extensions/agency-agents/agents/marketing/marketing-tiktok-strategist.md +123 -0
- package/extensions/agency-agents/agents/marketing/marketing-twitter-engager.md +124 -0
- package/extensions/agency-agents/agents/marketing/marketing-wechat-official-account.md +143 -0
- package/extensions/agency-agents/agents/marketing/marketing-xiaohongshu-specialist.md +136 -0
- package/extensions/agency-agents/agents/marketing/marketing-zhihu-strategist.md +160 -0
- package/extensions/agency-agents/agents/product/product-feedback-synthesizer.md +117 -0
- package/extensions/agency-agents/agents/product/product-sprint-prioritizer.md +152 -0
- package/extensions/agency-agents/agents/product/product-trend-researcher.md +157 -0
- package/extensions/agency-agents/agents/project-management/project-management-experiment-tracker.md +196 -0
- package/extensions/agency-agents/agents/project-management/project-management-project-shepherd.md +192 -0
- package/extensions/agency-agents/agents/project-management/project-management-studio-operations.md +198 -0
- package/extensions/agency-agents/agents/project-management/project-management-studio-producer.md +201 -0
- package/extensions/agency-agents/agents/project-management/project-manager-senior.md +133 -0
- package/extensions/agency-agents/agents/scripts/convert.sh +362 -0
- package/extensions/agency-agents/agents/scripts/install.sh +465 -0
- package/extensions/agency-agents/agents/scripts/lint-agents.sh +115 -0
- package/extensions/agency-agents/agents/spatial-computing/macos-spatial-metal-engineer.md +335 -0
- package/extensions/agency-agents/agents/spatial-computing/terminal-integration-specialist.md +68 -0
- package/extensions/agency-agents/agents/spatial-computing/visionos-spatial-engineer.md +52 -0
- package/extensions/agency-agents/agents/spatial-computing/xr-cockpit-interaction-specialist.md +30 -0
- package/extensions/agency-agents/agents/spatial-computing/xr-immersive-developer.md +30 -0
- package/extensions/agency-agents/agents/spatial-computing/xr-interface-architect.md +30 -0
- package/extensions/agency-agents/agents/specialized/agentic-identity-trust.md +367 -0
- package/extensions/agency-agents/agents/specialized/agents-orchestrator.md +365 -0
- package/extensions/agency-agents/agents/specialized/data-analytics-reporter.md +52 -0
- package/extensions/agency-agents/agents/specialized/data-consolidation-agent.md +58 -0
- package/extensions/agency-agents/agents/specialized/lsp-index-engineer.md +312 -0
- package/extensions/agency-agents/agents/specialized/report-distribution-agent.md +63 -0
- package/extensions/agency-agents/agents/specialized/sales-data-extraction-agent.md +65 -0
- package/extensions/agency-agents/agents/strategy/EXECUTIVE-BRIEF.md +95 -0
- package/extensions/agency-agents/agents/strategy/QUICKSTART.md +194 -0
- package/extensions/agency-agents/agents/strategy/coordination/agent-activation-prompts.md +401 -0
- package/extensions/agency-agents/agents/strategy/coordination/handoff-templates.md +357 -0
- package/extensions/agency-agents/agents/strategy/nexus-strategy.md +1110 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-0-discovery.md +178 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-1-strategy.md +238 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-2-foundation.md +278 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-3-build.md +286 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-4-hardening.md +332 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-5-launch.md +277 -0
- package/extensions/agency-agents/agents/strategy/playbooks/phase-6-operate.md +318 -0
- package/extensions/agency-agents/agents/strategy/runbooks/scenario-enterprise-feature.md +157 -0
- package/extensions/agency-agents/agents/strategy/runbooks/scenario-incident-response.md +217 -0
- package/extensions/agency-agents/agents/strategy/runbooks/scenario-marketing-campaign.md +187 -0
- package/extensions/agency-agents/agents/strategy/runbooks/scenario-startup-mvp.md +154 -0
- package/extensions/agency-agents/agents/support/support-analytics-reporter.md +363 -0
- package/extensions/agency-agents/agents/support/support-executive-summary-generator.md +210 -0
- package/extensions/agency-agents/agents/support/support-finance-tracker.md +440 -0
- package/extensions/agency-agents/agents/support/support-infrastructure-maintainer.md +616 -0
- package/extensions/agency-agents/agents/support/support-legal-compliance-checker.md +586 -0
- package/extensions/agency-agents/agents/support/support-support-responder.md +583 -0
- package/extensions/agency-agents/agents/testing/testing-accessibility-auditor.md +313 -0
- package/extensions/agency-agents/agents/testing/testing-api-tester.md +304 -0
- package/extensions/agency-agents/agents/testing/testing-evidence-collector.md +208 -0
- package/extensions/agency-agents/agents/testing/testing-performance-benchmarker.md +266 -0
- package/extensions/agency-agents/agents/testing/testing-reality-checker.md +236 -0
- package/extensions/agency-agents/agents/testing/testing-test-results-analyzer.md +303 -0
- package/extensions/agency-agents/agents/testing/testing-tool-evaluator.md +392 -0
- package/extensions/agency-agents/agents/testing/testing-workflow-optimizer.md +448 -0
- package/extensions/agency-agents/index.ts +733 -0
- package/extensions/agency-agents/node_modules/.bin/jiti +21 -0
- package/extensions/agency-agents/node_modules/.bin/tsc +21 -0
- package/extensions/agency-agents/node_modules/.bin/tsserver +21 -0
- package/extensions/agency-agents/node_modules/.bin/tsx +21 -0
- package/extensions/agency-agents/node_modules/.bin/vite +21 -0
- package/extensions/agency-agents/node_modules/.bin/vitest +21 -0
- package/extensions/agency-agents/node_modules/.bin/yaml +21 -0
- package/extensions/agency-agents/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -0
- package/extensions/agency-agents/package.json +25 -0
- package/extensions/agency-agents/poolbot.plugin.json +11 -0
- package/extensions/agency-agents/src/AgencyAgentsService.test.ts +443 -0
- package/extensions/agency-agents/src/AgencyAgentsService.ts +288 -0
- package/extensions/agency-agents/src/types.ts +147 -0
- package/extensions/agency-agents/vitest.config.ts +8 -0
- package/extensions/hexstrike-ai/README.md +98 -0
- package/extensions/hexstrike-ai/node_modules/.bin/tsc +21 -0
- package/extensions/hexstrike-ai/node_modules/.bin/tsserver +21 -0
- package/extensions/hexstrike-ai/package.json +29 -0
- package/extensions/hexstrike-ai/poolbot.plugin.json +31 -0
- package/extensions/hexstrike-ai/src/client.ts +91 -0
- package/extensions/hexstrike-ai/src/index.ts +170 -0
- package/extensions/hexstrike-ai/src/server/hexstrike_mcp.py +5470 -0
- package/extensions/hexstrike-ai/src/server/hexstrike_server.py +17289 -0
- package/extensions/hexstrike-ai/src/server/requirements.txt +84 -0
- package/extensions/hexstrike-ai/src/server-manager.ts +83 -0
- package/extensions/hexstrike-ai/tsconfig.json +20 -0
- package/extensions/page-agent/README.md +159 -0
- package/extensions/page-agent/index.ts +595 -0
- package/extensions/page-agent/node_modules/.bin/jiti +21 -0
- package/extensions/page-agent/node_modules/.bin/playwright +21 -0
- package/extensions/page-agent/node_modules/.bin/tsc +21 -0
- package/extensions/page-agent/node_modules/.bin/tsserver +21 -0
- package/extensions/page-agent/node_modules/.bin/tsx +21 -0
- package/extensions/page-agent/node_modules/.bin/vitest +21 -0
- package/extensions/page-agent/node_modules/.bin/yaml +21 -0
- package/extensions/page-agent/package.json +43 -0
- package/extensions/page-agent/poolbot.plugin.json +24 -0
- package/extensions/page-agent/src/PageAgentService.test.ts +517 -0
- package/extensions/page-agent/src/PageAgentService.ts +636 -0
- package/extensions/page-agent/src/PoolBotPageController.test.ts +358 -0
- package/extensions/page-agent/src/PoolBotPageController.ts +245 -0
- package/extensions/page-agent/src/index.ts +20 -0
- package/extensions/page-agent/src/tools.test.ts +231 -0
- package/extensions/page-agent/src/tools.ts +167 -0
- package/extensions/page-agent/src/types.ts +198 -0
- package/extensions/xyops/README.md +227 -0
- package/extensions/xyops/index.ts +342 -0
- package/extensions/xyops/node_modules/.bin/jiti +21 -0
- package/extensions/xyops/node_modules/.bin/tsc +21 -0
- package/extensions/xyops/node_modules/.bin/tsserver +21 -0
- package/extensions/xyops/node_modules/.bin/tsx +21 -0
- package/extensions/xyops/node_modules/.bin/vitest +21 -0
- package/extensions/xyops/node_modules/.bin/yaml +21 -0
- package/extensions/xyops/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -0
- package/extensions/xyops/package.json +39 -0
- package/extensions/xyops/poolbot.plugin.json +21 -0
- package/extensions/xyops/src/client.test.ts +467 -0
- package/extensions/xyops/src/client.ts +157 -0
- package/extensions/xyops/src/types.ts +147 -0
- package/extensions/xyops/vitest.config.ts +8 -0
- 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
|
+
```
|