Documentation Index Fetch the complete documentation index at: https://mintlify.com/msitarzewski/agency-agents/llms.txt
Use this file to discover all available pages before exploring further.
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 Integration
Standalone Installation
Fork & Customize
Claude Code Installation The recommended method for seamless agent activation:
Clone the repository
git clone https://github.com/msitarzewski/agency-agents.git cd agency-agents
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/
Verify installation
# List installed agents ls -la ~/.claude/agents/ # You should see all division directories
Test activation
Open Claude Code and try: Hey Claude, activate Frontend Developer mode
The agent should respond with their specialized personality. Standalone Installation Use agents as reference templates without Claude Code:
Clone the repository
git clone https://github.com/msitarzewski/agency-agents.git cd agency-agents
Organize your workspace
# Create a project directory mkdir -p ~/ai-agents/the-agency # Copy agents cp -r * ~/ai-agents/the-agency/
Browse agents
# Navigate to any division cd ~/ai-agents/the-agency/engineering # View an agent cat engineering-frontend-developer.md
Use as prompts
Copy agent content into your preferred AI tool as a prompt template.
Fork for Customization Create your own customized version:
Customize agents
Edit agent files to match your needs: # Edit an agent vim engineering/engineering-frontend-developer.md # Customize personality, workflows, or deliverables
Add custom agents
Create new agents following the template: # Create a new agent touch specialized/your-custom-agent.md # Follow the agent template structure
Commit changes
git add . git commit -m "Customize agents for my workflow" git push origin main
Install customized agents
# Copy to Claude Code cp -r * ~/.claude/agents/
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:
Check file count
find ~/.claude/agents -name "*.md" | wc -l # Should show 55+ agent files
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.
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
Agents not activating in Claude Code
Problem : Claude doesn’t recognize agent activation commands.Solutions :
Verify agents are in ~/.claude/agents/
Check file permissions: chmod -R 644 ~/.claude/agents/*.md
Restart Claude Code
Try full path: “Activate the agent at ~/.claude/agents/engineering/engineering-frontend-developer.md”
Problem : Cannot copy files to ~/.claude/agents/Solutions :
Check directory exists: mkdir -p ~/.claude/agents
Fix permissions: chmod 755 ~/.claude/agents
Use sudo if needed: sudo cp -r * ~/.claude/agents/
Problem : Cannot clone repositorySolutions :
Check internet connection
Verify Git installation: git --version
Try HTTPS instead of SSH:
git clone https://github.com/msitarzewski/agency-agents.git
Agents behaving generically
Problem : Agents don’t show specialized personalitySolutions :
Be explicit: “Activate Frontend Developer mode AND follow your personality guidelines”
Provide context: Include project details and specific requirements
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
