### Example Agent Invocations

Source: https://github.com/contains-studio/agents/blob/main/README.md

These examples show how to trigger specific agents by describing your task or mentioning the agent's name. The appropriate agent will be automatically invoked.

```text
"Create a new app for tracking meditation habits" → `rapid-prototyper`
```

```text
"What's trending on TikTok that we could build?" → `trend-researcher`
```

```text
"Our app reviews are dropping, what's wrong?" → `feedback-synthesizer`
```

```text
"Make this loading screen more fun" → `whimsy-injector`
```

--------------------------------

### Illustration Style Guide - Character and Scene

Source: https://github.com/contains-studio/agents/blob/main/design/visual-storyteller.md

Outlines principles for character design and scene composition in illustrations, focusing on proportions, expressiveness, diversity, and spatial arrangement.

```text
Character Design:
- Proportions: 1:6 head-to-body ratio
- Features: Simplified but expressive
- Diversity: Inclusive representation
- Poses: Dynamic and contextual

Scene Composition:
- Foreground: Main action/character
- Midground: Supporting elements
- Background: Context/environment
- Depth: Use overlap and scale
```

--------------------------------

### Sample Workflow Analysis Template

Source: https://github.com/contains-studio/agents/blob/main/testing/workflow-optimizer.md

A markdown template for analyzing and documenting current and optimized workflows, including bottlenecks, applied optimizations, and human-AI task division.

```markdown
## Workflow: [Name]
**Current Time**: X hours/iteration
**Optimized Time**: Y hours/iteration
**Savings**: Z%

### Bottlenecks Identified
1. [Step] - X minutes (Y% of total)
2. [Step] - X minutes (Y% of total)

### Optimizations Applied
1. [Automation] - Saves X minutes
2. [Tool integration] - Saves Y minutes
3. [Process change] - Saves Z minutes

### Human-AI Task Division
**AI Handles**:
- [List of AI-suitable tasks]

**Human Handles**:
- [List of human-required tasks]

### Implementation Steps
1. [Specific action with owner]
2. [Specific action with owner]
```

--------------------------------

### Quick Performance Checks using Bash

Source: https://github.com/contains-studio/agents/blob/main/testing/performance-benchmarker.md

Command-line tools for quick performance checks. Includes page speed test, memory usage, database slow query log, bundle size, and network waterfall analysis.

```bash
# Quick page speed test
curl -o /dev/null -s -w "Time: %{time_total}s\n" https://example.com
```

```bash
# Memory usage snapshot
ps aux | grep node | awk '{print $6}'
```

```bash
# Database slow query log
tail -f /var/log/mysql/slow.log
```

```bash
# Bundle size check
du -sh dist/*.js | sort -h
```

```bash
# Network waterfall
har-analyzer network.har --threshold 500
```

--------------------------------

### Launch Brief Markdown Template

Source: https://github.com/contains-studio/agents/blob/main/project-management/project-shipper.md

Use this markdown template to create a concise launch brief. Fill in the bracketed placeholders with specific details about the feature, launch date, target audience, key message, success metrics, rollout plan, and risk mitigation strategies.

```markdown
## Launch Brief: [Feature Name]
**Launch Date**: [Date/Time with timezone]
**Target Audience**: [Primary user segment]
**Key Message**: [One-line positioning]
**Success Metrics**: [Primary KPIs]
**Rollout Plan**: [Deployment strategy]
**Risk Mitigation**: [Contingency plans]
```

--------------------------------

### Quick Workflow Tests

Source: https://github.com/contains-studio/agents/blob/main/testing/workflow-optimizer.md

Bash commands to quickly measure current workflow time, count manual steps, find automation opportunities, and measure wait times.

```bash
# Measure current workflow time
time ./current-workflow.sh
```

```bash
# Count manual steps
grep -c "manual" workflow-log.txt
```

```bash
# Find automation opportunities
grep -E "(copy|paste|repeat|again)" workflow-log.txt
```

```bash
# Measure wait times
awk '/waiting/ {sum += $2} END {print sum}' timing-log.txt
```

--------------------------------

### User Interview Framework

Source: https://github.com/contains-studio/agents/blob/main/design/ux-researcher.md

