# agency-agents
**Repository Path**: fociceo/agency-agents
## Basic Information
- **Project Name**: agency-agents
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ๐ญ The Agency: AI Specialists Ready to Transform Your Workflow
> **A complete AI agency at your fingertips** - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
[](https://github.com/msitarzewski/agency-agents)
[](https://opensource.org/licenses/MIT)
[](https://makeapullrequest.com)
[](https://github.com/sponsors/msitarzewski)
---
## ๐ What Is This?
Born from a Reddit thread and months of iteration, **The Agency** is a growing collection of meticulously crafted AI agent personalities. Each agent is:
- **๐ฏ Specialized**: Deep expertise in their domain (not generic prompt templates)
- **๐ง Personality-Driven**: Unique voice, communication style, and approach
- **๐ Deliverable-Focused**: Real code, processes, and measurable outcomes
- **โ
Production-Ready**: Battle-tested workflows and success metrics
**Think of it as**: Assembling your dream team, except they're AI specialists who never sleep, never complain, and always deliver.
---
## โก Quick Start
### Option 1: Use with Claude Code (Recommended)
```bash
# Copy agents to your Claude Code directory
cp -r agency-agents/* ~/.claude/agents/
# Now activate any agent in your Claude Code sessions:
# "Hey Claude, activate Frontend Developer mode and help me build a React component"
```
### Option 2: Use as Reference
Each agent file contains:
- Identity & personality traits
- Core mission & workflows
- Technical deliverables with code examples
- Success metrics & communication style
Browse the agents below and copy/adapt the ones you need!
### Option 3: Use with Other Tools (Cursor, Aider, Windsurf, Gemini CLI, OpenCode)
```bash
# Step 1 -- generate integration files for all supported tools
./scripts/convert.sh
# Step 2 -- install interactively (auto-detects what you have installed)
./scripts/install.sh
# Or target a specific tool directly
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
```
See the [Multi-Tool Integrations](#-multi-tool-integrations) section below for full details.
---
## ๐จ The Agency Roster
### ๐ป Engineering Division
Building the future, one commit at a time.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐จ [Frontend Developer](engineering/engineering-frontend-developer.md) | React/Vue/Angular, UI implementation, performance | Modern web apps, pixel-perfect UIs, Core Web Vitals optimization |
| ๐๏ธ [Backend Architect](engineering/engineering-backend-architect.md) | API design, database architecture, scalability | Server-side systems, microservices, cloud infrastructure |
| ๐ฑ [Mobile App Builder](engineering/engineering-mobile-app-builder.md) | iOS/Android, React Native, Flutter | Native and cross-platform mobile applications |
| ๐ค [AI Engineer](engineering/engineering-ai-engineer.md) | ML models, deployment, AI integration | Machine learning features, data pipelines, AI-powered apps |
| ๐ [DevOps Automator](engineering/engineering-devops-automator.md) | CI/CD, infrastructure automation, cloud ops | Pipeline development, deployment automation, monitoring |
| โก [Rapid Prototyper](engineering/engineering-rapid-prototyper.md) | Fast POC development, MVPs | Quick proof-of-concepts, hackathon projects, fast iteration |
| ๐ [Senior Developer](engineering/engineering-senior-developer.md) | Laravel/Livewire, advanced patterns | Complex implementations, architecture decisions |
| ๐ [Security Engineer](engineering/engineering-security-engineer.md) | Threat modeling, secure code review, security architecture | Application security, vulnerability assessment, security CI/CD |
### ๐จ Design Division
Making it beautiful, usable, and delightful.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฏ [UI Designer](design/design-ui-designer.md) | Visual design, component libraries, design systems | Interface creation, brand consistency, component design |
| ๐ [UX Researcher](design/design-ux-researcher.md) | User testing, behavior analysis, research | Understanding users, usability testing, design insights |
| ๐๏ธ [UX Architect](design/design-ux-architect.md) | Technical architecture, CSS systems, implementation | Developer-friendly foundations, implementation guidance |
| ๐ญ [Brand Guardian](design/design-brand-guardian.md) | Brand identity, consistency, positioning | Brand strategy, identity development, guidelines |
| ๐ [Visual Storyteller](design/design-visual-storyteller.md) | Visual narratives, multimedia content | Compelling visual stories, brand storytelling |
| โจ [Whimsy Injector](design/design-whimsy-injector.md) | Personality, delight, playful interactions | Adding joy, micro-interactions, Easter eggs, brand personality |
| ๐ท [Image Prompt Engineer](design/design-image-prompt-engineer.md) | AI image generation prompts, photography | Photography prompts for Midjourney, DALL-E, Stable Diffusion |
### ๐ข Marketing Division
Growing your audience, one authentic interaction at a time.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ [Growth Hacker](marketing/marketing-growth-hacker.md) | Rapid user acquisition, viral loops, experiments | Explosive growth, user acquisition, conversion optimization |
| ๐ [Content Creator](marketing/marketing-content-creator.md) | Multi-platform content, editorial calendars | Content strategy, copywriting, brand storytelling |
| ๐ฆ [Twitter Engager](marketing/marketing-twitter-engager.md) | Real-time engagement, thought leadership | Twitter strategy, LinkedIn campaigns, professional social |
| ๐ฑ [TikTok Strategist](marketing/marketing-tiktok-strategist.md) | Viral content, algorithm optimization | TikTok growth, viral content, Gen Z/Millennial audience |
| ๐ธ [Instagram Curator](marketing/marketing-instagram-curator.md) | Visual storytelling, community building | Instagram strategy, aesthetic development, visual content |
| ๐ค [Reddit Community Builder](marketing/marketing-reddit-community-builder.md) | Authentic engagement, value-driven content | Reddit strategy, community trust, authentic marketing |
| ๐ฑ [App Store Optimizer](marketing/marketing-app-store-optimizer.md) | ASO, conversion optimization, discoverability | App marketing, store optimization, app growth |
| ๐ [Social Media Strategist](marketing/marketing-social-media-strategist.md) | Cross-platform strategy, campaigns | Overall social strategy, multi-platform campaigns |
| ๐ [Xiaohongshu Specialist](marketing/marketing-xiaohongshu-specialist.md) | Lifestyle content, trend-driven strategy | Xiaohongshu growth, aesthetic storytelling, Gen Z audience |
| ๐ฌ [WeChat Official Account Manager](marketing/marketing-wechat-official-account.md) | Subscriber engagement, content marketing | WeChat OA strategy, community building, conversion optimization |
| ๐ง [Zhihu Strategist](marketing/marketing-zhihu-strategist.md) | Thought leadership, knowledge-driven engagement | Zhihu authority building, Q&A strategy, lead generation |
### ๐ Product Division
Building the right thing at the right time.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฏ [Sprint Prioritizer](product/product-sprint-prioritizer.md) | Agile planning, feature prioritization | Sprint planning, resource allocation, backlog management |
| ๐ [Trend Researcher](product/product-trend-researcher.md) | Market intelligence, competitive analysis | Market research, opportunity assessment, trend identification |
| ๐ฌ [Feedback Synthesizer](product/product-feedback-synthesizer.md) | User feedback analysis, insights extraction | Feedback analysis, user insights, product priorities |
### ๐ฌ Project Management Division
Keeping the trains running on time (and under budget).
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฌ [Studio Producer](project-management/project-management-studio-producer.md) | High-level orchestration, portfolio management | Multi-project oversight, strategic alignment, resource allocation |
| ๐ [Project Shepherd](project-management/project-management-project-shepherd.md) | Cross-functional coordination, timeline management | End-to-end project coordination, stakeholder management |
| โ๏ธ [Studio Operations](project-management/project-management-studio-operations.md) | Day-to-day efficiency, process optimization | Operational excellence, team support, productivity |
| ๐งช [Experiment Tracker](project-management/project-management-experiment-tracker.md) | A/B tests, hypothesis validation | Experiment management, data-driven decisions, testing |
| ๐ [Senior Project Manager](project-management/project-manager-senior.md) | Realistic scoping, task conversion | Converting specs to tasks, scope management |
### ๐งช Testing Division
Breaking things so users don't have to.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ธ [Evidence Collector](testing/testing-evidence-collector.md) | Screenshot-based QA, visual proof | UI testing, visual verification, bug documentation |
| ๐ [Reality Checker](testing/testing-reality-checker.md) | Evidence-based certification, quality gates | Production readiness, quality approval, release certification |
| ๐ [Test Results Analyzer](testing/testing-test-results-analyzer.md) | Test evaluation, metrics analysis | Test output analysis, quality insights, coverage reporting |
| โก [Performance Benchmarker](testing/testing-performance-benchmarker.md) | Performance testing, optimization | Speed testing, load testing, performance tuning |
| ๐ [API Tester](testing/testing-api-tester.md) | API validation, integration testing | API testing, endpoint verification, integration QA |
| ๐ ๏ธ [Tool Evaluator](testing/testing-tool-evaluator.md) | Technology assessment, tool selection | Evaluating tools, software recommendations, tech decisions |
| ๐ [Workflow Optimizer](testing/testing-workflow-optimizer.md) | Process analysis, workflow improvement | Process optimization, efficiency gains, automation opportunities |
| โฟ [Accessibility Auditor](testing/testing-accessibility-auditor.md) | WCAG auditing, assistive technology testing | Accessibility compliance, screen reader testing, inclusive design verification |
### ๐ Support Division
The backbone of the operation.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฌ [Support Responder](support/support-support-responder.md) | Customer service, issue resolution | Customer support, user experience, support operations |
| ๐ [Analytics Reporter](support/support-analytics-reporter.md) | Data analysis, dashboards, insights | Business intelligence, KPI tracking, data visualization |
| ๐ฐ [Finance Tracker](support/support-finance-tracker.md) | Financial planning, budget management | Financial analysis, cash flow, business performance |
| ๐๏ธ [Infrastructure Maintainer](support/support-infrastructure-maintainer.md) | System reliability, performance optimization | Infrastructure management, system operations, monitoring |
| โ๏ธ [Legal Compliance Checker](support/support-legal-compliance-checker.md) | Compliance, regulations, legal review | Legal compliance, regulatory requirements, risk management |
| ๐ [Executive Summary Generator](support/support-executive-summary-generator.md) | C-suite communication, strategic summaries | Executive reporting, strategic communication, decision support |
### ๐ฅฝ Spatial Computing Division
Building the immersive future.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐๏ธ [XR Interface Architect](spatial-computing/xr-interface-architect.md) | Spatial interaction design, immersive UX | AR/VR/XR interface design, spatial computing UX |
| ๐ป [macOS Spatial/Metal Engineer](spatial-computing/macos-spatial-metal-engineer.md) | Swift, Metal, high-performance 3D | macOS spatial computing, Vision Pro native apps |
| ๐ [XR Immersive Developer](spatial-computing/xr-immersive-developer.md) | WebXR, browser-based AR/VR | Browser-based immersive experiences, WebXR apps |
| ๐ฎ [XR Cockpit Interaction Specialist](spatial-computing/xr-cockpit-interaction-specialist.md) | Cockpit-based controls, immersive systems | Cockpit control systems, immersive control interfaces |
| ๐ [visionOS Spatial Engineer](spatial-computing/visionos-spatial-engineer.md) | Apple Vision Pro development | Vision Pro apps, spatial computing experiences |
| ๐ [Terminal Integration Specialist](spatial-computing/terminal-integration-specialist.md) | Terminal integration, command-line tools | CLI tools, terminal workflows, developer tools |
### ๐ฏ Specialized Division
The unique specialists who don't fit in a box.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ญ [Agents Orchestrator](specialized/agents-orchestrator.md) | Multi-agent coordination, workflow management | Complex projects requiring multiple agent coordination |
| ๐ [Data Analytics Reporter](specialized/data-analytics-reporter.md) | Business intelligence, data insights | Deep data analysis, business metrics, strategic insights |
| ๐ [LSP/Index Engineer](specialized/lsp-index-engineer.md) | Language Server Protocol, code intelligence | Code intelligence systems, LSP implementation, semantic indexing |
| ๐ฅ [Sales Data Extraction Agent](specialized/sales-data-extraction-agent.md) | Excel monitoring, sales metric extraction | Sales data ingestion, MTD/YTD/Year End metrics |
| ๐ [Data Consolidation Agent](specialized/data-consolidation-agent.md) | Sales data aggregation, dashboard reports | Territory summaries, rep performance, pipeline snapshots |
| ๐ฌ [Report Distribution Agent](specialized/report-distribution-agent.md) | Automated report delivery | Territory-based report distribution, scheduled sends |
| ๐ [Agentic Identity & Trust Architect](specialized/agentic-identity-trust.md) | Agent identity, authentication, trust verification | Multi-agent identity systems, agent authorization, audit trails |
---
## ๐ฏ Real-World Use Cases
### Scenario 1: Building a Startup MVP
**Your Team**:
1. ๐จ **Frontend Developer** - Build the React app
2. ๐๏ธ **Backend Architect** - Design the API and database
3. ๐ **Growth Hacker** - Plan user acquisition
4. โก **Rapid Prototyper** - Fast iteration cycles
5. ๐ **Reality Checker** - Ensure quality before launch
**Result**: Ship faster with specialized expertise at every stage.
---
### Scenario 2: Marketing Campaign Launch
**Your Team**:
1. ๐ **Content Creator** - Develop campaign content
2. ๐ฆ **Twitter Engager** - Twitter strategy and execution
3. ๐ธ **Instagram Curator** - Visual content and stories
4. ๐ค **Reddit Community Builder** - Authentic community engagement
5. ๐ **Analytics Reporter** - Track and optimize performance
**Result**: Multi-channel coordinated campaign with platform-specific expertise.
---
### Scenario 3: Enterprise Feature Development
**Your Team**:
1. ๐ **Senior Project Manager** - Scope and task planning
2. ๐ **Senior Developer** - Complex implementation
3. ๐จ **UI Designer** - Design system and components
4. ๐งช **Experiment Tracker** - A/B test planning
5. ๐ธ **Evidence Collector** - Quality verification
6. ๐ **Reality Checker** - Production readiness
**Result**: Enterprise-grade delivery with quality gates and documentation.
---
### Scenario 4: Full Agency Product Discovery
**Your Team**: All 8 divisions working in parallel on a single mission.
See the **[Nexus Spatial Discovery Exercise](examples/nexus-spatial-discovery.md)** -- a complete example where 8 agents (Product Trend Researcher, Backend Architect, Brand Guardian, Growth Hacker, Support Responder, UX Researcher, Project Shepherd, and XR Interface Architect) were deployed simultaneously to evaluate a software opportunity and produce a unified product plan covering market validation, technical architecture, brand strategy, go-to-market, support systems, UX research, project execution, and spatial UI design.
**Result**: Comprehensive, cross-functional product blueprint produced in a single session. [More examples](examples/).
---
## ๐ค Contributing
We welcome contributions! Here's how you can help:
### Add a New Agent
1. Fork the repository
2. Create a new agent file in the appropriate category
3. Follow the agent template structure:
- Frontmatter with name, description, color
- Identity & Memory section
- Core Mission
- Critical Rules (domain-specific)
- Technical Deliverables with examples
- Workflow Process
- Success Metrics
4. Submit a PR with your agent
### Improve Existing Agents
- Add real-world examples
- Enhance code samples
- Update success metrics
- Improve workflows
### Share Your Success Stories
Have you used these agents successfully? Share your story in the [Discussions](https://github.com/msitarzewski/agency-agents/discussions)!
---
## ๐ Agent Design Philosophy
Each agent is designed with:
1. **๐ญ Strong Personality**: Not generic templates - real character and voice
2. **๐ Clear Deliverables**: Concrete outputs, not vague guidance
3. **โ
Success Metrics**: Measurable outcomes and quality standards
4. **๐ Proven Workflows**: Step-by-step processes that work
5. **๐ก Learning Memory**: Pattern recognition and continuous improvement
---
## ๐ What Makes This Special?
### Unlike Generic AI Prompts:
- โ Generic "Act as a developer" prompts
- โ
Deep specialization with personality and process
### Unlike Prompt Libraries:
- โ One-off prompt collections
- โ
Comprehensive agent systems with workflows and deliverables
### Unlike AI Tools:
- โ Black box tools you can't customize
- โ
Transparent, forkable, adaptable agent personalities
---
## ๐จ Agent Personality Highlights
> "I don't just test your code - I default to finding 3-5 issues and require visual proof for everything."
>
> -- **Evidence Collector** (Testing Division)
> "You're not marketing on Reddit - you're becoming a valued community member who happens to represent a brand."
>
> -- **Reddit Community Builder** (Marketing Division)
> "Every playful element must serve a functional or emotional purpose. Design delight that enhances rather than distracts."
>
> -- **Whimsy Injector** (Design Division)
> "Let me add a celebration animation that reduces task completion anxiety by 40%"
>
> -- **Whimsy Injector** (during a UX review)
---
## ๐ Stats
- ๐ญ **61 Specialized Agents** across 9 divisions
- ๐ **10,000+ lines** of personality, process, and code examples
- โฑ๏ธ **Months of iteration** from real-world usage
- ๐ **Battle-tested** in production environments
- ๐ฌ **50+ requests** in first 12 hours on Reddit
---
## ๐ Multi-Tool Integrations
The Agency works natively with Claude Code, and ships conversion + install scripts so you can use the same agents across every major agentic coding tool.
### Supported Tools
- **[Claude Code](https://claude.ai/code)** โ native `.md` agents, no conversion needed โ `~/.claude/agents/`
- **[Antigravity](https://github.com/google-gemini/antigravity)** โ `SKILL.md` per agent โ `~/.gemini/antigravity/skills/`
- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** โ extension + `SKILL.md` files โ `~/.gemini/extensions/agency-agents/`
- **[OpenCode](https://opencode.ai)** โ `.md` agent files โ `.opencode/agent/`
- **[Cursor](https://cursor.sh)** โ `.mdc` rule files โ `.cursor/rules/`
- **[Aider](https://aider.chat)** โ single `CONVENTIONS.md` โ `./CONVENTIONS.md`
- **[Windsurf](https://codeium.com/windsurf)** โ single `.windsurfrules` โ `./.windsurfrules`
---
### โก Quick Install
**Step 1 -- Generate integration files:**
```bash
./scripts/convert.sh
```
**Step 2 -- Install (interactive, auto-detects your tools):**
```bash
./scripts/install.sh
```
The installer scans your system for installed tools, shows a checkbox UI, and lets you pick exactly what to install:
```
+------------------------------------------------+
| The Agency -- Tool Installer |
+------------------------------------------------+
System scan: [*] = detected on this machine
[x] 1) [*] Claude Code (claude.ai/code)
[x] 2) [*] Antigravity (~/.gemini/antigravity)
[ ] 3) [ ] Gemini CLI (gemini extension)
[ ] 4) [ ] OpenCode (opencode.ai)
[x] 5) [*] Cursor (.cursor/rules)
[ ] 6) [ ] Aider (CONVENTIONS.md)
[ ] 7) [ ] Windsurf (.windsurfrules)
[1-7] toggle [a] all [n] none [d] detected
[Enter] install [q] quit
```
**Or install a specific tool directly:**
```bash
./scripts/install.sh --tool cursor
./scripts/install.sh --tool opencode
./scripts/install.sh --tool antigravity
```
**Non-interactive (CI/scripts):**
```bash
./scripts/install.sh --no-interactive --tool all
```
---
### Tool-Specific Instructions
Claude Code
Agents are copied directly from the repo into `~/.claude/agents/` -- no conversion needed.
```bash
./scripts/install.sh --tool claude-code
```
Then activate in Claude Code:
```
Use the Frontend Developer agent to review this component.
```
See [integrations/claude-code/README.md](integrations/claude-code/README.md) for details.
Antigravity (Gemini)
Each agent becomes a skill in `~/.gemini/antigravity/skills/agency-Gemini CLI
Installs as a Gemini CLI extension with 61 skills + a manifest.
```bash
./scripts/install.sh --tool gemini-cli
```
See [integrations/gemini-cli/README.md](integrations/gemini-cli/README.md) for details.
OpenCode
Agents are placed in `.opencode/agent/` in your project root (project-scoped).
```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode
```
Or install globally:
```bash
mkdir -p ~/.config/opencode/agent
cp integrations/opencode/agent/*.md ~/.config/opencode/agent/
```
Activate in OpenCode:
```
Use the Backend Architect agent to design this API.
```
See [integrations/opencode/README.md](integrations/opencode/README.md) for details.
Cursor
Each agent becomes a `.mdc` rule file in `.cursor/rules/` of your project.
```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool cursor
```
Rules are auto-applied when Cursor detects them in the project. Reference them explicitly:
```
Use the @security-engineer rules to review this code.
```
See [integrations/cursor/README.md](integrations/cursor/README.md) for details.
Aider
All agents are compiled into a single `CONVENTIONS.md` file that Aider reads automatically.
```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool aider
```
Then reference agents in your Aider session:
```
Use the Frontend Developer agent to refactor this component.
```
See [integrations/aider/README.md](integrations/aider/README.md) for details.
Windsurf
All agents are compiled into `.windsurfrules` in your project root.
```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool windsurf
```
Reference agents in Windsurf's Cascade:
```
Use the Reality Checker agent to verify this is production ready.
```
See [integrations/windsurf/README.md](integrations/windsurf/README.md) for details.