# Technical Documentation: msitarzewski/agency-agents
> โน๏ธ **Provenance:** Multi-Tier Ingestion ยท [CodeWiki Reference](https://codewiki.google/github.com/msitarzewski/agency-agents)
### Overview (`README.md`)
# ๐ญ 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)
[](https://github.com/msitarzewski/agency-agents-app/releases/latest)
> ### ๐ There's an app now
>
> **[Agency Agents](https://agencyagents.app)** is a native app for **macOS, Linux & Windows** that browses the entire roster and installs it into Claude Code, Cursor, Codex, Gemini, Osaurus, and more โ with a click. No clone, no scripts, and it auto-updates.
>
> **โ [Download the latest release](https://github.com/msitarzewski/agency-agents-app/releases/latest) ยท [agencyagents.app](https://agencyagents.app)**
---
## ๐ 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: Install the app (Recommended)
The fastest way in โ no clone, no terminal. [**Agency Agents**](https://agencyagents.app) is a native desktop app (macOS ยท Linux ยท Windows) that browses the whole roster and installs agents into Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Qwen, and Osaurus for you, then keeps them up to date.
**[โฌ Download the latest release](https://github.com/msitarzewski/agency-agents-app/releases/latest)** โ or on a Mac:
```bash
brew install --cask msitarzewski/agency-agents/agency-agents
```
Prefer the command line? The script-based options below install the same agents.
### Option 2: Use with Claude Code
```bash
# Install all agents to your Claude Code directory
./scripts/install.sh --tool claude-code
# Or manually copy a category if you only want one division
cp engineering/*.md ~/.claude/agents/
# Then activate any agent in your Claude Code sessions:
# "Hey Claude, activate Frontend Developer mode and help me build a React component"
```
### Option 3: 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 4: Use with Other Tools (GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Kimi Code, Codex, Osaurus, Hermes, Mistral Vibe, DeepSeek Harness)
```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 antigravity
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool opencode
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool kimi
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes
./scripts/install.sh --tool vibe
./scripts/install.sh --tool dsh
```
**Install only the teams you need** (not everyone wants every division):
```bash
./scripts/install.sh # interactive wizard: pick tools + teams
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
./scripts/install.sh --list teams # see every team + agent count
./scripts/install.sh --tool opencode --division engineering --dry-run
```
`--agent` and `--agents-file` take an agent's slug (as `--list agents` prints it), its display name, or its file name without `.md` โ the id the [runbook rosters](strategy/runbooks.json) use โ so a runbook's team installs as listed:
```bash
python3 -c 'import json, sys
for r in json.load(open("strategy/runbooks.json"))["runbooks"]:
if r["slug"] == sys.argv[1]: [print(a) for g in r["roster"] for a in g["agents"]]' startup-mvp > team.txt
./scripts/install.sh --tool claude-code --agents-file team.txt
```
> **OpenCode note:** OpenCode's runtime currently registers only ~119 agents and silently drops the rest ([upstream bug](https://github.com/anomalyco/opencode/issues/27988)). Installing a subset with `--division` keeps you under that limit. The installer warns you when a selection would exceed it.
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 |
| ๐ [Network Engineer](engineering/engineering-network-engineer.md) | Cisco IOS/IOS-XE, Juniper Junos, Palo Alto PAN-OS | Router/switch/firewall configuration, BGP/OSPF, ACLs, show-output troubleshooting |
| โก [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 |
| ๐ง [Filament Optimization Specialist](engineering/engineering-filament-optimization-specialist.md) | Filament PHP admin UX, structural form redesign, resource optimization | Restructuring Filament resources/forms/tables for faster, cleaner admin workflows |
| โก [Autonomous Optimization Architect](engineering/engineering-autonomous-optimization-architect.md) | LLM routing, cost optimization, shadow testing | Autonomous systems needing intelligent API selection and cost guardrails |
| ๐ฉ [Embedded Firmware Engineer](engineering/engineering-embedded-firmware-engineer.md) | Bare-metal, RTOS, ESP32/STM32/Nordic firmware | Production-grade embedded systems and IoT devices |
| ๐จ [Incident Response Commander](engineering/engineering-incident-response-commander.md) | Incident management, post-mortems, on-call | Managing production incidents and building incident readiness |
| โ๏ธ [Solidity Smart Contract Engineer](engineering/engineering-solidity-smart-contract-engineer.md) | EVM contracts, gas optimization, DeFi | Secure, gas-optimized smart contracts and DeFi protocols |
| ๐งญ [Codebase Onboarding Engineer](engineering/engineering-codebase-onboarding-engineer.md) | Fast developer onboarding, read-only codebase exploration, factual explanation | Helping new developers understand unfamiliar repos quickly by reading the code, tracing code paths, and stating facts about structure and behavior |
| ๐ [Technical Writer](engineering/engineering-technical-writer.md) | Developer docs, API reference, tutorials | Clear, accurate technical documentation |
| ๐ฌ [WeChat Mini Program Developer](engineering/engineering-wechat-mini-program-developer.md) | WeChat ecosystem, Mini Programs, payment integration | Building performant apps for the WeChat ecosystem |
| ๐๏ธ [Code Reviewer](engineering/engineering-code-reviewer.md) | Constructive code review, security, maintainability | PR reviews, code quality gates, mentoring through review |
| ๐๏ธ [Database Optimizer](engineering/engineering-database-optimizer.md) | Schema design, query optimization, indexing strategies | PostgreSQL/MySQL tuning, slow query debugging, migration planning |
| ๐ฟ [Git Workflow Master](engineering/engineering-git-workflow-master.md) | Branching strategies, conventional commits, advanced Git | Git workflow design, history cleanup, CI-friendly branch management |
| ๐๏ธ [Software Architect](engineering/engineering-software-architect.md) | System design, DDD, architectural patterns, trade-off analysis | Architecture decisions, domain modeling, system evolution strategy |
| ๐ก๏ธ [SRE](engineering/engineering-sre.md) | SLOs, error budgets, observability, chaos engineering | Production reliability, toil reduction, capacity planning |
| ๐งฌ [AI Data Remediation Engineer](engineering/engineering-ai-data-remediation-engineer.md) | Self-healing pipelines, air-gapped SLMs, semantic clustering | Fixing broken data at scale with zero data loss |
| ๐ง [Data Engineer](engineering/engineering-data-engineer.md) | Data pipelines, lakehouse architecture, ETL/ELT | Building reliable data infrastructure and warehousing |
| ๐ [Feishu Integration Developer](engineering/engineering-feishu-integration-developer.md) | Feishu/Lark Open Platform, bots, workflows | Building integrations for the Feishu ecosystem |
| ๐งฑ [CMS Developer](engineering/engineering-cms-developer.md) | WordPress & Drupal themes, plugins/modules, content architecture | Code-first CMS implementation and customization |
| ๐ง [Email Intelligence Engineer](engineering/engineering-email-intelligence-engineer.md) | Email parsing, MIME extraction, structured data for AI agents | Turning raw email threads into reasoning-ready context |
| ๐๏ธ [Voice AI Integration Engineer](engineering/engineering-voice-ai-integration-engineer.md) | Speech-to-text pipelines, Whisper, ASR, speaker diarization | End-to-end transcription pipelines, audio preprocessing, structured transcript delivery |
| ๐ง [IT Service Manager](engineering/engineering-it-service-manager.md) | ITIL 4 service management | Incident/problem/change management, SLAs, CMDB |
| ๐ชก [Minimal Change Engineer](engineering/engineering-minimal-change-engineer.md) | Minimum-viable diffs | Fixing only what's asked, no scope creep |
| ๐ [OrgScript Engineer](engineering/engineering-orgscript-engineer.md) | OrgScript grammar & AST validation | Designing/parsing OrgScript business-logic definitions |
| ๐งฌ [Prompt Engineer](engineering/engineering-prompt-engineer.md) | LLM prompt design & optimization | Turning vague instructions into reliable AI behaviors |
| ๐ธ๏ธ [Multi-Agent Systems Architect](engineering/engineering-multi-agent-systems-architect.md) | Multi-agent pipeline design & governance | Topology, context, trust, failure recovery for agent systems |
| ๐ [Drupal Shopping Cart Engineer](engineering/engineering-drupal-shopping-cart.md) | Drupal Commerce storefronts | Catalog, payments, checkout, orders on Drupal 10/11 |
| ๐๏ธ [WordPress Shopping Cart Engineer](engineering/engineering-wordpress-shopping-cart.md) | WooCommerce storefronts | Catalog, payments, checkout, conversion on WordPress |
| ๐ณ [Payments & Billing Engineer](engineering/engineering-payments-billing-engineer.md) | PSP integration, idempotent payment flows, subscription billing | Stripe/Adyen/Braintree integrations, webhook processing, dunning, reconciliation |
| ๐ [Internationalization Engineer](engineering/engineering-i18n-engineer.md) | ICU MessageFormat, RTL/bidi layouts, CLDR formatting, pseudo-localization | Making apps translation-ready, locale-aware formatting, RTL support, i18n audits |
| โก [Drupal Performance Engineer](engineering/engineering-drupal-performance.md) | Drupal performance & Core Web Vitals | Caching, DB/query tuning, render pipeline, profiling high-traffic Drupal |
| โก [WordPress Performance Engineer](engineering/engineering-wordpress-performance.md) | WordPress performance & Core Web Vitals | Caching, query/asset optimization, plugin tuning, profiling high-traffic WP |
| โฟ [Section 508 Accessibility Specialist](engineering/engineering-section-508-specialist.md) | US federal 508 / WCAG accessibility | ARIA, screen-reader testing, VPAT/ACR authoring, remediation |
| ๐๏ธ [USWDS Developer](engineering/engineering-uswds-developer.md) | US Web Design System (federal) | Accessible gov UI components & design-system patterns |
| ๐ [Search Relevance Engineer](engineering/engineering-search-relevance-engineer.md) | Search ranking & relevance | Query understanding, embeddings, ranking/eval, relevance tuning |
| ๐ [Identity & Access Engineer](engineering/engineering-identity-access-engineer.md) | AuthN/AuthZ & IAM | OAuth/OIDC/SAML, SSO, RBAC/ABAC, token & session security |
| ๐ค [Realtime Collaboration Engineer](engineering/engineering-realtime-collaboration-engineer.md) | Realtime sync & presence | CRDTs/OT, conflict resolution, live cursors, offline sync |
| ๐ป [Desktop App Engineer](engineering/engineering-desktop-app-engineer.md) | Cross-platform desktop apps | Electron/Tauri, native integration, packaging, auto-update |
| ๐ [Mobile Release Engineer](engineering/engineering-mobile-release-engineer.md) | Mobile release & CI/CD | App Store/Play submission, signing, staged rollout, crash triage |
| ๐ฌ [Video Streaming Engineer](engineering/engineering-video-streaming-engineer.md) | Video streaming & transcoding | HLS/DASH, ABR, codecs, CDN delivery, low-latency streaming |
| ๐ฐ [FinOps Engineer](engineering/engineering-finops-engineer.md) | Cloud cost engineering | Cost allocation, rightsizing, unit economics, budget & anomaly control |
| ๐งฉ [WebAssembly Engineer](engineering/engineering-webassembly-engineer.md) | WebAssembly & WASI | Rust/C++โWASM, sandboxing, host bindings, performance |
| ๐ [API Platform Engineer](engineering/engineering-api-platform-engineer.md) | API gateways & platforms | Gateway design, versioning, rate limiting, developer portals |
| ๐ [Database Reliability Engineer](engineering/engineering-database-reliability-engineer.md) | Database reliability (DBRE) | HA/replication, automated failover, PITR backups, zero-downtime ops |
| ๐ ๏ธ [Developer Tooling Engineer](engineering/engineering-developer-tooling-engineer.md) | CLI & developer tooling | Command-line tools, internal DX, build/dev workflows |
| ๐ก [IoT Fleet Engineer](engineering/engineering-iot-fleet-engineer.md) | IoT & edge fleet | Device provisioning/identity, MQTT telemetry, OTA updates |
| ๐ [RAG Pipeline Engineer](engineering/engineering-rag-pipeline-engineer.md) | Production RAG pipelines | Chunking, retrieval quality, hybrid search, re-ranking, eval-driven iteration |
| ๐๏ธ [GaussDB Expert Engineer](engineering/engineering-gaussdb-expert.md) | Huawei GaussDB OLTP | Enterprise OLTP performance, HA, and migration on Huawei's GaussDB |
| ๐ต๏ธ [Privacy Engineer](engineering/engineering-privacy-engineer.md) | PII discovery, data minimization, consent enforcement, DSAR/deletion pipelines | Implementing privacy in code, right-to-be-forgotten across services, retention automation |
| ๐ฆ [Rust Refactoring Specialist](engineering/engineering-rust-refactoring-specialist.md) | Behavior-aware Rust refactoring | Reforming crates/traits/modules with evidence-based, behavior-preserving changes |
| ๐งช [LLM Post-Training Engineer](engineering/engineering-llm-post-training-engineer.md) | Post-training stack (SFT/DPO/GRPO/RLVR) | Evidence-based experiment gating, checkpoint integrity, failure classification |
| ๐ [Data Visualization Engineer](engineering/engineering-data-visualization-engineer.md) | Perceptually honest data viz | Chart-type selection, colorblind-safe palettes, performant D3/Vega rendering |
| ๐ง [Knowledge Graph Engineer](engineering/engineering-knowledge-graph-engineer.md) | Knowledge graphs, entity-relationship extraction, graph-enhanced RAG | Structuring documents into queryable Neo4j graphs with LangGraph; provenance, contradiction tracking, subgraph retrieval |
| ๐ [China Network Engineer](engineering/engineering-china-network-engineer.md) | Huawei VRP, H3C Comware, Ruijie RGOS, Hillstone StoneOS | Routing/switching/firewall design, NAT, MLPS 2.0 compliant borders, change windows with rollback plans |
| ๐ค๏ธ [Platform Engineer](engineering/engineering-platform-engineer.md) | Internal developer platforms, golden paths, IDPs, self-serve infrastructure | Paved-road scaffolding, developer experience measurement, platform-as-a-product roadmaps |
| ๐ [PDF Engine Architect](engineering/engineering-pdf-engine-architect.md) | Deterministic HTML-to-PDF compilation, tagged PDF/UA and PDF/A | Playwright render pools, dynamic page sizing, archival-grade document output |
| ๐ฏ [ATS Validator Architect](engineering/engineering-ats-validator-architect.md) | Resume parseability, ATS ingestion pipelines | BM25/TF-IDF relevance scoring, layout linearization audits, EU AI Act and NYC LL144 compliance |
| ๐ [Universal Document Compiler](engineering/engineering-universal-document-compiler.md) | Schema-agnostic document ASTs, data-shape layout inference, paged publishing | Compiling arbitrary YAML trees into proposals, technical specs, executive dossiers |
| ๐ ๏ธ [ServiceNow Developer & Mentor](engineering/engineering-servicenow-developer-mentor.md) | Business Rules, Script Includes, GlideAjax, ACLs, Flow Designer | ServiceNow development and step-by-step instance troubleshooting |
### ๐จ 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 |
| ๐ [Inclusive Visuals Specialist](design/design-inclusive-visuals-specialist.md) | Representation, bias mitigation, authentic imagery | Generating culturally accurate AI images and video |
| ๐ญ [Persona Walkthrough Specialist](design/design-persona-walkthrough.md) | Persona-driven cognitive walkthroughs | Simulating user reactions and friction at each scroll position |
| ๐งฑ [UI Finish-Gate Reviewer](design/design-ui-finish-gate-reviewer.md) | Anti-generic UI finish gate | Catching interchangeable UI before ship via evidence + a written design contract |
### ๐ฐ Paid Media Division
Turning ad spend into measurable business outcomes.
| Agent | Specialty | When to Use |
| --- | --- | --- |
| ๐ฐ [PPC Campaign Strategist](paid-media/paid-media-ppc-strategist.md) | Google/Microsoft/Amazon Ads, account architecture, bidding | Account buildouts, budget allocation, scaling, performance diagnosis |
| ๐ [Search Query Analyst](paid-media/paid-media-search-query-analyst.md) | Search term analysis, negative keywords, intent mapping | Query audits, wasted spend elimination, keyword discovery |
| ๐ [Paid Media Auditor](paid-media/paid-media-auditor.md) | 200+ point account audits, competitive analysis | Account takeovers, quarterly reviews, competitive pitches |
| ๐ก [Tracking & Measurement Specialist](paid-media/paid-media-tracking-specialist.md) | GTM, GA4, conversion tracking, CAPI | New implementations, tracking audits, platform migrations |
| โ๏ธ [Ad Creative Strategist](paid-media/paid-media-creative-strategist.md) | RSA copy, Meta creative, Performance Max assets | Creative launches, testing programs, ad fatigue refreshes |
| ๐บ [Programmatic & Display Buyer](paid-media/paid-media-programmatic-buyer.md) | GDN, DSPs, partner media, ABM display | Display planning, partner outreach, ABM programs |
| ๐ฑ [Paid Social Strategist](paid-media/paid-media-paid-social-strategist.md) | Meta, LinkedIn, TikTok, cross-platform social | Social ad programs, platform selection, audience strategy |
### ๐ผ Sales Division
Turning pipeline into revenue through craft, not CRM busywork.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฏ [Outbound Strategist](sales/sales-outbound-strategist.md) | Signal-based prospecting, multi-channel sequences, ICP targeting | Building pipeline through research-driven outreach, not volume |
| ๐ [Discovery Coach](sales/sales-discovery-coach.md) | SPIN, Gap Selling, Sandler โ question design and call structure | Preparing for discovery calls, qualifying opportunities, coaching reps |
| โ๏ธ [Deal Strategist](sales/sales-deal-strategist.md) | MEDDPICC qualification, competitive positioning, win planning | Scoring deals, exposing pipeline risk, building win strategies |
| ๐ ๏ธ [Sales Engineer](sales/sales-engineer.md) | Technical demos, POC scoping, competitive battlecards | Pre-sales technical wins, demo prep, competitive positioning |
| ๐น [Proposal Strategist](sales/sales-proposal-strategist.md) | RFP response, win themes, narrative structure | Writing proposals that persuade, not just comply |
| ๐ [Pipeline Analyst](sales/sales-pipeline-analyst.md) | Forecasting, pipeline health, deal velocity, RevOps | Pipeline reviews, forecast accuracy, revenue operations |
| ๐บ๏ธ [Account Strategist](sales/sales-account-strategist.md) | Land-and-expand, QBRs, stakeholder mapping | Post-sale expansion, account planning, NRR growth |
| ๐๏ธ [Sales Coach](sales/sales-coach.md) | Rep development, call coaching, pipeline review facilitation | Making every rep and every deal better through structured coaching |
| ๐ฏ [Sales Outreach](specialized/sales-outreach.md) | Cold prospecting, multi-touch cadences, objection handling, proposals | Top-of-funnel B2B outreach โ from cold email to booked discovery call |
| ๐งฒ [Offer & Lead Gen Strategist](sales/sales-offer-lead-gen-strategist.md) | Offers & lead magnets | Top-of-funnel offer construction and lead gen |
### ๐ข 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 |
| ๐ฐ๏ธ [X/Twitter Intelligence Analyst](marketing/marketing-x-twitter-intelligence-analyst.md) | Social listening, trend detection, account monitoring | Brand risk, competitor, and audience intelligence on X/Twitter |
| ๐ฑ [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 |
| ๐ฑ [Developer Community Builder](marketing/marketing-developer-community-builder.md) | Discord/forum architecture, contributor programs, community health | Building developer communities that members actually value |
| ๐ฑ [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 |
| ๐จ๐ณ [Baidu SEO Specialist](marketing/marketing-baidu-seo-specialist.md) | Baidu optimization, China SEO, ICP compliance | Ranking in Baidu and reaching China's search market |
| ๐ฌ [Bilibili Content Strategist](marketing/marketing-bilibili-content-strategist.md) | B็ซ algorithm, danmaku culture, UPไธป growth | Building audiences on Bilibili with community-first content |
| ๐ [Carousel Growth Engine](marketing/marketing-carousel-growth-engine.md) | TikTok/Instagram carousels, autonomous publishing | Generating and publishing viral carousel content |
| ๐ผ [LinkedIn Content Creator](marketing/marketing-linkedin-content-creator.md) | Personal branding, thought leadership, professional content | LinkedIn growth, professional audience building, B2B content |
| ๐ [China E-Commerce Operator](marketing/marketing-china-ecommerce-operator.md) | Taobao, Tmall, Pinduoduo, live commerce | Running multi-platform e-commerce in China |
| ๐ฅ [Kuaishou Strategist](marketing/marketing-kuaishou-strategist.md) | Kuaishou, ่้ community, grassroots growth | Building authentic audiences in lower-tier markets |
| ๐ [SEO Specialist](marketing/marketing-seo-specialist.md) | Technical SEO, content strategy, link building | Driving sustainable organic search growth |
| ๐ [Book Co-Author](marketing/marketing-book-co-author.md) | Thought-leadership books, ghostwriting, publishing | Strategic book collaboration for founders and experts |
| ๐ [Cross-Border E-Commerce Specialist](marketing/marketing-cross-border-ecommerce.md) | Amazon, Shopee, Lazada, cross-border fulfillment | Full-funnel cross-border e-commerce strategy |
| ๐ต [Douyin Strategist](marketing/marketing-douyin-strategist.md) | Douyin platform, short-video marketing, algorithm | Growing audiences on China's leading short-video platform |
| ๐๏ธ [Livestream Commerce Coach](marketing/marketing-livestream-commerce-coach.md) | Host training, live room optimization, conversion | Building high-performing livestream e-commerce operations |
| ๐ง [Podcast Strategist](marketing/marketing-podcast-strategist.md) | Podcast content strategy, platform optimization | Chinese podcast market strategy and operations |
| ๐ [Private Domain Operator](marketing/marketing-private-domain-operator.md) | WeCom, private traffic, community operations | Building enterprise WeChat private domain ecosystems |
| ๐ฌ [Short-Video Editing Coach](marketing/marketing-short-video-editing-coach.md) | Post-production, editing workflows, platform specs | Hands-on short-video editing training and optimization |
| ๐ฅ [Weibo Strategist](marketing/marketing-weibo-strategist.md) | Sina Weibo, trending topics, fan engagement | Full-spectrum Weibo operations and growth |
| ๐๏ธ [Global Podcast Strategist](marketing/marketing-global-podcast-strategist.md) | Show positioning, audience growth, monetisation | Podcast launch, platform algorithms, sponsorship, community building |
| ๐ฎ [AI Citation Strategist](marketing/marketing-ai-citation-strategist.md) | AEO/GEO, AI recommendation visibility, citation auditing | Improving brand visibility across ChatGPT, Claude, Gemini, Perplexity |
| ๐จ๐ณ [China Market Localization Strategist](marketing/marketing-china-market-localization-strategist.md) | Full-stack China market localization, Douyin/Xiaohongshu/WeChat GTM | Turning trend signals into executable China go-to-market strategies |
| ๐ฌ [Video Optimization Specialist](marketing/marketing-video-optimization-specialist.md) | YouTube algorithm strategy, chaptering, thumbnail concepts | YouTube channel growth, video SEO, audience retention optimization |
| ๐๏ธ [AEO Foundations Architect](marketing/marketing-aeo-foundations.md) | AI Engine Optimization infrastructure | llms.txt, AI-aware robots.txt, agent discovery files |
| ๐ค [Agentic Search Optimizer](marketing/marketing-agentic-search-optimizer.md) | WebMCP & agentic task completion | Making sites usable by AI browsing agents |
| ๐ง [Email Marketing Strategist](marketing/marketing-email-strategist.md) | Lifecycle email & deliverability | CRM campaigns, automation, segmentation |
| ๐ก [Multi-Platform Publisher](marketing/marketing-multi-platform-publisher.md) | One-click Chinese multi-platform publishing | Routing one article to ็ฅไน/ๅฐ็บขไนฆ/CSDN/B็ซ/ๅ
ฌไผๅท/ๆ้ |
| ๐ฃ [PR & Communications Manager](marketing/marketing-pr-communications-manager.md) | PR, media relations & crisis comms | Press releases, thought leadership, reputation |
### ๐ 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 |
| ๐ฌ [DX Engineer](product/product-dx-engineer.md) | Onboarding friction, SDK ergonomics, error messages | Cutting a developer's time to first success |
| ๐ง [Behavioral Nudge Engine](product/product-behavioral-nudge-engine.md) | Behavioral psychology, nudge design, engagement | Maximizing user motivation through behavioral science |
| ๐งญ [Product Manager](product/product-manager.md) | Full lifecycle product ownership | Discovery, PRDs, roadmap planning, GTM, outcome measurement |
### ๐ฌ 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 |
| ๐ [Jira Workflow Steward](project-management/project-management-jira-workflow-steward.md) | Git workflow, branch strategy, traceability | Enforcing Jira-linked Git discipline and delivery |
| ๐ [Meeting Notes Specialist](project-management/project-management-meeting-notes-specialist.md) | Structured meeting summaries | Extracting decisions, action items, open questions |
### ๐งช 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 |
| ๐ญ [Test Automation Engineer](testing/testing-test-automation-engineer.md) | Playwright/Cypress E2E, flake elimination, CI parallelization | Browser test suites, deterministic pipelines, trace-driven failure debugging |
### ๐ Security Division
Defending the stack โ from secure-by-design architecture to breach response.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ก๏ธ [Security Architect](security/security-architect.md) | Threat modeling, secure-by-design, trust boundaries | System security models, architecture reviews, defense-in-depth |
| ๐ [Application Security Engineer](security/security-appsec-engineer.md) | SDLC security, SAST/DAST, secure code review | Securing the dev lifecycle, code-level vulnerabilities |
| ๐ก๏ธ [Penetration Tester](security/security-penetration-tester.md) | Authorized pentests, red team ops, exploitation | Finding exploitable weaknesses before attackers do |
| โ๏ธ [Cloud Security Architect](security/security-cloud-security-architect.md) | Zero trust, cloud-native defense-in-depth | Securing cloud infrastructure and architectures |
| ๐จ [Incident Responder](security/security-incident-responder.md) | DFIR, breach investigation, threat containment | Active breaches, forensics, crisis response |
| ๐ [Threat Intelligence Analyst](security/security-threat-intelligence-analyst.md) | Adversary tracking, campaign mapping, ATT&CK | Understanding who's attacking and how |
| ๐ฏ [Threat Detection Engineer](security/security-threat-detection-engineer.md) | SIEM rules, threat hunting, ATT&CK mapping | Building detection layers and threat hunting |
| ๐ก๏ธ [Senior SecOps Engineer](security/security-senior-secops.md) | Secrets scanning, secure-by-default submissions | Defensive code-level security on every change |
| ๐ [Compliance Auditor](security/security-compliance-auditor.md) | SOC 2, ISO 27001, HIPAA, PCI-DSS | Guiding organizations through compliance certification |
| ๐ก๏ธ [Blockchain Security Auditor](security/security-blockchain-security-auditor.md) | Smart contract audits, exploit analysis | Finding vulnerabilities in contracts before deployment |
| ๐ [AI-Generated Code Security Auditor](security/security-ai-generated-code-auditor.md) | Security review of AI/vibe-coded apps | Hardcoded secrets, broken RLS, prompt-injection sinks |
| ๐ [Secrets & Credential Hygiene Engineer](security/security-secrets-credential-engineer.md) | Secrets & credential lifecycle | Detection, vaulting, rotation, leak response |
### ๐ 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 |
| ๐ [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 |
| ๐ [Identity Graph Operator](specialized/identity-graph-operator.md) | Shared identity resolution for multi-agent systems | Entity deduplication, merge proposals, cross-agent identity consistency |
| ๐ธ [Accounts Payable Agent](specialized/accounts-payable-agent.md) | Payment processing, vendor management, audit | Autonomous payment execution across crypto, fiat, stablecoins |
| ๐ [Cultural Intelligence Strategist](specialized/specialized-cultural-intelligence-strategist.md) | Global UX, representation, cultural exclusion | Ensuring software resonates across cultures |
| ๐ฃ๏ธ [Developer Advocate](specialized/specialized-developer-advocate.md) | Community building, DX, developer content | Bridging product and developer community |
| ๐ฌ [Model QA Specialist](specialized/specialized-model-qa.md) | ML audits, feature analysis, interpretability | End-to-end QA for machine learning models |
| ๐๏ธ [ZK Steward](specialized/zk-steward.md) | Knowledge management, Zettelkasten, notes | Building connected, validated knowledge bases |
| ๐ [MCP Builder](specialized/specialized-mcp-builder.md) | Model Context Protocol servers, AI agent tooling | Building MCP servers that extend AI agent capabilities |
| ๐ [Document Generator](specialized/specialized-document-generator.md) | PDF, PPTX, DOCX, XLSX generation from code | Professional document creation, reports, data visualization |
| โ๏ธ [Automation Governance Architect](specialized/automation-governance-architect.md) | Automation governance, n8n, workflow auditing | Evaluating and governing business automations at scale |
| ๐ [Corporate Training Designer](specialized/corporate-training-designer.md) | Enterprise training, curriculum development | Designing training systems and learning programs |
| ๐ฑ [Personal Growth Mentor](specialized/personal-growth-mentor.md) | Goal clarity, habit systems, accountability, life strategy | Cross-domain personal development without motivational fluff |
| ๐๏ธ [Government Digital Presales Consultant](specialized/government-digital-presales-consultant.md) | China ToG presales, digital transformation | Government digital transformation proposals and bids |
| โ๏ธ [Healthcare Marketing Compliance](specialized/healthcare-marketing-compliance.md) | China healthcare advertising compliance | Healthcare marketing regulatory compliance |
| ๐ฏ [Recruitment Specialist](specialized/recruitment-specialist.md) | Talent acquisition, recruiting operations | Recruitment strategy, sourcing, and hiring processes |
| ๐ [Study Abroad Advisor](specialized/study-abroad-advisor.md) | International education, application planning | Study abroad planning across US, UK, Canada, Australia |
| ๐ [Supply Chain Strategist](specialized/supply-chain-strategist.md) | Supply chain management, procurement strategy | Supply chain optimization and procurement planning |
| ๐บ๏ธ [Workflow Architect](specialized/specialized-workflow-architect.md) | Workflow discovery, mapping, and specification | Mapping every path through a system before code is written |
| โ๏ธ [Salesforce Architect](specialized/specialized-salesforce-architect.md) | Multi-cloud Salesforce design, governor limits, integrations | Enterprise Salesforce architecture, org strategy, deployment pipelines |
| ๐ซ๐ท [French Consulting Market Navigator](specialized/specialized-french-consulting-market.md) | ESN/SI ecosystem, portage salarial, rate positioning | Freelance consulting in the French IT market |
| ๐ฐ๐ท [Korean Business Navigator](specialized/specialized-korean-business-navigator.md) | Korean business culture, ํ์ process, relationship mechanics | Foreign professionals navigating Korean business relationships |
| ๐๏ธ [Civil Engineer](specialized/specialized-civil-engineer.md) | Structural analysis, geotechnical design, global building codes | Multi-standard structural engineering across Eurocode, ACI, AISC, and more |
| ๐ง [Customer Service](specialized/customer-service.md) | Omnichannel support, complaint handling, retention, escalation | Any industry customer support โ retail, SaaS, hospitality, finance, logistics |
| ๐ฅ [Healthcare Customer Service](specialized/healthcare-customer-service.md) | HIPAA-aware patient support, billing, insurance, emergency routing | Healthcare organizations needing compliant, empathetic patient support |
| ๐จ [Hospitality Guest Services](specialized/hospitality-guest-services.md) | Reservations, concierge, complaint recovery, loyalty, events | Hotels, resorts, restaurants, and event venues |
| ๐ค [HR Onboarding](specialized/hr-onboarding.md) | Pre-boarding, compliance, benefits enrollment, 30-60-90 day plans | Any company onboarding new hires โ from startups to enterprise |
| ๐ [Language Translator](specialized/language-translator.md) | Spanish โ English translation, dialect awareness, cultural context | Travel, business, medical, and legal translation needs |
| โฑ๏ธ [Legal Billing & Time Tracking](specialized/legal-billing-time-tracking.md) | Time capture, billing narratives, IOLTA compliance, collections | Law firms maximizing revenue recovery and billing accuracy |
| ๐ [Legal Client Intake](specialized/legal-client-intake.md) | Prospect qualification, conflict screening, consultation scheduling | Law firms converting inquiries into retained clients |
| โ๏ธ [Legal Document Review](specialized/legal-document-review.md) | Contract review, risk flagging, version comparison, compliance | Attorney-ready first-pass review across any practice area |
| ๐ฆ [Loan Officer Assistant](specialized/loan-officer-assistant.md) | Borrower intake, TRID compliance, pipeline tracking, closing coordination | Mortgage and consumer lending teams |
| ๐ [Real Estate Buyer & Seller](specialized/real-estate-buyer-seller.md) | Buyer/seller representation, offers, transaction coordination | Residential and investment real estate transactions |
| ๐ [Retail Customer Returns](specialized/retail-customer-returns.md) | Return processing, fraud prevention, exchanges, vendor returns | Brick-and-mortar, e-commerce, and omnichannel retail |
| โ๏ธ [Business Strategist](specialized/business-strategist.md) | Management-consulting strategy | Competitive analysis, market entry, growth planning |
| ๐ [Change Management Consultant](specialized/change-management-consultant.md) | ADKAR/Kotter/Prosci change | Guiding orgs through transformation & adoption |
| ๐งญ [Chief of Staff](specialized/specialized-chief-of-staff.md) | Executive coordination | Filtering noise, owning processes, routing decisions |
| ๐ [Customer Success Manager](specialized/customer-success-manager.md) | Onboarding, health & retention | QBRs, churn prevention, renewals & expansion |
| ๐ [Grant Writer](specialized/grant-writer.md) | Grant proposals & funding | LOIs, proposals, budgets for nonprofits/research |
| ๐ฅ [Medical Billing & Coding Specialist](specialized/medical-billing-coding-specialist.md) | ICD-10/CPT/HCPCS & revenue cycle | Claims, denial management, RCM optimization |
| ๐ฐ [Pricing Analyst](specialized/specialized-pricing-analyst.md) | Pricing models & margin optimization | Competitor/cost analysis, value-based pricing |
| ๐ผ [Chief Financial Officer](specialized/chief-financial-officer.md) | Capital allocation & financial strategy | Treasury, FP&A, M&A finance, investor & board reporting |
| ๐ฑ [ESG & Sustainability Officer](specialized/esg-sustainability-officer.md) | ESG programs & disclosure | Sustainability strategy, decarbonization, reporting |
| ๐ [Data Privacy Officer](specialized/data-privacy-officer.md) | GDPR/CCPA privacy compliance | Data mapping, DPIAs, consent, breach response |
| โ๏ธ [Operations Manager](specialized/operations-manager.md) | Lean/Six Sigma operations | Process mapping, capacity planning, KPI governance |
| ๐ค [M&A Integration Manager](specialized/ma-integration-manager.md) | Post-merger integration | Day 1/100-day plans, synergy tracking, TSA management |
| ๐ง [Organizational Psychologist](specialized/organizational-psychologist.md) | Team dynamics & culture health | Psychological safety, burnout risk, high-performing teams |
| โ๏ธ [Strategy Duel Agent](specialized/specialized-strategy-duel-agent.md) | Game theory & the 36 stratagems | Turn-based strategy duels, adversarial scenario simulation |
| ๐ก๏ธ [FedRAMP & RMF Compliance Engineer](specialized/specialized-fedramp-rmf-compliance.md) | Federal cloud authorization (ATO) | NIST 800-53, FedRAMP Rev5/20x, SSP/POA&M, ConMon, OSCAL |
| ๐บ [Codebase Archaeologist](specialized/specialized-codebase-archaeologist.md) | Multi-tool codebase drift audits | Detecting silent drift across Claude/Cursor/Copilot/Windsurf edits |
| ๐งพ [Resume Tailor](specialized/resume-tailor.md) | Candidate-side resume optimization | JD mapping, ATS keyword alignment, experience-to-requirement matching |
| ๐งก [Aging Parent Care Companion](specialized/healthcare-aging-parent-care-companion.md) | Family caregiver decision-support | Appointment/medication coordination, care-team comms, caregiver wellbeing (HIPAA-aligned) |
| ๐๏ธ [Master Plan Architect](specialized/specialized-master-plan-architect.md) | Architectural teaching, red-team plan critique | Deep architecture teaching, risk critique, comprehensive Markdown implementation plans (no code execution) |
| ๐ง [Focus Music Architect](specialized/specialized-focus-music-architect.md) | Instrumental focus-music prompt engineering, neuroacoustics | Soundscape architecture, BPM curves, binaural layers for generative audio models |
### ๐ต Finance Division
Accounting, financial analysis, tax strategy, and investment research specialists.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ [Bookkeeper & Controller](finance/finance-bookkeeper-controller.md) | Month-end close, reconciliation, GAAP compliance, internal controls | Day-to-day accounting operations, audit readiness, financial record-keeping |
| ๐ [Financial Analyst](finance/finance-financial-analyst.md) | Financial modeling, forecasting, scenario analysis, decision support | Three-statement models, variance analysis, data-driven business intelligence |
| ๐ [FP&A Analyst](finance/finance-fpa-analyst.md) | Budgeting, rolling forecasts, variance analysis, business reviews | Annual operating plans, monthly business reviews, strategic resource allocation |
| ๐ [Investment Researcher](finance/finance-investment-researcher.md) | Due diligence, portfolio analysis, asset valuation, equity research | Investment thesis development, risk assessment, market research |
| ๐๏ธ [Tax Strategist](finance/finance-tax-strategist.md) | Tax optimization, multi-jurisdictional compliance, transfer pricing | Entity structuring, ETR analysis, audit defense, strategic tax planning |
### ๐ฎ Game Development Division
Building worlds, systems, and experiences across every major engine.
#### Cross-Engine Agents (Engine-Agnostic)
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฏ [Game Designer](game-development/game-designer.md) | Systems design, GDD authorship, economy balancing, gameplay loops | Designing game mechanics, progression systems, writing design documents |
| ๐บ๏ธ [Level Designer](game-development/level-designer.md) | Layout theory, pacing, encounter design, environmental storytelling | Building levels, designing encounter flow, spatial narrative |
| ๐จ [Technical Artist](game-development/technical-artist.md) | Shaders, VFX, LOD pipeline, art-to-engine optimization | Bridging art and engineering, shader authoring, performance-safe asset pipelines |
| ๐ [Game Audio Engineer](game-development/game-audio-engineer.md) | FMOD/Wwise, adaptive music, spatial audio, audio budgets | Interactive audio systems, dynamic music, audio performance |
| ๐ [Narrative Designer](game-development/narrative-designer.md) | Story systems, branching dialogue, lore architecture | Writing branching narratives, implementing dialogue systems, world lore |
| ๐ฐ [Economy Designer](game-development/economy-designer.md) | Virtual currencies, sources/sinks, monetization modeling, inflation control | Designing in-game economies, balancing F2P monetization, live economy tuning |
#### Unity
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐๏ธ [Unity Architect](game-development/unity/unity-architect.md) | ScriptableObjects, data-driven modularity, DOTS/ECS | Large-scale Unity projects, data-driven system design, ECS performance work |
| โจ [Unity Shader Graph Artist](game-development/unity/unity-shader-graph-artist.md) | Shader Graph, HLSL, URP/HDRP, Renderer Features | Custom Unity materials, VFX shaders, post-processing passes |
| ๐ [Unity Multiplayer Engineer](game-development/unity/unity-multiplayer-engineer.md) | Netcode for GameObjects, Unity Relay/Lobby, server authority, prediction | Online Unity games, client prediction, Unity Gaming Services integration |
| ๐ ๏ธ [Unity Editor Tool Developer](game-development/unity/unity-editor-tool-developer.md) | EditorWindows, AssetPostprocessors, PropertyDrawers, build validation | Custom Unity Editor tooling, pipeline automation, content validation |
#### Unreal Engine
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| โ๏ธ [Unreal Systems Engineer](game-development/unreal-engine/unreal-systems-engineer.md) | C++/Blueprint hybrid, GAS, Nanite constraints, memory management | Complex Unreal gameplay systems, Gameplay Ability System, engine-level C++ |
| ๐จ [Unreal Technical Artist](game-development/unreal-engine/unreal-technical-artist.md) | Material Editor, Niagara, PCG, Substrate | Unreal materials, Niagara VFX, procedural content generation |
| ๐ [Unreal Multiplayer Architect](game-development/unreal-engine/unreal-multiplayer-architect.md) | Actor replication, GameMode/GameState hierarchy, dedicated server | Unreal online games, replication graphs, server authoritative Unreal |
| ๐บ๏ธ [Unreal World Builder](game-development/unreal-engine/unreal-world-builder.md) | World Partition, Landscape, HLOD, LWC | Large open-world Unreal levels, streaming systems, terrain at scale |
#### Godot
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ [Godot Gameplay Scripter](game-development/godot/godot-gameplay-scripter.md) | GDScript 2.0, signals, composition, static typing | Godot gameplay systems, scene composition, performance-conscious GDScript |
| ๐ [Godot Multiplayer Engineer](game-development/godot/godot-multiplayer-engineer.md) | MultiplayerAPI, ENet/WebRTC, RPCs, authority model | Online Godot games, scene replication, server-authoritative Godot |
| โจ [Godot Shader Developer](game-development/godot/godot-shader-developer.md) | Godot shading language, VisualShader, RenderingDevice | Custom Godot materials, 2D/3D effects, post-processing, compute shaders |
#### Blender
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐งฉ [Blender Addon Engineer](game-development/blender/blender-addon-engineer.md) | Blender Python (`bpy`), custom operators/panels, asset validators, exporters, pipeline automation | Building Blender add-ons, asset prep tools, export workflows, and DCC pipeline automation |
#### Roblox Studio
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| โ๏ธ [Roblox Systems Scripter](game-development/roblox-studio/roblox-systems-scripter.md) | Luau, RemoteEvents/Functions, DataStore, server-authoritative module architecture | Building secure Roblox game systems, client-server communication, data persistence |
| ๐ฏ [Roblox Experience Designer](game-development/roblox-studio/roblox-experience-designer.md) | Engagement loops, monetization, D1/D7 retention, onboarding flow | Designing Roblox game loops, Game Passes, daily rewards, player retention |
| ๐ [Roblox Avatar Creator](game-development/roblox-studio/roblox-avatar-creator.md) | UGC pipeline, accessory rigging, Creator Marketplace submission | Roblox UGC items, HumanoidDescription customization, in-experience avatar shops |
### ๐ Academic Division
Scholarly rigor for world-building, storytelling, and narrative design.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ [Anthropologist](academic/academic-anthropologist.md) | Cultural systems, kinship, rituals, belief systems | Designing culturally coherent societies with internal logic |
| ๐ [Geographer](academic/academic-geographer.md) | Physical/human geography, climate, cartography | Building geographically coherent worlds with realistic terrain and settlements |
| ๐ [Historian](academic/academic-historian.md) | Historical analysis, periodization, material culture | Validating historical coherence, enriching settings with authentic period detail |
| ๐ [Narratologist](academic/academic-narratologist.md) | Narrative theory, story structure, character arcs | Analyzing and improving story structure with established theoretical frameworks |
| ๐ง [Psychologist](academic/academic-psychologist.md) | Personality theory, motivation, cognitive patterns | Building psychologically credible characters grounded in research |
| ๐ [Statistician](academic/academic-statistician.md) | Statistical inference & experiment design | Hypothesis testing, causal inference, sampling, rigorous analysis |
---
### ๐ GIS Division
Mapping the Earth, analyzing the built world, and extracting intelligence from geospatial data.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ง [Technical Consultant](gis/gis-technical-consultant.md) | GIS strategy, gap analysis, technology roadmaps, digital transformation | Understanding business needs, selecting the right geospatial stack, planning multi-phase GIS programs |
| ๐ง [Solution Engineer](gis/gis-solution-engineer.md) | Esri + FOSS4G prototype building, PoC delivery, technical feasibility | Building working demos, validating technical approaches, pre-sales support |
| ๐ฅ๏ธ [GIS Analyst](gis/gis-analyst.md) | Map production, data QC, symbology, layouts, spatial queries | Day-to-day GIS operations, creating publication-ready maps, maintaining data integrity |
| ๐ฆ [Spatial Data Engineer](gis/gis-spatial-data-engineer.md) | Geospatial ETL, format conversion, CRS reprojection, automated pipelines | Ingesting messy data from any source, building repeatable data transformation pipelines |
| โ๏ธ [Geoprocessing Specialist](gis/gis-geoprocessing-specialist.md) | ArcPy, Python Toolbox (.pyt), Model Builder, batch automation | Automating repetitive GIS workflows, building custom geoprocessing tools |
| โ
[GIS QA Engineer](gis/gis-qa-engineer.md) | Topology validation, metadata audit, CRS consistency, accuracy assessment | Quality gates before data publication, compliance verification, data integrity audits |
| ๐ค [GeoAI/ML Engineer](gis/gis-geoai-ml-engineer.md) | Feature extraction, object detection, semantic segmentation, land cover classification | Extracting buildings/roads/vehicles from imagery, change detection, environmental monitoring |
| ๐๏ธ [BIM/GIS Specialist](gis/gis-bim-specialist.md) | Revit/IFC to GIS, indoor mapping, digital twin architecture, facility management | Smart campus, airport digital twins, indoor navigation, building operations |
| ๐๏ธ [3D & Scene Developer](gis/gis-3d-scene-developer.md) | Cesium, ArcGIS Scene Viewer, 3D Tiles, point clouds, terrain visualization | 3D city scenes, terrain flyovers, point cloud web viewers, OAuth-gated scene sharing |
| ๐ [Spatial Data Scientist](gis/gis-spatial-data-scientist.md) | Spatial statistics, clustering, regression, interpolation, point pattern analysis | Hotspot detection, spatial modeling, predictive analytics, research-grade analysis |
| ๐ธ [Drone/Reality Mapping](gis/gis-drone-reality-mapping.md) | Photogrammetry, orthomosaic, DTM/DSM, point cloud classification, 3D mesh | Drone survey processing, reality capture, construction monitoring, environmental mapping |
| ๐ [Web GIS Developer](gis/gis-web-gis-developer.md) | MapLibre GL JS, ArcGIS JS API, Leaflet, real-time dashboards, REST APIs | Building interactive web maps, operational dashboards, real-time data visualization |
| ๐จ [Cartography Designer](gis/gis-cartography-designer.md) | Color theory, typography, basemap design, visual hierarchy, print and web aesthetics | Making maps beautiful and readable, colorblind-safe palettes, professional map layouts |
---
### ๐ฅ Healthcare Division
Building AI agents for regulated clinical and sovereign health contexts.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ฉบ [Clinical Evidence Agent](healthcare/healthcare-clinical-evidence-agent.md) | Evidence standards, validated vs unvalidated claims, diagnostic authority boundaries | Making clinical claims credibly without overstepping into diagnostic authority |
| ๐ [Sovereign Health Systems Agent](healthcare/healthcare-sovereign-health-systems-agent.md) | Government health mandates, UHC policy, emerging market deployment | Health tech teams operating at the intersection of national health infrastructure and sovereign health policy |
| ๐งญ [Healthcare Innovation Strategist](healthcare/healthcare-innovation-strategist.md) | Narrative architecture for healthcare founders across investor, regulatory, sovereign, and clinical audiences | Healthcare founders who need to translate clinical and financial complexity into language that moves capital and builds trust |
---
### ๐ Research Division
Finding, evaluating, and synthesizing existing evidence rather than generating new primary data.
| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ๐ [Research Synthesist](research/research-synthesist.md) | Literature review, source evaluation, citation tracing, evidence synthesis | Turning a scattered pile of sources into a structured, honestly-weighted map of what the evidence supports |
---
## ๐ฏ 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: Paid Media Account Takeover
**Your Team**:
1. ๐ **Paid Media Auditor** - Comprehensive account assessment
2. ๐ก **Tracking & Measurement Specialist** - Verify conversion tracking accuracy
3. ๐ฐ **PPC Campaign Strategist** - Redesign account architecture
4. ๐ **Search Query Analyst** - Clean up wasted spend from search terms
5. โ๏ธ **Ad Creative Strategist** - Refresh all ad copy and extensions
6. ๐ **Analytics Reporter** (Support Division) - Build reporting dashboards
**Result**: Systematic account takeover with tracking verified, waste eliminated, structure optimized, and creative refreshed โ all within the first 30 days.
---
### Scenario 5: 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/).
---
### Scenario 6: Smart Campus Digital Twin
**Your Team**:
1. ๐ง **Technical Consultant** - Define the digital twin strategy: BIM for buildings, GIS for campus, IoT for real-time
2. ๐๏ธ **BIM/GIS Specialist** - Convert Revit building models to GIS scene layers, design indoor floor plans
3. ๐ธ **Drone/Reality Mapping** - Fly the campus, generate orthomosaic and 3D mesh for context
4. ๐ **Web GIS Developer** - Build the campus dashboard with MapLibre, building layer, and room finder
5. ๐๏ธ **3D & Scene Developer** - Create immersive 3D scene with terrain, buildings, and flyover tour
6. ๐ค **GeoAI/ML Engineer** - Extract building footprints and tree canopy from drone imagery
7. โ
**GIS QA Engineer** - Validate data accuracy, check topology, verify CRS consistency
**Result**: A campus digital twin that combines BIM detail, drone reality capture, 3D visualization, and web accessibility โ delivered by coordinated specialists in a single pipeline.
---
## ๐ค 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
- ๐ญ **230+ Specialized Agents** across every division
- ๐ **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/`
- **[GitHub Copilot](https://github.com/copilot)** โ native `.md` agents, no conversion needed โ `~/.github/agents/` + `~/.copilot/agents/`
- **[Antigravity](https://github.com/google-gemini/antigravity)** โ `SKILL.md` per agent โ `~/.gemini/config/skills/`
- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** -- `.md` agent files -> `~/.gemini/agents/`
- **[OpenCode](https://opencode.ai)** โ `.md` agent files โ `.opencode/agents/`
- **[Cursor](https://cursor.sh)** โ `.mdc` rule files โ `.cursor/rules/`
- **[Aider](https://aider.chat)** โ `CONVENTIONS.md` roster index โ `./CONVENTIONS.md`
- **[Windsurf](https://codeium.com/windsurf)** โ single `.windsurfrules` โ `./.windsurfrules`
- **[OpenClaw](https://github.com/openclaw/openclaw)** โ `SOUL.md` + `AGENTS.md` + `IDENTITY.md` per agent
- **[Qwen Code](https://github.com/QwenLM/qwen-code)** โ `.md` SubAgent files โ `~/.qwen/agents/`
- **[Kimi Code](https://github.com/MoonshotAI/kimi-cli)** โ YAML agent specs โ `~/.config/kimi/agents/`
- **[Codex](https://developers.openai.com/codex/overview)** โ TOML custom agents โ `~/.codex/agents/`
- **Osaurus** -- `SKILL.md` skills -> `~/.osaurus/skills/`
- **[Hermes](integrations/hermes/README.md)** -- lazy-router plugin -> `~/.hermes/plugins/`
- **[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)** โ `SKILL.md` skills โ `~/.dsh/skills/` (user) or `.dsh/skills/` (project)
---
### โก Quick Install
**Step 1 -- Generate integration files:**
```bash
./scripts/convert.sh
# Faster (parallel, output order may vary): ./scripts/convert.sh --parallel
```
**Step 2 -- Install (interactive, auto-detects your tools):**
```bash
./scripts/install.sh
# Faster (parallel, output order may vary): ./scripts/install.sh --no-interactive --parallel
```
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) [*] Copilot (~/.github + ~/.copilot)
[x] 3) [*] Antigravity (~/.gemini/antigravity)
[ ] 4) [ ] Gemini CLI (~/.gemini/agents)
[ ] 5) [ ] OpenCode (opencode.ai)
[ ] 6) [ ] OpenClaw (~/.openclaw/agency-agents)
[x] 7) [*] Cursor (.cursor/rules)
[ ] 8) [ ] Aider (CONVENTIONS.md)
[ ] 9) [ ] Windsurf (.windsurfrules)
[ ] 10) [ ] Qwen Code (~/.qwen/agents)
[ ] 11) [ ] Kimi Code (~/.config/kimi/agents)
[ ] 12) [ ] Codex (~/.codex/agents)
[ ] 13) [ ] Osaurus (~/.osaurus/skills)
[ ] 14) [ ] Hermes (~/.hermes/plugins)
[1-14] 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 openclaw
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes
```
**Non-interactive (CI/scripts):**
```bash
./scripts/install.sh --no-interactive --tool all
```
**Faster runs (parallel)** โ On multi-core machines, use `--parallel` so each tool is processed in parallel. Output order across tools is non-deterministic. Works with both interactive and non-interactive install: e.g. `./scripts/install.sh --interactive --parallel` (pick tools, then install in parallel) or `./scripts/install.sh --no-interactive --parallel`. Job count defaults to `nproc` (Linux), `sysctl -n hw.ncpu` (macOS), or 4; override with `--jobs N`.
```bash
./scripts/convert.sh --parallel # convert all tools in parallel
./scripts/convert.sh --parallel --jobs 8 # cap parallel jobs
./scripts/install.sh --no-interactive --parallel # install all detected tools in parallel
./scripts/install.sh --interactive --parallel # pick tools, then install in parallel
./scripts/install.sh --no-interactive --parallel --jobs 4
```
---
### 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.
GitHub Copilot
Agents are copied directly from the repo into `~/.github/agents/` and `~/.copilot/agents/` -- no conversion needed.
```bash
./scripts/install.sh --tool copilot
```
Then activate in GitHub Copilot:
```
Use the Frontend Developer agent to review this component.
```
See [integrations/github-copilot/README.md](integrations/github-copilot/README.md) for details.
Antigravity (Gemini)
Each agent becomes a skill in `~/.gemini/config/skills/agency-/`.
```bash
./scripts/install.sh --tool antigravity
```
Activate in Gemini with Antigravity:
```
@agency-frontend-developer review this React component
```
See [integrations/antigravity/README.md](integrations/antigravity/README.md) for details.
Gemini CLI
Installs as Gemini CLI subagents.
On a fresh clone, generate the Gemini agent files before running the installer.
```bash
./scripts/convert.sh --tool gemini-cli
./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/agents/` 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/agents
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/
```
Activate in OpenCode:
```
@backend-architect 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
`CONVENTIONS.md` is the roster index โ every agent's name, description, and the
path to its full instructions. Aider keeps a conventions file in context for the
whole session, and the full agent bodies together are about a million tokens, so the
file lists the agents rather than inlining them.
```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.
```
When you want an agent's full instructions, read its file in:
```
/read-only /path/to/agency-agents/engineering/engineering-frontend-developer.md
```
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.
OpenClaw
Each agent becomes a workspace with `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` in `~/.openclaw/agency-agents/`.
```bash
./scripts/convert.sh --tool openclaw
./scripts/install.sh --tool openclaw
```
If the `openclaw` CLI is available, the installer registers each workspace automatically.
Run `openclaw gateway restart` after installation so the new agents are activated.
See [integrations/openclaw/README.md](integrations/openclaw/README.md) for details.
Qwen Code
SubAgents are installed to `.qwen/agents/` in your project root (project-scoped).
> Requires Qwen Code 0.25.1 or later. Earlier releases can't launch agents whose code examples contain `${โฆ}` placeholders ([#1081](https://github.com/msitarzewski/agency-agents/issues/1081)).
```bash
# Convert and install (run from your project root)
cd /your/project
./scripts/convert.sh --tool qwen
./scripts/install.sh --tool qwen
```
**Usage in Qwen Code:**
- Reference by name: `Use the frontend-developer agent to review this component`
- Or let Qwen auto-delegate based on task context
- Manage via `/agents` command in interactive mode
> ๐ [Qwen SubAgents Docs](https://qwenlm.github.io/qwen-code-docs/en/users/features/sub-agents/)
Kimi Code
Agents are converted to Kimi Code CLI format (YAML + system prompt) and installed to `~/.config/kimi/agents/`.
```bash
# Convert and install
./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi
```
**Usage with Kimi Code:**
```bash
# Use an agent
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml
# In a project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
--work-dir /your/project \
"Review this React component"
```
See [integrations/kimi/README.md](integrations/kimi/README.md) for details.
Codex
Each agent is converted into a Codex custom agent TOML file and installed to `~/.codex/agents/`.
```bash
./scripts/convert.sh --tool codex
./scripts/install.sh --tool codex
```
Then reference the custom agent by name in Codex:
```
Use the Frontend Developer agent to review this component.
```
See [integrations/codex/README.md](integrations/codex/README.md) for details.
DeepSeek Harness
Each agent becomes a DSH skill (`SKILL.md` with Agent-Skills frontmatter) in `${DSH_HOME:-$HOME/.dsh}/skills/agency-/`. Skills are discovered live โ no restart needed.
```bash
./scripts/convert.sh --tool dsh
./scripts/install.sh --tool dsh
```
Custom user home:
```bash
DSH_HOME=~/.config/dsh ./scripts/install.sh --tool dsh
```
Project-scoped install (run from your project root):
```bash
DSH_SKILLS_DIR=.dsh/skills ./scripts/install.sh --tool dsh
```
Activate in DeepSeek Harness โ user- and model-invocable by default:
```
/agency-frontend-developer review this React component
```
See [integrations/dsh/README.md](integrations/dsh/README.md) for details.
---
### Regenerating After Changes
When you add new agents or edit existing ones, regenerate all integration files:
```bash
./scripts/convert.sh # regenerate all (serial)
./scripts/convert.sh --parallel # regenerate all in parallel (faster)
./scripts/convert.sh --tool codex # regenerate just one tool
./scripts/convert.sh --tool cursor # regenerate just one tool
```
---
## ๐บ๏ธ Roadmap
- [ ] Interactive agent selector web tool
- [x] Multi-agent workflow examples -- see [examples/](examples/)
- [x] Multi-tool integration scripts (Claude Code, GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Qwen Code, Kimi Code, Codex, Osaurus, Hermes)
- [ ] Video tutorials on agent design
- [ ] Community agent marketplace
- [ ] Agent "personality quiz" for project matching
- [ ] "Agent of the Week" showcase series
---
## ๐ Community Translations & Localizations
Community-maintained translations and regional adaptations. These are independently maintained -- see each repo for coverage and version compatibility.
| Language | Maintainer | Link | Notes |
|----------|-----------|------|-------|
| ๐จ๐ณ ็ฎไฝไธญๆ (zh-CN) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | 141 translated agents + 46 China-market originals |
| ๐จ๐ณ ็ฎไฝไธญๆ (zh-CN) | [@dsclca12](https://github.com/dsclca12) | [agent-teams](https://github.com/dsclca12/agent-teams) | Independent translation with Bilibili, WeChat, Xiaohongshu localization |
| ๐ง๐ท Portuguรชs brasileiro (pt-BR) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-pt-BR](https://github.com/jnMetaCode/agency-agents-pt-BR) | 184 upstream agents translated; Brazil-market PRs welcome |
| ๐ท๐บ ะ ัััะบะธะน (ru) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-ru](https://github.com/jnMetaCode/agency-agents-ru) | 184 upstream agents translated; Russia-market PRs welcome |
| ๐ฎ๐ฉ Bahasa Indonesia (id) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-id](https://github.com/jnMetaCode/agency-agents-id) | 184 upstream agents translated; Indonesia-market PRs welcome |
| ๐ธ๐ฆ ุงูุนุฑุจูุฉ (ar) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-ar](https://github.com/jnMetaCode/agency-agents-ar) | 184 upstream agents translated; Arabic-market PRs welcome |
| ๐ฐ๐ท ํ๊ตญ์ด (ko) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-ko](https://github.com/jnMetaCode/agency-agents-ko) | 184 upstream agents fully translated; Korea-specific PRs welcome |
| ๐ฏ๐ต ๆฅๆฌ่ช (ja-JP) | [@sscodeai](https://github.com/sscodeai) | [agency-agents-ja](https://github.com/sscodeai/agency-agents-ja) | 281 Japan-localized agents + 97 Japan-market originals + 27 workflows |
| ๐ป๐ณ Tiแบฟng Viแปt (vi-VN) | [@rodonguyen](https://github.com/rodonguyen) | [agency-agents](https://github.com/rodonguyen/agency-agents) | Starter Vietnamese localization focused on README, quick start, and high-use docs |
Want to add a translation? Open an issue and we'll link it here.
---
## ๐ License
MIT License - Use freely, commercially or personally. Attribution appreciated but not required.
---
## ๐ Acknowledgments
What started as a Reddit thread about AI agent specialization has grown into something remarkable โ **230+ agents across every division**, supported by a community of contributors from around the world. Every agent in this repo exists because someone cared enough to write it, test it, and share it.
To everyone who has opened a PR, filed an issue, started a Discussion, or simply tried an agent and told us what worked โ thank you. You're the reason The Agency keeps getting better.
---
## ๐ฌ Community
- **GitHub Discussions**: [Share your success stories](https://github.com/msitarzewski/agency-agents/discussions)
- **Issues**: [Report bugs or request features](https://github.com/msitarzewski/agency-agents/issues)
- **Reddit**: Join the conversation on r/ClaudeAI
- **Twitter/X**: Share with #TheAgency
---
## ๐ Get Started
1. **Browse** the agents above and find specialists for your needs
2. **Copy** the agents to `~/.claude/agents/` for Claude Code integration
3. **Activate** agents by referencing them in your Claude conversations
4. **Customize** agent personalities and workflows for your specific needs
5. **Share** your results and contribute back to the community
---
**๐ญ The Agency: Your AI Dream Team Awaits ๐ญ**
[โญ Star this repo](https://github.com/msitarzewski/agency-agents) โข [๐ด Fork it](https://github.com/msitarzewski/agency-agents/fork) โข [๐ Report an issue](https://github.com/msitarzewski/agency-agents/issues) โข [โค๏ธ Sponsor](https://github.com/sponsors/msitarzewski)
Made with โค๏ธ by the community, for the community
---
### Overview (`examples/README.md`)
# Examples
This directory contains example outputs demonstrating how the agency's agents can be orchestrated together to tackle real-world tasks.
## Why This Exists
The agency-agents repo defines dozens of specialized agents across engineering, design, marketing, product, support, spatial computing, and project management. But agent definitions alone don't show what happens when you **deploy them all at once** on a single mission.
These examples answer the question: *"What does it actually look like when the full agency collaborates?"*
## Contents
### [nexus-spatial-discovery.md](./nexus-spatial-discovery.md)
**What:** A complete product discovery exercise where 8 agents worked in parallel to evaluate a software opportunity and produce a unified plan.
**The scenario:** Web research identified an opportunity at the intersection of AI agent orchestration and spatial computing. The entire agency was then deployed simultaneously to produce:
- Market validation and competitive analysis
- Technical architecture (8-service system design with full SQL schema)
- Brand strategy and visual identity
- Go-to-market and growth plan
- Customer support operations blueprint
- UX research plan with personas and journey maps
- 35-week project execution plan with 65 sprint tickets
- Spatial interface architecture specification
**Agents used:**
| Agent | Role |
|-------|------|
| Product Trend Researcher | Market validation, competitive landscape |
| Backend Architect | System architecture, data model, API design |
| Brand Guardian | Positioning, visual identity, naming |
| Growth Hacker | GTM strategy, pricing, launch plan |
| Support Responder | Support tiers, onboarding, community |
| UX Researcher | Personas, journey maps, design principles |
| Project Shepherd | Phase plan, sprints, risk register |
| XR Interface Architect | Spatial UI specification |
**Key takeaway:** All 8 agents ran in parallel and produced coherent, cross-referencing plans without coordination overhead. The output demonstrates the agency's ability to go from "find an opportunity" to "here's the full blueprint" in a single session.
## Adding New Examples
If you run an interesting multi-agent exercise, consider adding it here. Good examples show:
- Multiple agents collaborating on a shared objective
- The breadth of the agency's capabilities
- Real-world applicability of the agent definitions
---
### Overview (`integrations/README.md`)
# ๐ Integrations
This directory contains The Agency integrations and converted formats for
supported agentic coding tools.
## Supported Tools
- **[Claude Code](#claude-code)** โ `.md` agents, use the repo directly
- **[GitHub Copilot](#github-copilot)** โ `.md` agents, use the repo directly
- **[Antigravity](#antigravity)** โ `SKILL.md` per agent in `antigravity/`
- **[Gemini CLI](#gemini-cli)** โ `.md` agent files in `gemini-cli/agents/`
- **[OpenCode](#opencode)** โ `.md` agent files in `opencode/`
- **[OpenClaw](#openclaw)** โ `SOUL.md` + `AGENTS.md` + `IDENTITY.md` workspaces
- **[Cursor](#cursor)** โ `.mdc` rule files in `cursor/`
- **[Aider](#aider)** โ `CONVENTIONS.md` roster index in `aider/`
- **[Windsurf](#windsurf)** โ `.windsurfrules` in `windsurf/`
- **[Kimi Code](#kimi-code)** โ YAML agent specs in `kimi/`
- **[Qwen Code](#qwen-code)** โ project-scoped `.md` SubAgents in `.qwen/agents/`
- **[Codex](#codex)** โ `.toml` custom agents in `codex/`
- **[Mistral Vibe](vibe/README.md)** โ `.toml` agents + prompt files generated in `vibe/`
- **Osaurus** -- `SKILL.md` skills generated in `osaurus/`
- **[Hermes](hermes/README.md)** -- lazy-router plugin generated in `hermes/`
## Quick Install
```bash
# Install for all detected tools automatically
./scripts/install.sh
# Install a specific home-scoped tool
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool claude-code
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes
# Gemini CLI needs generated integration files on a fresh clone
./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli
# Qwen Code also needs generated SubAgent files on a fresh clone
./scripts/convert.sh --tool qwen
./scripts/install.sh --tool qwen
```
If you install OpenClaw and the gateway is already running, restart it after installation:
```bash
openclaw gateway restart
```
For project-scoped tools such as OpenCode, Cursor, Aider, Windsurf, and Qwen
Code, run
the installer from your target project root as shown in the tool-specific
sections below.
## Regenerating Integration Files
If you add or modify agents, regenerate all integration files:
```bash
./scripts/convert.sh
```
---
## Claude Code
The Agency was originally designed for Claude Code. Agents work natively
without conversion.
```bash
cp -r /*.md ~/.claude/agents/
# or install everything at once:
./scripts/install.sh --tool claude-code
```
See [claude-code/README.md](claude-code/README.md) for details.
---
## GitHub Copilot
The Agency also works natively with GitHub Copilot. Agents can be copied
directly into `~/.github/agents/` and `~/.copilot/agents/` without conversion.
```bash
./scripts/install.sh --tool copilot
```
See [github-copilot/README.md](github-copilot/README.md) for details.
---
## Antigravity
Skills are installed to `~/.gemini/config/skills/`. Each agent becomes
a separate skill prefixed with `agency-` to avoid naming conflicts.
```bash
./scripts/install.sh --tool antigravity
```
See [antigravity/README.md](antigravity/README.md) for details.
---
## Gemini CLI
Agents are packaged as Gemini CLI subagents.
Subagents are installed to `~/.gemini/agents/`.
Because the agent files are generated artifacts, run
`./scripts/convert.sh --tool gemini-cli` before installing from a fresh clone.
```bash
./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli
```
See [gemini-cli/README.md](gemini-cli/README.md) for details.
---
## OpenCode
Each agent becomes a project-scoped `.md` file in `.opencode/agents/`.
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool opencode
```
See [opencode/README.md](opencode/README.md) for details.
---
## OpenClaw
Each agent becomes an OpenClaw workspace containing `SOUL.md`, `AGENTS.md`,
and `IDENTITY.md`.
Before installing, generate the OpenClaw workspaces:
```bash
./scripts/convert.sh --tool openclaw
```
Then install them:
```bash
./scripts/install.sh --tool openclaw
```
See [openclaw/README.md](openclaw/README.md) for details.
---
## Cursor
Each agent becomes a `.mdc` rule file. Rules are project-scoped โ run the
installer from your project root.
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool cursor
```
See [cursor/README.md](cursor/README.md) for details.
---
## Aider
`CONVENTIONS.md` is the roster index โ name, description, and the path to each
agent's full instructions. Aider keeps a conventions file in context for the
whole session, so the file lists the agents instead of inlining a million
tokens of them.
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool aider
```
See [aider/README.md](aider/README.md) for details.
---
## Windsurf
All agents are consolidated into a single `.windsurfrules` file for your
project root.
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurf
```
See [windsurf/README.md](windsurf/README.md) for details.
---
## Kimi Code
Each agent is converted to a Kimi Code CLI agent specification (YAML format with
separate system prompt files). Agents are installed to `~/.config/kimi/agents/`.
Because the Kimi agent files are generated from the source Markdown, run
`./scripts/convert.sh --tool kimi` before installing from a fresh clone.
```bash
./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi
```
### Usage
After installation, use an agent with the `--agent-file` flag:
```bash
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml
```
Or in a specific project:
```bash
cd /your/project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
--work-dir /your/project
```
See [kimi/README.md](kimi/README.md) for details.
---
## Qwen Code
Each agent becomes a project-scoped `.md` SubAgent file in `.qwen/agents/`.
From a fresh clone, generate the Qwen files first:
```bash
./scripts/convert.sh --tool qwen
```
Then install them from your project root:
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool qwen
```
See [qwen/README.md](qwen/README.md) for details.
---
## Codex
Each agent is converted into a standalone Codex custom agent TOML file and
installed to `~/.codex/agents/`.
Because Codex uses generated TOML files rather than the source Markdown
directly, run the converter before installing from a fresh clone:
```bash
./scripts/convert.sh --tool codex
./scripts/install.sh --tool codex
```
See [codex/README.md](codex/README.md) for details.
---
### Overview (`integrations/aider/README.md`)
# Aider Integration
`CONVENTIONS.md` is the roster index: every agent's name, what it is for, its
division, and the path to its full instructions.
## Why an index and not the agents
Aider keeps a conventions file in context for the whole session โ that is the
point of the file. The 279 agent bodies together are about 3.8 million
characters, roughly a million tokens, so a conventions file holding all of them
does not fit in any model and costs a fortune in the attempt.
The index is about 97,000 characters (~24k tokens). Load it read-only so aider
marks it cacheable, and pull in a single agent's full instructions when you
actually need them.
## Install
```bash
# Run from your project root
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool aider
```
## Use an agent
Naming the agent is usually enough โ its description is already in context:
```
Use the Frontend Developer agent to refactor this component.
```
When you want the agent's full instructions, read its file into the session.
The index gives you the path:
```
/read-only /path/to/agency-agents/engineering/engineering-frontend-developer.md
```
## Manual usage
```bash
aider --read CONVENTIONS.md
```
`--read` marks the file read-only and lets aider cache it when prompt caching
is enabled, so the index is not re-sent on every turn.
## Regenerate
```bash
./scripts/convert.sh --tool aider
```
---
### Overview (`integrations/antigravity/README.md`)
# Antigravity Integration
Installs the full Agency roster as Antigravity skills. Each agent is prefixed
with `agency-` to avoid conflicts with existing skills.
## Install
```bash
./scripts/install.sh --tool antigravity
```
This copies files from `integrations/antigravity/` to
`~/.gemini/config/skills/` (global). For project-scoped skills, Antigravity
also reads `/.agents/skills/`.
## Activate a Skill
In Antigravity, activate an agent by its slug:
```
Use the agency-frontend-developer skill to review this component.
```
Available slugs follow the pattern `agency-`, e.g.:
- `agency-frontend-developer`
- `agency-backend-architect`
- `agency-reality-checker`
- `agency-growth-hacker`
## Regenerate
After modifying agents, regenerate the skill files:
```bash
./scripts/convert.sh --tool antigravity
```
## File Format
Each skill is a `SKILL.md` file with Antigravity-compatible frontmatter:
```yaml
---
name: agency-frontend-developer
description: Expert frontend developer specializing in...
risk: low
source: community
date_added: '2026-03-08'
---
```
---
### Overview (`integrations/claude-code/README.md`)
# Claude Code Integration
The Agency was built for Claude Code. No conversion needed โ agents work
natively with the existing `.md` + YAML frontmatter format.
## Install
```bash
# Copy all agents to your Claude Code agents directory
./scripts/install.sh --tool claude-code
# Or manually copy a category
cp engineering/*.md ~/.claude/agents/
```
## Activate an Agent
In any Claude Code session, reference an agent by name:
```
Activate Frontend Developer and help me build a React component.
```
```
Use the Reality Checker agent to verify this feature is production-ready.
```
## Agent Directory
Agents are organized into divisions. See the [main README](../../README.md) for
the full Agency roster.
---
### Overview (`integrations/codex/README.md`)
# Codex Integration
Converts all Agency agents into Codex custom agent TOML files. Each source
agent becomes one standalone `.toml` file containing the minimal Codex-required
fields: `name`, `description`, and `developer_instructions`.
## Installation
### Prerequisites
- [Codex](https://developers.openai.com/codex/overview) installed
### Convert And Install
```bash
# Generate integration files (required on fresh clone)
./scripts/convert.sh --tool codex
# Install agents
./scripts/install.sh --tool codex
```
This copies generated agent files to `~/.codex/agents/`.
## Generated Format
Each generated file lives in:
```text
integrations/codex/agents/.toml
```
The mapping is intentionally minimal:
- `name` is copied from the source frontmatter unchanged
- `description` is copied from the source frontmatter unchanged
- `developer_instructions` contains the full Markdown body unchanged
Source-only metadata such as `color`, `emoji`, `vibe`, and other unsupported
frontmatter fields are omitted.
## Usage
After installation, reference the custom agent by name in Codex:
```text
Use the Frontend Developer agent to review this component.
```
Codex uses the `name` field inside the TOML file as the source of truth, so the
generated filename slug is only for filesystem safety.
## Regenerate
After modifying source agents:
```bash
./scripts/convert.sh --tool codex
./scripts/install.sh --tool codex
```
## Troubleshooting
### Codex integration not found
Generate the Codex artifacts before installing:
```bash
./scripts/convert.sh --tool codex
```
### Codex not detected
Make sure `codex` is in your PATH, or that `~/.codex/` already exists:
```bash
which codex
codex --help
```
---
### Overview (`integrations/cursor/README.md`)
# Cursor Integration
Converts the full Agency roster into Cursor `.mdc` rule files. Rules are
**project-scoped** โ install them from your project root.
## Install
```bash
# Run from your project root
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool cursor
```
This creates `.cursor/rules/.mdc` files in your project.
## Activate a Rule
In Cursor, reference an agent in your prompt:
```
@frontend-developer Review this React component for performance issues.
```
Or enable a rule as always-on by editing its frontmatter:
```yaml
---
description: Expert frontend developer...
globs: "**/*.tsx,**/*.ts"
alwaysApply: true
---
```
## Regenerate
```bash
./scripts/convert.sh --tool cursor
```
---
### Overview (`integrations/dsh/README.md`)
# DeepSeek Harness Integration
Installs the full Agency roster as DeepSeek Harness (DSH) skills. Each agent
is prefixed with `agency-` to avoid conflicts with built-in skills.
## Install
```bash
./scripts/install.sh --tool dsh
```
This copies files from `integrations/dsh/` to `${DSH_HOME:-$HOME/.dsh}/skills/`
(user-wide). Set `DSH_HOME` if your Harness config lives elsewhere. For
project-scoped skills, run the installer with `DSH_SKILLS_DIR=.dsh/skills`
from your project root โ this specific override takes precedence over
`DSH_HOME`, and DSH reads `/.dsh/skills/` automatically.
> DSH discovers skills live (watched roots): new, renamed, or deleted skills
> reach the next catalog without a restart. No config file to edit.
## Activate a Skill
In DSH, skills are user- and model-invocable by default. Activate an agent
by its slash command or by name in conversation:
```
/agency-frontend-developer review this React component
```
or:
```
Use the agency-frontend-developer skill to review this component.
```
Available slugs follow the pattern `agency-`, e.g.:
- `agency-frontend-developer`
- `agency-backend-architect`
- `agency-reality-checker`
- `agency-growth-hacker`
## Regenerate
After modifying agents, regenerate the skill files:
```bash
./scripts/convert.sh --tool dsh
```
## File Format
Each skill is a `SKILL.md` file with the standard Agent-Skills frontmatter
(required `name` and `description`, strict kebab-case name) and the agent
persona as the body:
```markdown
---
name: 'agency-frontend-developer'
description: 'Expert frontend developer specializing in modern web technologies, React/Vue/Angular frameworks, UI implementation, and performance optimization'
---
...agent body...
```
This is byte-identical to the Antigravity and Osaurus skill output
(`skill-md` format), so the Agency Agents app renders it natively.
## Skill Roots Scanned by DSH
| Priority | Source | Path |
|---|---|---|
| 100 | project | `/.dsh/skills` |
| 200 | project | `/.agents/skills` |
| 300 | custom | `customSkillDirs` config |
| 400 | user | `${DSH_HOME:-$HOME/.dsh}/skills` (default install) |
| 500 | user | `~/.agents/skills` |
Project skills (rank 100/200) shadow user skills (rank 400/500) of the same
name, so a project install overrides the user-wide one for that project.
---
### Overview (`integrations/gemini-cli/README.md`)
# Gemini CLI Integration
Packages all Agency agents as Gemini CLI subagents. These agents
install to `~/.gemini/agents/`.
## Install
```bash
# Generate the Gemini CLI agent files first
./scripts/convert.sh --tool gemini-cli
# Then install them to ~/.gemini/agents/
./scripts/install.sh --tool gemini-cli
```
## Use an Agent
In Gemini CLI, reference an agent by name in your prompt:
```
Use the frontend-developer agent to help me build this UI.
```
Or invoke the agent directly if your version of Gemini CLI supports it:
```bash
gemini --agent frontend-developer "How should I structure this React component?"
```
## Structure
```
~/.gemini/agents/
frontend-developer.md
backend-architect.md
reality-checker.md
...
```
## Regenerate
```bash
./scripts/convert.sh --tool gemini-cli
```
---
### Overview (`integrations/github-copilot/README.md`)
# GitHub Copilot Integration
The Agency works with GitHub Copilot out of the box. No conversion needed โ
agents use the existing `.md` + YAML frontmatter format.
## Install
```bash
# Copy all agents to your GitHub Copilot agents directories
./scripts/install.sh --tool copilot
# Or manually copy a category
cp engineering/*.md ~/.github/agents/
cp engineering/*.md ~/.copilot/agents/
```
## Activate an Agent
In any GitHub Copilot session, reference an agent by name:
```
Activate Frontend Developer and help me build a React component.
```
```
Use the Reality Checker agent to verify this feature is production-ready.
```
## Agent Directory
Agents are organized into divisions. See the [main README](../../README.md) for
the full current roster.
---
### Overview (`integrations/hermes/README.md`)
# Hermes Agency Agents Router Plugin
Generated by `scripts/convert.sh --tool hermes`.
This integration installs one Hermes plugin named `agency-agents-router` instead
of adding hundreds of generated skills to `skills.external_dirs`. Hermes sees a
small fixed tool surface at startup, while the complete Agency roster is
stored on disk in `data/agents.json` and searched/loaded lazily.
Generated agent count: 282
## Tools exposed to Hermes
- `agency_agents_search` โ find matching specialists by query/division.
- `agency_agents_inspect` โ inspect one specialist's metadata or full body.
- `agency_agents_load` โ compose one specialist prompt for the current task.
- `agency_agents_delegate` โ delegate through Hermes' public subagent lifecycle.
Each tool is registered with Hermes' complete function-tool schema, including
its name, description, and JSON `parameters`. The available arguments are:
| Tool | Arguments |
| --- | --- |
| `agency_agents_search` | `query` (required), optional `division` and `limit` |
| `agency_agents_inspect` | `agent` or `slug`, optional `include_body` |
| `agency_agents_load` | `agent` or `slug`, optional `task` |
| `agency_agents_delegate` | `agent` or `slug`, `task` (required) |
A normal flow is: search by capability, take a returned `slug`, then inspect,
load, or delegate to that specialist. You can ask Hermes to do this in natural
language; direct tool calls are not required.
## Specialist usage instruction for Hermes
When a Hermes project needs Agency specialists, explicitly ask Hermes to use
the `agency-agents-router` plugin/router and load only the specialists needed for
the current phase. Do not ask Hermes to install or preload the full Agency
roster as skills.
Recommended project instruction:
```text
Use the agency-agents-router plugin. Search the Agency roster for the right
specialists, then load or delegate only the specific agents needed for each
part of the project. For multi-discipline projects, use multiple selected
specialists across the project, but keep routing lazy: do not preload the
full Agency roster and do not add agency-agents to skills.external_dirs.
```
Example:
```text
For this Data Swami build, use the agency-agents-router plugin to pick
relevant Agency specialists. Search first, then delegate to selected agents
such as frontend, backend, UX, QA, data engineering, and product strategy as
needed. Load/delegate each specialist on demand rather than loading all
Agency agents at startup.
```
## Install
```bash
./scripts/convert.sh --tool hermes
./scripts/install.sh --tool hermes
```
The installer copies the generated plugin to:
```text
${HERMES_HOME:-~/.hermes}/plugins/agency-agents-router
```
It then enables `agency-agents-router` under `plugins.enabled` in the Hermes
config. It does **not** write to `skills.external_dirs`.
Restart Hermes or start a new session after installing so the plugin and its
tool schemas are loaded. If Hermes displays these tools without their documented
arguments, regenerate and reinstall the plugin from the latest Agency Agents
checkout, then restart Hermes.
---
### Overview (`integrations/kimi/README.md`)
# Kimi Code CLI Integration
Converts all Agency agents into Kimi Code CLI agent specifications. Each agent
becomes a directory containing `agent.yaml` (agent spec) and `system.md` (system
prompt).
## Installation
### Prerequisites
- [Kimi Code CLI](https://github.com/MoonshotAI/kimi-cli) installed
### Install
```bash
# Generate integration files (required on fresh clone)
./scripts/convert.sh --tool kimi
# Install agents
./scripts/install.sh --tool kimi
```
This copies agents to `~/.config/kimi/agents/`.
## Usage
### Activate an Agent
Use the `--agent-file` flag to load a specific agent:
```bash
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml
```
### In a Project
```bash
cd /your/project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
--work-dir /your/project \
"Review this React component for performance issues"
```
### List Installed Agents
```bash
ls ~/.config/kimi/agents/
```
## Agent Structure
Each agent directory contains:
```
~/.config/kimi/agents/frontend-developer/
โโโ agent.yaml # Agent specification (tools, subagents)
โโโ system.md # System prompt with personality and instructions
```
### agent.yaml format
```yaml
version: 1
agent:
name: frontend-developer
extend: default # Inherits from Kimi's built-in default agent
system_prompt_path: ./system.md
tools:
- "kimi_cli.tools.shell:Shell"
- "kimi_cli.tools.file:ReadFile"
# ... all default tools
```
## Regenerate
After modifying source agents:
```bash
./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi
```
## Troubleshooting
### Agent file not found
Ensure you've run `convert.sh` before `install.sh`:
```bash
./scripts/convert.sh --tool kimi
```
### Kimi CLI not detected
Make sure `kimi` is in your PATH:
```bash
which kimi
kimi --version
```
### Invalid YAML
Validate the generated files:
```bash
python3 -c "import yaml; yaml.safe_load(open('integrations/kimi/frontend-developer/agent.yaml'))"
```
---
### Overview (`integrations/mcp-memory/README.md`)
# MCP Memory Integration
> Give any agent persistent memory across sessions using the Model Context Protocol (MCP).
## What It Does
By default, agents in The Agency start every session from scratch. Context is passed manually via copy-paste between agents and sessions. An MCP memory server changes that:
- **Cross-session memory**: An agent remembers decisions, deliverables, and context from previous sessions
- **Handoff continuity**: When one agent hands off to another, the receiving agent can recall exactly what was done โ no copy-paste required
- **Rollback on failure**: When a QA check fails or an architecture decision turns out wrong, roll back to a known-good state instead of starting over
## Setup
You need an MCP server that provides memory tools: `remember`, `recall`, `rollback`, and `search`. Add it to your MCP client config (Claude Code, Cursor, etc.):
```json
{
"mcpServers": {
"memory": {
"command": "your-mcp-memory-server",
"args": []
}
}
}
```
Any MCP server that exposes `remember`, `recall`, `rollback`, and `search` tools will work. Check the [MCP ecosystem](https://modelcontextprotocol.io) for available implementations.
## How to Add Memory to Any Agent
To enhance an existing agent with persistent memory, add a **Memory Integration** section to the agent's prompt. This section instructs the agent to use MCP memory tools at key moments.
### The Pattern
```markdown
## Memory Integration
When you start a session:
- Recall relevant context from previous sessions using your role and the current project as search terms
- Review any memories tagged with your agent name to pick up where you left off
When you make key decisions or complete deliverables:
- Remember the decision or deliverable with descriptive tags (your agent name, the project, the topic)
- Include enough context that a future session โ or a different agent โ can understand what was done and why
When handing off to another agent:
- Remember your deliverables tagged for the receiving agent
- Include the handoff metadata: what you completed, what's pending, and what the next agent needs to know
When something fails and you need to recover:
- Search for the last known-good state
- Use rollback to restore to that point rather than rebuilding from scratch
```
### What the Agent Does With This
The LLM will use MCP memory tools automatically when given these instructions:
- `remember` โ store a decision, deliverable, or context snapshot with tags
- `recall` โ search for relevant memories by keyword, tag, or semantic similarity
- `rollback` โ revert to a previous state when something goes wrong
- `search` โ find specific memories across sessions and agents
No code changes to the agent files. No API calls to write. The MCP tools handle everything.
## Example: Enhancing the Backend Architect
See [backend-architect-with-memory.md](backend-architect-with-memory.md) for a complete example โ the standard Backend Architect agent with a Memory Integration section added.
## Example: Memory-Powered Workflow
See [../../examples/workflow-with-memory.md](../../examples/workflow-with-memory.md) for the Startup MVP workflow enhanced with persistent memory, showing how agents pass context through memory instead of copy-paste.
## Tips
- **Tag consistently**: Use the agent name and project name as tags on every memory. This makes recall reliable.
- **Let the LLM decide what's important**: The memory instructions are guidance, not rigid rules. The LLM will figure out when to remember and what to recall.
- **Rollback is the killer feature**: When a Reality Checker fails a deliverable, the original agent can roll back to its last checkpoint instead of trying to manually undo changes.
---
### Overview (`integrations/openclaw/README.md`)
# OpenClaw Integration
OpenClaw agents are installed as workspaces containing `SOUL.md`, `AGENTS.md`,
and `IDENTITY.md` files. The installer copies each workspace into
`~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is
available.
Before installing, generate the OpenClaw workspaces:
```bash
./scripts/convert.sh --tool openclaw
```
## Install
```bash
./scripts/install.sh --tool openclaw
```
## Activate an Agent
After installation, agents are available by `agentId` in OpenClaw sessions.
If the OpenClaw gateway is already running, restart it after installation:
```bash
openclaw gateway restart
```
## Regenerate
```bash
./scripts/convert.sh --tool openclaw
```
---
### Overview (`integrations/opencode/README.md`)
# OpenCode Integration
> **โ Don't do this:**
>
> ```bash
> # WRONG โ will fail with schema validation errors
> cp agency-agents/engineering/*.md .opencode/agents/
> ```
>
> **โ
Do this instead:**
>
> ```bash
> /path/to/agency-agents/scripts/install.sh --tool opencode
> ```
>
> The source files use named colors and a `tools` field that OpenCode rejects.
> The installer converts them to `#RRGGBB` hex and strips incompatible fields
> automatically.
OpenCode agents are `.md` files with YAML frontmatter stored in
`.opencode/agents/`. The converter maps named colors to hex codes and adds
`mode: subagent` so agents are invoked on-demand via `@agent-name` rather
than cluttering the primary agent picker.
## Install
```bash
# Run from your project root
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode
```
This creates `.opencode/agents/.md` files in your project directory.
## Activate an Agent
In OpenCode, invoke a subagent with the `@` prefix:
```
@frontend-developer help build this component.
```
```
@reality-checker review this PR.
```
You can also select agents from the OpenCode UI's agent picker.
## Agent Format
Each generated agent file contains:
```yaml
---
name: Frontend Developer
description: Expert frontend developer specializing in modern web technologies...
mode: subagent
color: "#00FFFF"
---
```
- **mode: subagent** โ agent is available on-demand, not shown in the primary Tab-cycle list
- **color** โ hex code (named colors from source files are converted automatically)
## Project vs Global
Agents in `.opencode/agents/` are **project-scoped**. To make them available
globally across all projects, first generate the agent files, then install
with `--path`:
```bash
./scripts/convert.sh --tool opencode
./scripts/install.sh --tool opencode --path ~/.config/opencode/agents
```
## Regenerate
```bash
./scripts/convert.sh --tool opencode
```
---
### Overview (`integrations/qwen/README.md`)
# Qwen Code Integration
Qwen Code uses project-scoped `.md` SubAgent files in `.qwen/agents/`.
The generated files come from `scripts/convert.sh --tool qwen`, which writes one
SubAgent Markdown file per agency agent into `integrations/qwen/agents/`.
## Requirements
Qwen Code **0.25.1 or later**. Earlier releases treat every `${name}` in a
SubAgent's prompt as a value to fill and refuse to launch the agent when they
have none ("Missing context values for the following keys: โฆ"). Several agents
show `${name}` in their code examples, so on those releases they can't be
launched. From 0.25.1, Qwen leaves any `${name}` it doesn't fill as written
([#1081](https://github.com/msitarzewski/agency-agents/issues/1081)).
Qwen does fill three names: `${task_prompt}`, `${hook_context}` and
`${external_inputs_override}`. `scripts/lint-agents.sh` rejects them in agent
bodies, so no agent text is replaced at launch.
## Generate
From the repository root:
```bash
./scripts/convert.sh --tool qwen
```
## Install
Run the installer from your target project root:
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool qwen
```
This copies the generated SubAgent files into:
```text
.qwen/agents/
```
## Refresh in Qwen Code
After installation:
- run `/agents manage` in Qwen Code to refresh the agent list, or
- restart the current Qwen Code session
## Notes
- Qwen Code is project-scoped, not home-scoped
- The generated Qwen files use minimal frontmatter: `name`, `description`, and
optional `tools`
- If you update agents in this repo, regenerate the Qwen output before
reinstalling
---
### Overview (`integrations/vibe/README.md`)
# Mistral Vibe Integration
Mistral Vibe uses two files per agent:
- A TOML configuration file (`~/.vibe/agents/.toml`)
- A Markdown prompt file (`~/.vibe/prompts/.md`)
The generated files come from `scripts/convert.sh --tool vibe`, which writes
one TOML agent configuration and one Markdown prompt file per agency agent
into `integrations/vibe/agents/` and `integrations/vibe/prompts/` respectively.
## Generate
From the repository root:
```bash
./scripts/convert.sh --tool vibe
```
## Install
Run the installer from your target directory:
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool vibe
```
This copies the generated files into:
```text
~/.vibe/agents/.toml
~/.vibe/prompts/.md
```
You can override the destination using the `VIBE_HOME` environment variable:
```bash
VIBE_HOME=~/.config/vibe ./scripts/install.sh --tool vibe
```
## Generated Format
Each generated agent pair lives in:
```text
integrations/vibe/agents/.toml
integrations/vibe/prompts/.md
```
### Agent TOML File
The minimal Vibe agent configuration:
```toml
agent_type = "agent"
system_prompt_id = ""
```
Users can specify `active_model` in their agent TOML files or rely on their
Vibe configuration default model.
### Prompt Markdown File
The prompt file contains:
- A title header with the agent name
- The agent description
- The full Markdown body from the source agent
## Usage
After installation, reference agents in Mistral Vibe by their system prompt ID
(which matches the filename slug).
Example:
```text
Use the Code Reviewer agent to analyze this pull request.
```
## Filtering
Install only specific divisions or agents:
```bash
# Install only agents from Division 1
./scripts/install.sh --tool vibe --division 1
# Install only the code-reviewer agent
./scripts/install.sh --tool vibe --agent code-reviewer
```
## Regenerate
After modifying source agents:
```bash
./scripts/convert.sh --tool vibe
./scripts/install.sh --tool vibe
```
## Troubleshooting
### Mistral Vibe not detected
Make sure `vibe` is in your PATH, or that `~/.vibe/` already exists:
```bash
which vibe
vibe --version
```
### Integration files not generated
Generate the Vibe artifacts before installing:
```bash
./scripts/convert.sh --tool vibe
```
---
### Overview (`integrations/windsurf/README.md`)
# Windsurf Integration
The full Agency roster is consolidated into a single `.windsurfrules` file.
Rules are **project-scoped** โ install them from your project root.
## Install
```bash
# Run from your project root
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool windsurf
```
## Activate an Agent
In Windsurf, reference an agent by name in your prompt:
```
Use the Frontend Developer agent to build this component.
```
## Regenerate
```bash
./scripts/convert.sh --tool windsurf
```
---
### Overview (`integrations/zcode/README.md`)
# ZCode Integration
[ZCode](https://z.ai) is Z.ai's GLM-based coding agent harness. Each agency
agent is rendered as a standalone Markdown agent file with `name` and
`description` frontmatter, which ZCode discovers from its agents directory.
The generated files come from `scripts/convert.sh --tool zcode`, which writes
one Markdown file per agency agent into `integrations/zcode/agents/`. Those
generated files are not committed (see `.gitignore`); regenerate them locally.
## Generate
From the repository root:
```bash
./scripts/convert.sh --tool zcode
```
## Install
Run the installer from your target directory:
```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool zcode
```
Agents install to `~/.zcode/agents/.md` (user scope) โ the directory
ZCode reads subagents from. Use `--division` / `--agent` to install a subset,
or set `ZCODE_AGENTS_DIR` to override the destination.
---
--- METRICS ---
- Files Extracted: 20
- Estimated Token Budget: ~30349 tokens
- Canonical Reference: https://codewiki.google/github.com/msitarzewski/agency-agents