-->

⏱️ Expected Reading Time: 12 minutes

Introduction: Revolutionizing Development with AI Agents

The Contains Studio AI Agents repository represents a paradigm shift in how development teams approach rapid prototyping and product creation. This comprehensive collection of 30+ specialized AI agents transforms the traditional development workflow by providing domain-specific expertise at every stage of the development lifecycle.

Unlike generic AI assistants, each agent in this system is meticulously crafted with deep domain knowledge, specific tools, and contextual understanding of rapid development principles. Whether you’re building a meditation tracking app, analyzing user feedback, or optimizing app store presence, there’s a specialized agent ready to accelerate your workflow.

Understanding the Agent Architecture

Core Philosophy: 6-Day Sprint Development

The entire agent system is built around the philosophy of 6-day sprints - the idea that you can build, test, and ship meaningful products in just six days. This isn’t about cutting corners; it’s about leveraging AI expertise to eliminate bottlenecks and focus on what matters most: delivering value to users.

Agent Specialization Model

Each agent follows a carefully designed structure:

---
name: agent-identifier
description: When to use + detailed examples
color: visual-identification
tools: specific-capabilities
---

The system prompt for each agent contains:

  • Domain Expertise: Deep knowledge in their specific area
  • Sprint Integration: Understanding of rapid development constraints
  • Best Practices: Proven methodologies and approaches
  • Success Metrics: Clear ways to measure effectiveness

Installation and Setup

Prerequisites

Before installing the agents, ensure you have:

  • Claude Code installed and configured
  • Access to the ~/.claude/agents/ directory
  • Git for cloning the repository

Step-by-Step Installation

  1. Clone the Repository 
    git clone https://github.com/contains-studio/agents.git
