agents-claudecli/README.md

Contains Studio AI Agents

A comprehensive collection of specialized AI agents designed to accelerate and enhance every aspect of rapid development. Each agent is an expert in their domain, ready to be invoked when their expertise is needed.

📥 Installation

1. Download this repository:

   git clone https://github.com/contains-studio/agents.git
   

2. Copy to your Claude Code agents directory:

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

   Or manually copy all the agent files to your ~/.claude/agents/ directory.

3. Restart Claude Code to load the new agents.

🚀 Quick Start

Agents are automatically available in Claude Code. Simply describe your task and the appropriate agent will be triggered. You can also explicitly request an agent by mentioning their name.

📚 Learn more: Claude Code Sub-Agents Documentation

Example Usage

• "Create a new app for tracking meditation habits" → rapid-prototyper
• "What's trending on TikTok that we could build?" → trend-researcher
• "Our app reviews are dropping, what's wrong?" → feedback-synthesizer
• "Make this loading screen more fun" → whimsy-injector

📁 Directory Structure

Agents are organized by department for easy discovery:

contains-studio-agents/
├── design/
│   ├── brand-guardian.md
│   ├── ui-designer.md
│   ├── ux-researcher.md
│   ├── visual-storyteller.md
│   └── whimsy-injector.md
├── engineering/
│   ├── ai-engineer.md
│   ├── backend-architect.md
│   ├── devops-automator.md
│   ├── frontend-developer.md
│   ├── mobile-app-builder.md
│   ├── rapid-prototyper.md
│   └── test-writer-fixer.md
├── marketing/
│   ├── app-store-optimizer.md
│   ├── content-creator.md
│   ├── growth-hacker.md
│   ├── instagram-curator.md
│   ├── reddit-community-builder.md
│   ├── tiktok-strategist.md
│   └── twitter-engager.md
├── product/
│   ├── feedback-synthesizer.md
│   ├── sprint-prioritizer.md
│   └── trend-researcher.md
├── project-management/
│   ├── experiment-tracker.md
│   ├── project-shipper.md
│   └── studio-producer.md
├── studio-operations/
│   ├── analytics-reporter.md
│   ├── finance-tracker.md
│   ├── infrastructure-maintainer.md
│   ├── legal-compliance-checker.md
│   └── support-responder.md
├── testing/
│   ├── api-tester.md
│   ├── performance-benchmarker.md
│   ├── test-results-analyzer.md
│   ├── tool-evaluator.md
│   └── workflow-optimizer.md
├── test/
│   └── joker.md
└── studio-coach.md

📋 Complete Agent List

🏆 Studio Leadership

• studio-coach - Elite performance coach and motivation leader for all agents

Engineering Department (engineering/)

• ai-engineer - Integrate AI/ML features that actually ship
• backend-architect - Design scalable APIs and server systems
• devops-automator - Deploy continuously without breaking things
• frontend-developer - Build blazing-fast user interfaces
• mobile-app-builder - Create native iOS/Android experiences
• rapid-prototyper - Build MVPs in days, not weeks
• test-writer-fixer - Write tests that catch real bugs

Product Department (product/)

• feedback-synthesizer - Transform complaints into features
• sprint-prioritizer - Ship maximum value in 6 weeks
• trend-researcher - Identify viral opportunities

Marketing Department (marketing/)

• app-store-optimizer - Dominate app store search results
• content-creator - Generate content across all platforms
• growth-hacker - Find and exploit viral growth loops
• instagram-curator - Master the visual content game
• reddit-community-builder - Win Reddit without being banned
• tiktok-strategist - Create shareable marketing moments
• twitter-engager - Ride trends to viral engagement

Design Department (design/)

• brand-guardian - Keep visual identity consistent everywhere
• ui-designer - Design interfaces developers can actually build
• ux-researcher - Turn user insights into product improvements
• visual-storyteller - Create visuals that convert and share
• whimsy-injector - Add delight to every interaction

Project Management (project-management/)

• experiment-tracker - Data-driven feature validation
• project-shipper - Launch products that don't crash
• studio-producer - Keep teams shipping, not meeting

Studio Operations (studio-operations/)

• analytics-reporter - Turn data into actionable insights
• finance-tracker - Keep the studio profitable
• infrastructure-maintainer - Scale without breaking the bank
• legal-compliance-checker - Stay legal while moving fast
• support-responder - Turn angry users into advocates

Testing & Benchmarking (testing/)

• api-tester - Ensure APIs work under pressure
• performance-benchmarker - Make everything faster
• test-results-analyzer - Find patterns in test failures
• tool-evaluator - Choose tools that actually help
• workflow-optimizer - Eliminate workflow bottlenecks

Core & Special Agents

• studio-coach - Rally the AI troops to excellence
• joker - Lighten the mood with tech humor

🎯 Proactive Agents

Some agents trigger automatically in specific contexts:

• studio-coach - When complex multi-agent tasks begin or agents need guidance
• test-writer-fixer - After implementing features, fixing bugs, or modifying code
• whimsy-injector - After UI/UX changes
• experiment-tracker - When feature flags are added

💡 Best Practices

1. Let agents work together - Many tasks benefit from multiple agents
2. Be specific - Clear task descriptions help agents perform better
3. Trust the expertise - Agents are designed for their specific domains
4. Iterate quickly - Agents support the 6-week sprint philosophy

🔧 Technical Details

Agent Structure

Each agent includes:

• name: Unique identifier
• description: When to use the agent with examples
• color: Visual identification
• tools: Specific tools the agent can access
• System prompt: Detailed expertise and instructions

Adding New Agents

1. Create a new .md file in the appropriate department folder
2. Follow the existing format with YAML frontmatter
3. Include 3-4 detailed usage examples
4. Write comprehensive system prompt (500+ words)
5. Test the agent with real tasks

📊 Agent Performance

Track agent effectiveness through:

• Task completion time
• User satisfaction
• Error rates
• Feature adoption
• Development velocity

🚦 Status

• ✅ Active: Fully functional and tested
• 🚧 Coming Soon: In development
• 🧪 Beta: Testing with limited functionality

🤝 Contributing

To improve existing agents or suggest new ones:

1. Identify gaps in current capabilities
2. Document specific use cases
3. Draft agent specification
4. Test with real studio projects
5. Submit improvements

Remember: The goal is to accelerate development, not add complexity. Every agent should make the 6-week sprint more achievable.