Skip to main content

​
Installation & Setup

Get The Agency up and running in your development environment.

​
Prerequisites

Before installing The Agency, ensure you have:

Git

For cloning the repository

Claude Code

Optional - for seamless integration

Text Editor

Any editor to view/customize agents

Terminal

For running installation commands

​
Installation Methods

​
Claude Code Installation

The recommended method for seamless agent activation:
1

Clone the repository

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

Copy agents to Claude Code directory

# Create the agents directory if it doesn't exist
mkdir -p ~/.claude/agents/

# Copy all agents
cp -r engineering design marketing product project-management testing support spatial-computing specialized ~/.claude/agents/
3

Verify installation

# List installed agents
ls -la ~/.claude/agents/

# You should see all division directories
4

Test activation

Open Claude Code and try:
Hey Claude, activate Frontend Developer mode
The agent should respond with their specialized personality.

​
Directory Structure

After installation, your directory structure should look like: 
~/.claude/agents/
├── engineering/
│   ├── engineering-frontend-developer.md
│   ├── engineering-backend-architect.md
│   ├── engineering-mobile-app-builder.md
│   ├── engineering-ai-engineer.md
│   ├── engineering-devops-automator.md
│   ├── engineering-rapid-prototyper.md
│   └── engineering-senior-developer.md
├── design/
│   ├── design-ui-designer.md
│   ├── design-ux-researcher.md
│   ├── design-ux-architect.md
│   ├── design-brand-guardian.md
│   ├── design-visual-storyteller.md
│   ├── design-whimsy-injector.md
│   └── design-image-prompt-engineer.md
├── marketing/
│   ├── marketing-growth-hacker.md
│   ├── marketing-content-creator.md
│   ├── marketing-twitter-engager.md
│   ├── marketing-tiktok-strategist.md
│   ├── marketing-instagram-curator.md
│   ├── marketing-reddit-community-builder.md
│   ├── marketing-app-store-optimizer.md
│   └── marketing-social-media-strategist.md
├── product/
│   ├── product-sprint-prioritizer.md
│   ├── product-trend-researcher.md
│   └── product-feedback-synthesizer.md
├── project-management/
│   ├── project-management-studio-producer.md
│   ├── project-management-project-shepherd.md
│   ├── project-management-studio-operations.md
│   ├── project-management-experiment-tracker.md
│   └── project-manager-senior.md
├── testing/
│   ├── testing-evidence-collector.md
│   ├── testing-reality-checker.md
│   ├── testing-test-results-analyzer.md
│   ├── testing-performance-benchmarker.md
│   ├── testing-api-tester.md
│   ├── testing-tool-evaluator.md
│   └── testing-workflow-optimizer.md
├── support/
│   ├── support-support-responder.md
│   ├── support-analytics-reporter.md
│   ├── support-finance-tracker.md
│   ├── support-infrastructure-maintainer.md
│   ├── support-legal-compliance-checker.md
│   └── support-executive-summary-generator.md
├── spatial-computing/
│   ├── xr-interface-architect.md
│   ├── macos-spatial-metal-engineer.md
│   ├── xr-immersive-developer.md
│   ├── xr-cockpit-interaction-specialist.md
│   ├── visionos-spatial-engineer.md
│   └── terminal-integration-specialist.md
└── specialized/
    ├── agents-orchestrator.md
    ├── data-analytics-reporter.md
    ├── lsp-index-engineer.md
    ├── sales-data-extraction-agent.md
    ├── data-consolidation-agent.md
    └── report-distribution-agent.md

​
Configuration

​
Custom Agent Location

If you want to install agents in a different location: 
# Set custom location
export AGENCY_AGENTS_PATH="/path/to/your/agents"

# Copy agents
cp -r agency-agents/* $AGENCY_AGENTS_PATH/

​
Selective Installation

Install only specific divisions: 
# Install only engineering and design agents
cp -r engineering design ~/.claude/agents/

​
Environment-Specific Agents

Create different agent sets for different projects: 
# Create project-specific agent directories
mkdir -p ~/projects/project-a/agents
mkdir -p ~/projects/project-b/agents

# Copy relevant agents to each project
cp -r engineering design ~/projects/project-a/agents/
cp -r marketing support ~/projects/project-b/agents/

​
Verification

Verify your installation:
1

Check file count

find ~/.claude/agents -name "*.md" | wc -l
# Should show 55+ agent files
2

Test agent activation

Open Claude Code and activate a test agent:
Activate Evidence Collector mode and describe your role
Expected response should include personality and workflow details.
3

Verify agent content

# Check an agent file has all sections
cat ~/.claude/agents/engineering/engineering-frontend-developer.md

# Should include:
# - Identity & Memory
# - Core Mission
# - Critical Rules
# - Technical Deliverables
# - Workflow Process
# - Success Metrics

​
Troubleshooting

Problem: Claude doesn’t recognize agent activation commands.Solutions:
  1. Verify agents are in ~/.claude/agents/
  2. Check file permissions: chmod -R 644 ~/.claude/agents/*.md
  3. Restart Claude Code
  4. Try full path: “Activate the agent at ~/.claude/agents/engineering/engineering-frontend-developer.md”
Problem: Cannot copy files to ~/.claude/agents/Solutions:
  1. Check directory exists: mkdir -p ~/.claude/agents
  2. Fix permissions: chmod 755 ~/.claude/agents
  3. Use sudo if needed: sudo cp -r * ~/.claude/agents/
Problem: Cannot clone repositorySolutions:
  1. Check internet connection
  2. Verify Git installation: git --version
  3. Try HTTPS instead of SSH: 
    git clone https://github.com/msitarzewski/agency-agents.git
Problem: Agents don’t show specialized personalitySolutions:
  1. Be explicit: “Activate Frontend Developer mode AND follow your personality guidelines”
  2. Provide context: Include project details and specific requirements
  3. Reference deliverables: “Use your technical deliverables as examples”

​
Updating Agents

Keep your agents up to date: 
# Navigate to repository
cd agency-agents

# Pull latest changes
git pull origin main

# Reinstall agents
cp -r * ~/.claude/agents/

​
Uninstallation

Remove The Agency: 
# Remove all agents
rm -rf ~/.claude/agents/

# Or remove specific divisions
rm -rf ~/.claude/agents/marketing/

​
Next Steps

Quick Start

Start using agents immediately

Agent Design

Understand agent architecture

Use Cases

See agents in action

Creating Agents

Build your own agents
Having issues? Check our GitHub Issues or start a Discussion.

Build docs developers (and LLMs) love

Get started for freeTalk to us