cd agents
  2. Copy Agents to Claude Directory ```bash

    Option 1: Copy all agents

    cp -r * ~/.claude/agents/

Option 2: Selective installation by department

cp -r engineering/ ~/.claude/agents/ cp -r design/ ~/.claude/agents/ cp -r marketing/ ~/.claude/agents/


3. **Restart Claude Code**
After copying the agents, restart Claude Code to load the new agents into the system.

4. **Verify Installation**
Test the installation by describing a task that should trigger an agent:

“Create a new app for tracking meditation habits”

This should automatically invoke the `rapid-prototyper` agent.

## Department-by-Department Agent Guide

### Engineering Department: Building at Lightning Speed

The engineering department contains seven specialized agents designed to handle every aspect of technical development:

#### **rapid-prototyper**: MVP Creation Expert
- **When to Use**: Building new applications, creating proof-of-concepts
- **Specialization**: Transforms ideas into working prototypes in hours
- **Example Usage**: "Build a habit tracking app with streak counters"

#### **frontend-developer**: UI Implementation Specialist
- **When to Use**: Creating user interfaces, implementing designs
- **Specialization**: Modern frameworks (React, Vue, Svelte), responsive design
- **Example Usage**: "Create a dashboard with real-time analytics charts"

#### **backend-architect**: Server-Side Systems Expert
- **When to Use**: API design, database architecture, server logic
- **Specialization**: Scalable architectures, microservices, database optimization
- **Example Usage**: "Design a REST API for a social media platform"

#### **mobile-app-builder**: Native Mobile Development
- **When to Use**: iOS/Android app development, cross-platform solutions
- **Specialization**: React Native, Flutter, native development
- **Example Usage**: "Build a location-based reminder app"

#### **ai-engineer**: Machine Learning Integration
- **When to Use**: Adding AI features, model integration, data processing
- **Specialization**: LLM integration, computer vision, recommendation systems
- **Example Usage**: "Add smart categorization to expense tracking"

#### **devops-automator**: Deployment and Infrastructure
- **When to Use**: CI/CD setup, deployment automation, infrastructure management
- **Specialization**: Docker, Kubernetes, cloud platforms, monitoring
- **Example Usage**: "Set up automated deployment for a Node.js app"

#### **test-writer-fixer**: Quality Assurance Specialist
- **When to Use**: Writing tests, debugging, code quality improvement
- **Specialization**: Unit testing, integration testing, debugging strategies
- **Example Usage**: "Write comprehensive tests for user authentication"

### Design Department: Creating Delightful Experiences

The design department focuses on user experience, visual consistency, and brand identity:

#### **ui-designer**: Interface Creation Expert
- **When to Use**: Designing new interfaces, component systems
- **Specialization**: Design systems, accessibility, modern UI patterns
- **Example Usage**: "Design a clean onboarding flow for a fitness app"

#### **ux-researcher**: User Experience Analyst
- **When to Use**: Understanding user behavior, improving usability
- **Specialization**: User research, usability testing, journey mapping
- **Example Usage**: "Analyze why users abandon the checkout process"

#### **visual-storyteller**: Brand Communication Specialist
- **When to Use**: Creating marketing visuals, brand assets
- **Specialization**: Visual narratives, infographics, brand consistency
- **Example Usage**: "Create visuals explaining our app's unique value"

#### **whimsy-injector**: Delight Enhancement Agent
- **When to Use**: Adding personality to interfaces, micro-interactions
- **Specialization**: Animations, easter eggs, personality injection
- **Example Usage**: "Add delightful animations to our loading screens"

#### **brand-guardian**: Consistency Enforcer
- **When to Use**: Maintaining brand consistency across platforms
- **Specialization**: Brand guidelines, style guides, visual consistency
- **Example Usage**: "Ensure our new feature matches brand guidelines"

### Marketing Department: Growth and Engagement

Seven specialized agents handle different aspects of marketing and growth:

#### **growth-hacker**: Viral Growth Strategist
- **When to Use**: Finding growth opportunities, viral mechanics
- **Specialization**: Growth loops, viral coefficients, user acquisition
- **Example Usage**: "Design a referral system for our meditation app"

#### **content-creator**: Multi-Platform Content Expert
- **When to Use**: Creating content across different platforms
- **Specialization**: Platform-specific content, engagement optimization
- **Example Usage**: "Create a content calendar for our app launch"

#### **app-store-optimizer**: ASO Specialist
- **When to Use**: Improving app store visibility and downloads
- **Specialization**: App Store Optimization, keyword research, conversion
- **Example Usage**: "Optimize our app store listing for better rankings"

#### **tiktok-strategist**: Short-Form Video Expert
- **When to Use**: TikTok marketing, viral video creation
- **Specialization**: TikTok trends, viral mechanics, short-form content
- **Example Usage**: "Create a TikTok strategy for our productivity app"

#### **instagram-curator**: Visual Content Specialist
- **When to Use**: Instagram marketing, visual content strategy
- **Specialization**: Instagram algorithms, visual storytelling, engagement
- **Example Usage**: "Plan an Instagram campaign for our app launch"

#### **twitter-engager**: Real-Time Engagement Expert
- **When to Use**: Twitter marketing, trend participation
- **Specialization**: Twitter trends, engagement strategies, community building
- **Example Usage**: "Create a Twitter strategy around productivity trends"

#### **reddit-community-builder**: Community Growth Specialist
- **When to Use**: Reddit marketing, community engagement
- **Specialization**: Reddit culture, community building, authentic engagement
- **Example Usage**: "Build a community around our developer tools"

### Product Department: Strategic Decision Making

Three agents handle product strategy and prioritization:

#### **trend-researcher**: Market Intelligence Expert
- **When to Use**: Identifying market opportunities, trend analysis
- **Specialization**: Market research, trend identification, opportunity analysis
- **Example Usage**: "What's trending that we could build an app around?"

#### **feedback-synthesizer**: User Insight Analyst
- **When to Use**: Analyzing user feedback, feature prioritization
- **Specialization**: Feedback analysis, sentiment analysis, feature extraction
- **Example Usage**: "Our app reviews are dropping, what's wrong?"

#### **sprint-prioritizer**: Feature Prioritization Expert
- **When to Use**: Planning sprints, prioritizing features
- **Specialization**: Feature prioritization, sprint planning, value assessment
- **Example Usage**: "Help prioritize features for our next 6-day sprint"

### Operations and Management

Additional departments handle project management, operations, and testing:

#### Project Management Agents
- **studio-producer**: Team coordination and shipping
- **project-shipper**: Launch management and quality assurance
- **experiment-tracker**: A/B testing and feature validation

#### Studio Operations Agents
- **analytics-reporter**: Data analysis and insights
- **finance-tracker**: Budget management and profitability
- **infrastructure-maintainer**: System scaling and maintenance
- **legal-compliance-checker**: Legal compliance and risk management
- **support-responder**: Customer support and user advocacy

#### Testing and Quality Agents
- **performance-benchmarker**: Performance optimization
- **api-tester**: API testing and reliability
- **test-results-analyzer**: Test failure pattern analysis
- **tool-evaluator**: Development tool assessment
- **workflow-optimizer**: Process improvement

## Advanced Usage Patterns

### Multi-Agent Collaboration

The real power of the system emerges when agents work together. Here are common collaboration patterns:

#### **Product Development Flow**
1. **trend-researcher** identifies market opportunity
2. **rapid-prototyper** builds initial MVP
3. **ui-designer** creates polished interface
4. **test-writer-fixer** ensures quality
5. **growth-hacker** designs viral mechanics

#### **Marketing Campaign Creation**
1. **content-creator** develops core messaging
2. **visual-storyteller** creates supporting visuals
3. **tiktok-strategist** adapts for TikTok
4. **instagram-curator** creates Instagram version
5. **twitter-engager** handles real-time engagement

#### **Feature Launch Process**
1. **feedback-synthesizer** analyzes user requests
2. **sprint-prioritizer** evaluates feature priority
3. **backend-architect** designs technical implementation
4. **frontend-developer** builds user interface
5. **app-store-optimizer** updates store listing

### Proactive Agent Triggers

Some agents activate automatically in specific contexts:

- **studio-coach**: Triggers during complex multi-agent tasks
- **test-writer-fixer**: Activates after code implementation
- **whimsy-injector**: Engages after UI/UX changes
- **experiment-tracker**: Monitors feature flag additions

## Customization and Extension

### Creating Custom Agents

To create agents tailored to your specific needs:

1. **Define Agent Purpose**
```yaml
---
name: your-custom-agent
description: Specific use case with detailed examples
color: brand-appropriate-color
tools: required-capabilities
---
  1. Write Comprehensive System Prompt
    • Agent identity and role (100+ words)
    • Core responsibilities (5-8 specific duties)
    • Domain expertise and technical skills
    • Integration with 6-day sprint methodology
    • Success metrics and evaluation criteria
  2. Include Detailed Examples Provide 3-4 examples showing:
    • Context and situation
    • User request
    • Expected agent response
    • Commentary on why the example matters