A structured approach for conducting user interviews, covering rapport building, context gathering, task observation, reflection, and wrap-up.

```text
1. Warm-up (2 min)
   - Build rapport
   - Set expectations
   
2. Context (5 min)
   - Understand their situation
   - Learn about alternatives
   
3. Tasks (15 min)
   - Observe actual usage
   - Note pain points
   
4. Reflection (5 min)
   - Gather feelings
   - Uncover desires
   
5. Wrap-up (3 min)
   - Final thoughts
   - Next steps
```

--------------------------------

### Performance Budget Template

Source: https://github.com/contains-studio/agents/blob/main/testing/performance-benchmarker.md

A markdown template for defining performance budgets for page load and runtime metrics. Includes monitoring alerts.

```markdown
## Performance Budget: [App Name]

### Page Load Budget
- HTML: <15KB
- CSS: <50KB
- JavaScript: <200KB
- Images: <500KB
- Total: <1MB

### Runtime Budget
- LCP: <2.5s
- TTI: <3.5s
- FID: <100ms
- API calls: <3 per page

### Monitoring
- Alert if LCP >3s
- Alert if error rate >1%
- Alert if API p95 >500ms
```

--------------------------------

### Clone Agents Repository

Source: https://github.com/contains-studio/agents/blob/main/README.md

Use this command to download the Contains Studio AI Agents repository to your local machine.

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

--------------------------------

### Benchmarking Report Template

Source: https://github.com/contains-studio/agents/blob/main/testing/performance-benchmarker.md

A markdown template for generating performance benchmark reports. Includes sections for executive summary, key metrics, bottlenecks, and recommendations.

```markdown
## Performance Benchmark: [App Name]
**Date**: [Date]
**Environment**: [Production/Staging]

### Executive Summary
- Current Performance: [Grade]
- Critical Issues: [Count]
- Potential Improvement: [X%]

### Key Metrics
| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| LCP | Xs | <2.5s | ❌ |
| FID | Xms | <100ms | ✅ |
| CLS | X | <0.1 | ⚠️ |

### Top Bottlenecks
1. [Issue] - Impact: Xs - Fix: [Solution]
2. [Issue] - Impact: Xs - Fix: [Solution]

### Recommendations
#### Immediate (This Sprint)
1. [Specific fix with expected impact]

#### Next Sprint
1. [Larger optimization with ROI]

#### Future Consideration
1. [Architectural change with analysis]
```

--------------------------------

### Experiment Documentation Template

Source: https://github.com/contains-studio/agents/blob/main/project-management/experiment-tracker.md

A markdown template for documenting experiment details, including hypothesis, success metrics, duration, results, learnings, and decision.

```markdown
## Experiment: [Name]
**Hypothesis**: We believe [change] will cause [impact] because [reasoning]
**Success Metrics**: [Primary KPI] increase by [X]%
**Duration**: [Start date] to [End date]
**Results**: [Win/Loss/Inconclusive]
**Learnings**: [Key insights for future]
**Decision**: [Ship/Kill/Iterate]
```

--------------------------------

### Agent File Structure Template

Source: https://github.com/contains-studio/agents/blob/main/README.md

A template for the agent's markdown file, including YAML frontmatter and the system prompt structure. Customize fields like name, description, color, and tools to define agent behavior and capabilities.

```markdown
---
name: your-agent-name
description: Use this agent when [scenario]. This agent specializes in [expertise]. Examples:

<example>
Context: [situation]
user: "[user request]"
assistant: "[response approach]"
<commentary>
[why this example matters]
</commentary>
</example>

[3 more examples...]
color: agent-color
tools: Tool1, Tool2, Tool3
---

You are a [role] who [primary function]. Your expertise spans [domains]. You understand that in 6-day sprints, [sprint constraint], so you [approach].

Your primary responsibilities:
1. [Responsibility 1]
2. [Responsibility 2]
...

[Detailed system prompt content...]

Your goal is to [ultimate objective]. You [key behavior traits]. Remember: [key philosophy for 6-day sprints].

```

--------------------------------

### Quick Load Test with Curl

