git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

# Copy all agents to Claude's agents directory
cp -r agency-agents/* ~/.claude/agents/

# Or symlink for auto-updates
ln -s /path/to/agency-agents ~/.claude/agents/agency

Hey Claude, activate Frontend Developer mode and help me build a React component

# Step 1: Generate integration files for all supported tools
./scripts/convert.sh

# Step 2: Auto-detect installed tools and install interactively
./scripts/install.sh

# Or target a specific tool
./scripts/install.sh --tool cursor
./scripts/install.sh --tool copilot
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf

engineering/engineering-frontend-developer.md       React/Vue/Angular, UI, Core Web Vitals
engineering/engineering-backend-architect.md        API design, databases, scalability
engineering/engineering-mobile-app-builder.md       iOS/Android, React Native, Flutter
engineering/engineering-ai-engineer.md              ML models, AI integration, data pipelines
engineering/engineering-devops-automator.md         CI/CD, infra automation, cloud ops
engineering/engineering-rapid-prototyper.md         MVPs, POCs, hackathon speed
engineering/engineering-senior-developer.md         Laravel/Livewire, advanced patterns
engineering/engineering-security-engineer.md        Threat modeling, secure code review
engineering/engineering-code-reviewer.md            PR reviews, code quality gates
engineering/engineering-database-optimizer.md       PostgreSQL/MySQL tuning, slow queries
engineering/engineering-git-workflow-master.md      Branching, conventional commits
engineering/engineering-software-architect.md       System design, DDD, trade-off analysis
engineering/engineering-sre.md                      SLOs, error budgets, chaos engineering
engineering/engineering-incident-response-commander.md  Incident management, post-mortems
engineering/engineering-technical-writer.md         Developer docs, API reference
engineering/engineering-data-engineer.md            Data pipelines, lakehouse, ETL/ELT

design/design-ui-designer.md                        Visual design, component libraries
design/design-ux-researcher.md                      User testing, behavior analysis
design/design-ux-architect.md                       CSS systems, technical UX
design/design-brand-guardian.md                     Brand identity and consistency
design/design-whimsy-injector.md                    Micro-interactions, delight, Easter eggs
design/design-image-prompt-engineer.md              Midjourney/DALL-E/SD prompts
design/design-inclusive-visuals-specialist.md       Representation, bias mitigation

marketing/marketing-growth-hacker.md
marketing/marketing-content-creator.md
paid-media/paid-media-ppc-strategist.md
paid-media/paid-media-creative-strategist.md
sales/sales-outbound-strategist.md
sales/sales-deal-strategist.md
sales/sales-discovery-coach.md

# In Claude Code chat:
Activate the Backend Architect agent and help me design a REST API for a multi-tenant SaaS app.

# First, design the system
Activate the Software Architect agent. Design the domain model for an e-commerce platform.

# Then implement
Now activate the Senior Developer agent and implement the Order aggregate in Laravel.

# Then review
Activate the Code Reviewer agent and review the implementation above.

# Pass an agent as a system prompt in Claude CLI
claude --system-prompt "$(cat ~/.claude/agents/engineering-frontend-developer.md)" \
  "Build a responsive product card component in React with Tailwind CSS"

@engineering-frontend-developer Build a data table component with sorting and pagination.

---
alwaysApply: true
---

You are operating as the Senior Developer agent from The Agency.
Refer to .cursor/rules/engineering-senior-developer.md for your full persona and workflows.

# Use a single agent as the system prompt
aider --system-prompt "$(cat agency-agents/engineering/engineering-security-engineer.md)"

# Or reference in .aider.conf.yml
echo "system-prompt: agency-agents/engineering/engineering-devops-automator.md" >> .aider.conf.yml

./scripts/install.sh --tool windsurf
# Agents are written to .windsurf/rules/

Use the UX Architect agent rules from .windsurf/rules/ to audit my CSS architecture.

# 1. Architecture phase
cat > task.md << 'EOF'
I need to add real-time notifications to my Node.js + React app.
Users should see in-app alerts and optionally receive email digests.
EOF

# Invoke Software Architect
claude --system-prompt "$(cat ~/.claude/agents/engineering-software-architect.md)" < task.md

# 2. Backend implementation
claude --system-prompt "$(cat ~/.claude/agents/engineering-backend-architect.md)" \
  "Implement the notification service based on the architecture above using PostgreSQL LISTEN/NOTIFY and Socket.io"

# 3. Frontend implementation
claude --system-prompt "$(cat ~/.claude/agents/engineering-frontend-developer.md)" \
  "Build the React notification bell component that connects to the Socket.io feed"

# 4. Security review
claude --system-prompt "$(cat ~/.claude/agents/engineering-security-engineer.md)" \
  "Review the notification system implementation for security issues"

# Generate a diff and pipe to the Code Reviewer agent
git diff main..feature/payment-integration | \
  claude --system-prompt "$(cat ~/.claude/agents/engineering-code-reviewer.md)" \
  "Review this PR diff. Focus on security, correctness, and maintainability."

# Paste slow query log and activate Database Optimizer
claude --system-prompt "$(cat ~/.claude/agents/engineering-database-optimizer.md)" << 'EOF'
Here is a slow query from our PostgreSQL logs (avg 4200ms):

SELECT u.*, p.*, o.*
FROM users u
LEFT JOIN profiles p ON p.user_id = u.id
LEFT JOIN orders o ON o.user_id = u.id
WHERE u.created_at > NOW() - INTERVAL '30 days'
ORDER BY o.created_at DESC;

Table sizes: users=2M rows, orders=18M rows. No indexes on created_at columns.
EOF

# Structured incident kick-off
claude --system-prompt "$(cat ~/.claude/agents/engineering-incident-response-commander.md)" << 'EOF'
SEV-1 INCIDENT: Payment processing returning 503 errors since 14:32 UTC.
Error rate: 94%. Affected: checkout, subscription renewals.
Recent deploys: payment-service v2.4.1 at 14:15 UTC.
EOF

# 🎯 Agent Name

## Identity
You are [Name], [role] at The Agency...

## Core Mission
[What this agent optimizes for]

## Personality & Communication Style
- [Trait 1]
- [Trait 2]

## Workflows

### [Workflow Name]
1. [Step 1]
2. [Step 2]

## Deliverables
- [Concrete output 1]
- [Concrete output 2]

## Success Metrics
- [Measurable outcome]

# Fork and clone
git clone https://github.com/YOUR_USERNAME/agency-agents.git

# Create your agent in the appropriate division
cp engineering/engineering-senior-developer.md \
   engineering/engineering-YOUR-SPECIALTY.md

# Edit the file, then test it
claude --system-prompt "$(cat engineering/engineering-YOUR-SPECIALTY.md)" \
  "Give me a sample deliverable to demonstrate your capabilities"

# Submit a PR
git checkout -b agent/your-specialty
git add engineering/engineering-YOUR-SPECIALTY.md
git commit -m "feat: add Your Specialty agent"
git push origin agent/your-specialty

ls ~/.claude/agents/
# If empty, re-run:
cp -r /path/to/agency-agents/* ~/.claude/agents/

chmod +x scripts/convert.sh scripts/install.sh
./scripts/convert.sh

# Rules must be in project root .cursor/rules/
ls .cursor/rules/
# Re-run installer targeting cursor
./scripts/install.sh --tool cursor

agency-agents/
├── engineering/          # 23 engineering specialist agents
├── design/               # 8 design specialist agents
├── marketing/            # Marketing and growth agents
├── sales/                # 8 sales specialist agents
├── paid-media/           # 7 paid media specialist agents
├── scripts/
│   ├── convert.sh        # Generate tool-specific integration files
│   └── install.sh        # Interactive installer (auto-detects tools)
└── README.md