Department-Specific Customization

Engineering Customizations

  • Add specific technology stacks your team uses
  • Include company-specific coding standards
  • Integrate with your deployment pipeline
  • Customize testing frameworks and practices

Design Customizations

  • Incorporate your brand guidelines
  • Add specific design system components
  • Include accessibility requirements
  • Customize for your target user demographics

Marketing Customizations

  • Adapt to your target markets
  • Include brand voice and tone guidelines
  • Customize for your product categories
  • Add specific growth metrics and KPIs

Best Practices for Maximum Effectiveness

1. Clear Task Description

Instead of: “Make this better” Use: “Improve the onboarding flow to reduce drop-off at step 2”

2. Context Provision

Provide relevant context about:

  • Target audience
  • Technical constraints
  • Brand guidelines
  • Success metrics

3. Iterative Refinement

  • Start with broad requests
  • Refine based on initial results
  • Combine multiple agent perspectives
  • Test and validate recommendations

4. Trust Agent Expertise

  • Let agents work within their specializations
  • Don’t micromanage the process
  • Provide feedback for continuous improvement
  • Leverage cross-agent collaboration

Performance Monitoring and Optimization

Key Metrics to Track

Development Velocity

  • Time from idea to working prototype
  • Feature implementation speed
  • Bug resolution time
  • Deployment frequency