Source: https://github.com/contains-studio/agents/blob/main/testing/api-tester.md

Perform a quick load test by sending multiple concurrent requests to an API endpoint using curl and measuring HTTP status code and total time.

```bash
# Quick load test with curl
for i in {1..1000}; do curl -s -o /dev/null -w "%{http_code} %{time_total}\n" https://api.example.com/endpoint & done
```

--------------------------------

### Brand Implementation Tokens (JavaScript)

Source: https://github.com/contains-studio/agents/blob/main/design/brand-guardian.md

Provides JavaScript constants for design tokens including colors, typography, spacing, radius, and shadows. Essential for developers integrating brand elements into applications.

```javascript
// Design tokens for developers
export const brand = {
  colors: {
    primary: 'var(--brand-primary)',
    secondary: 'var(--brand-secondary)',
    // ... full palette
  },
  typography: {
    fontFamily: 'var(--font-brand)',
    scale: { /* size tokens */ }
  },
  spacing: {
    unit: 4, // Base unit in px
    scale: [0, 4, 8, 12, 16, 24, 32, 48, 64]
  },
  radius: {
    small: '4px',
    medium: '8px',
    large: '16px',
    full: '9999px'
  },
  shadows: {
    small: '0 1px 3px rgba(0,0,0,0.12)',
    medium: '0 4px 6px rgba(0,0,0,0.16)',
    large: '0 10px 20px rgba(0,0,0,0.20)'
  }
}
```

--------------------------------

### ApacheBench (ab) Performance Test

Source: https://github.com/contains-studio/agents/blob/main/testing/api-tester.md

Conduct a performance test using ApacheBench (ab) to send a specified number of requests with a certain concurrency level to an API endpoint.

```bash
# Performance profiling
ab -n 1000 -c 100 https://api.example.com/endpoint
```

--------------------------------

### Infographic Layout Patterns

Source: https://github.com/contains-studio/agents/blob/main/design/visual-storyteller.md

Illustrates common layout patterns for infographics, including Timeline, Comparison, Process Flow, and Statistical Story formats.

```text
Timeline Layout:
[Start] → [Event 1] → [Event 2] → [End]

Comparison Layout:
| Option A | vs | Option B |
|   Pros   |    |   Pros   |
|   Cons   |    |   Cons   |

Process Flow:
Input → [Process] → Output
  ↓        ↓         ↓
Detail   Detail    Detail

Statistical Story:
Big Number
Supporting stat 1 | stat 2 | stat 3
Context and interpretation
```

--------------------------------

### k6 Smoke Test

Source: https://github.com/contains-studio/agents/blob/main/testing/api-tester.md

Execute a smoke test using k6 with a specified number of virtual users and duration.

```bash
# k6 smoke test
k6 run --vus 10 --duration 30s script.js
```

--------------------------------

### Asset Organization Structure

Source: https://github.com/contains-studio/agents/blob/main/design/brand-guardian.md

Illustrates a recommended directory structure for organizing brand assets, including logos, colors, typography, icons, illustrations, and photography.

```directory
/brand-assets
  /logos
    /svg
    /png
    /guidelines
  /colors
    /swatches
    /gradients
  /typography
    /fonts
    /specimens
  /icons
    /system
    /custom
  /illustrations
    /characters
    /patterns
  /photography
    /style-guide
    /examples
```

--------------------------------

### Team Sync Template

Source: https://github.com/contains-studio/agents/blob/main/project-management/studio-producer.md

A markdown template for structuring team synchronization meetings, detailing involved teams, dependencies, timelines, risks, success criteria, and communication plans.

```markdown
## Team Sync Template
**Teams Involved**: [List teams]
**Dependencies**: [Critical handoffs]
**Timeline**: [Key milestones]
**Risks**: [Coordination challenges]
**Success Criteria**: [Alignment metrics]
**Communication Plan**: [Sync schedule]
```

--------------------------------

### Directory Structure of Contains Studio Agents

Source: https://github.com/contains-studio/agents/blob/main/README.md

This tree view illustrates the organization of AI agents within the repository, categorized by department for easy navigation and discovery.

```tree
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
└── bonus/
    ├── joker.md
    └── studio-coach.md
```