Quality Metrics

  • User satisfaction scores
  • Bug report frequency
  • Performance benchmarks
  • Code quality assessments

Business Impact

  • User acquisition rates
  • Engagement improvements
  • Revenue growth
  • Market position changes

Optimization Strategies

  1. Agent Performance Analysis
    • Track which agents provide the most value
    • Identify bottlenecks in multi-agent workflows
    • Optimize agent prompts based on results
  2. Workflow Refinement
    • Streamline common agent collaboration patterns
    • Create templates for frequent use cases
    • Automate routine agent invocations
  3. Custom Agent Development
    • Create agents for company-specific needs
    • Develop industry-specific expertise
    • Build integration with existing tools

Troubleshooting Common Issues

Agent Not Triggering

Problem: Agent doesn’t activate for expected tasks Solutions:

  • Use more specific task descriptions
  • Explicitly mention the agent name
  • Check if task matches agent’s examples
  • Verify agent installation in ~/.claude/agents/

Poor Agent Performance

Problem: Agent provides generic or unhelpful responses Solutions:

  • Provide more context about your specific situation
  • Include relevant constraints and requirements
  • Try breaking complex tasks into smaller parts
  • Combine multiple agents for comprehensive solutions

Integration Challenges

Problem: Agents don’t work well with existing workflows Solutions:

  • Customize agent prompts for your processes
  • Create bridging agents for specific integrations
  • Develop company-specific agent variants
  • Train team on effective agent collaboration

Future Developments and Roadmap

Emerging Capabilities

  • Enhanced Multi-Modal Support: Integration with image, video, and audio processing
  • Real-Time Collaboration: Live agent coordination during development sessions
  • Learning and Adaptation: Agents that improve based on team-specific usage patterns
  • Industry Specialization: Vertical-specific agent collections for healthcare, finance, etc.

Integration Opportunities

  • Development Tool Integration: Direct integration with IDEs, project management tools
  • Analytics and Reporting: Automated performance tracking and optimization suggestions
  • Team Collaboration: Enhanced multi-user agent sharing and coordination
  • Deployment Automation: Seamless integration with CI/CD pipelines

Conclusion: Transforming Development with AI Agents

The Contains Studio AI Agents system represents more than just a collection of helpful tools—it’s a complete reimagining of how development teams can work. By providing specialized expertise at every stage of the development lifecycle, these agents enable teams to:

  • Accelerate Development: Reduce time from idea to working product
  • Improve Quality: Leverage specialized knowledge for better outcomes
  • Scale Expertise: Access expert-level capabilities across all disciplines
  • Focus on Value: Spend time on strategic decisions rather than routine tasks

The 6-day sprint philosophy isn’t about rushing; it’s about eliminating friction and focusing on what matters most. With 30+ specialized agents at your disposal, you can build, test, and ship products that would have taken weeks or months using traditional approaches.

Whether you’re a solo developer building your first app or a team launching the next unicorn startup, the Contains Studio AI Agents system provides the expertise and acceleration you need to succeed in today’s fast-paced development landscape.

Start with the basic installation, experiment with different agents, and gradually build your own customized agent ecosystem. The future of rapid development is here—and it’s powered by specialized AI agents working in perfect harmony with human creativity and vision.

Ready to get started? Clone the repository, install the agents, and experience the future of rapid development today. Your next breakthrough product is just six days away.

참고