CLAUDE.md

Welcome to the 3 AI Amigos workspace - a complete toolkit for orchestrating AI-powered Product Managers, UX Designers, and Claude Code to build production systems.

🎯 What You're Looking At

This repository contains everything needed to implement the 3 AI Amigos methodology:

Agent configurations to create your AI team
Technical patterns that work for any domain
Complete example of a multi-agent health system
Setup guides to get you started

Want to implement 3 AI Amigos? Start here:

README.md - Your complete guide (start here!)
agents/ - Copy these configs to set up your AI agents
docs/po-document-checklist.md - Documents you'll need

Want to understand the patterns?

technical-guides/implementation-guide.md - How to build multi-agent systems
technical-guides/multi-agent-patterns.md - Orchestrator-worker architecture
docs/images/ai-amigos-diagram.png - Visual overview

Want to see a complete example?

use-cases/multi-agent-health-insight-system/ - Full health system implementation
- Includes brand guidelines based on the mockups
- Complete domain documentation
- Visual examples in the PDF

📁 Repository Structure

3-AMIGO-AGENTS/
│
├── 🤖 agents/                    # COPY THESE to configure your agents
│   ├── pm-agent/                 
│   │   ├── config/              # PM Agent instructions
│   │   └── example-prompts/     # What to say to PM
│   ├── ux-agent/                
│   │   ├── config/              # UX Agent instructions  
│   │   └── example-prompts/     # What to say to UX
│   └── code-agent/              
│       └── config/              # CLAUDE.md template for your workspace
│
├── 📚 technical-guides/          # REUSABLE patterns (domain-agnostic)
│   ├── implementation-guide.md   # Multi-agent implementation
│   ├── multi-agent-patterns.md   # Based on Anthropic's research
│   ├── multi-agent-implementation-architecture.md # Backend structure patterns
│   └── streaming-patterns.md     # Real-time updates
│
├── 🏥 use-cases/                 # EXAMPLE: Complete health system
│   └── multi-agent-health-insight-system/
│       ├── [domain documents]    # Templates for your own domains
│       └── health-user-stories.pdf # UI/UX examples
│
├── 📖 docs/                      # HOW-TO guides
│   ├── demo-setup-guide.md      # Run the demo
│   ├── po-document-checklist.md # What docs you need
│   └── images/                  # Diagrams and visuals
│
└── README.md                     # START HERE - Complete guide

💡 The Big Picture

The 3 AI Amigos transforms development by orchestrating:

Product Manager Agent → Creates requirements & architecture
UX Designer Agent → Designs interfaces & experiences
Claude Code → Implements the complete system

You provide domain expertise, they build the system.

🎯 Your Next Steps

Option 1: Build Something

Read README.md thoroughly
Set up your 3 AI agents using files in
```
agents/*/config/
```
Create domain documents (use health example as template)
Run through the 5-phase process
Get a working system!

Option 2: Explore First

Look at
```
docs/images/ai-amigos-diagram.png
```
Browse the health example in
```
use-cases/
```
Read technical guides to understand patterns
Then follow Option 1 when ready

🔑 Key Files You'll Need

To Configure Agents:

agents/pm-agent/config/pm-agent-instructions.md

agents/ux-agent/config/ux-designer-agent-instructions.md

agents/code-agent/config/minimal-claude-md-template.md

To Understand What to Submit:

agents/pm-agent/example/prompts/po-prompt-for-pm-agent.md

- Prompt + attached docs

agents/ux-agent/example/prompts/po-prompt-for-ux-agent.md

- Prompt + attached docs

To See What Documents You Need:

```
docs/po-document-checklist.md
```

use-cases/multi-agent-health-insight-system/

(examples)

📝 Important Notes

Domain-Agnostic vs Domain-Specific
- ```
agents/
```
  and
```
technical-guides/
```
  work for ANY domain
- ```
use-cases/
```
  shows specific examples
- Keep them separate!
The Process is Sequential
- PM Agent first → UX Agent second → Claude Code last
- Each builds on the previous outputs
You're the Product Owner
- You provide domain knowledge
- You guide the agents
- You validate outputs

🎉 Success Looks Like

✅ 3 AI agents configured in Claude Desktop
✅ Your domain requirements ready
✅ PM creates comprehensive specs
✅ UX creates beautiful designs
✅ Claude Code builds working system
✅ System runs successfully!

Ready? Open README.md and let's build something amazing with your new AI development team!

Remember: This isn't just about tools - it's about revolutionizing how we build software. 🚀

CLAUDE.md

Welcome to the 3 AI Amigos workspace - a complete toolkit for orchestrating AI-powered Product Managers, UX Designers, and Claude Code to build production systems.

🎯 What You're Looking At

This repository contains everything needed to implement the 3 AI Amigos methodology:

Agent configurations to create your AI team
Technical patterns that work for any domain
Complete example of a multi-agent health system
Setup guides to get you started

Want to implement 3 AI Amigos? Start here:

README.md - Your complete guide (start here!)
agents/ - Copy these configs to set up your AI agents
docs/po-document-checklist.md - Documents you'll need

Want to understand the patterns?

technical-guides/implementation-guide.md - How to build multi-agent systems
technical-guides/multi-agent-patterns.md - Orchestrator-worker architecture
docs/images/ai-amigos-diagram.png - Visual overview

Want to see a complete example?

use-cases/multi-agent-health-insight-system/ - Full health system implementation
- Includes brand guidelines based on the mockups
- Complete domain documentation
- Visual examples in the PDF

📁 Repository Structure

3-AMIGO-AGENTS/
│
├── 🤖 agents/                    # COPY THESE to configure your agents
│   ├── pm-agent/                 
│   │   ├── config/              # PM Agent instructions
│   │   └── example-prompts/     # What to say to PM
│   ├── ux-agent/                
│   │   ├── config/              # UX Agent instructions  
│   │   └── example-prompts/     # What to say to UX
│   └── code-agent/              
│       └── config/              # CLAUDE.md template for your workspace
│
├── 📚 technical-guides/          # REUSABLE patterns (domain-agnostic)
│   ├── implementation-guide.md   # Multi-agent implementation
│   ├── multi-agent-patterns.md   # Based on Anthropic's research
│   ├── multi-agent-implementation-architecture.md # Backend structure patterns
│   └── streaming-patterns.md     # Real-time updates
│
├── 🏥 use-cases/                 # EXAMPLE: Complete health system
│   └── multi-agent-health-insight-system/
│       ├── [domain documents]    # Templates for your own domains
│       └── health-user-stories.pdf # UI/UX examples
│
├── 📖 docs/                      # HOW-TO guides
│   ├── demo-setup-guide.md      # Run the demo
│   ├── po-document-checklist.md # What docs you need
│   └── images/                  # Diagrams and visuals
│
└── README.md                     # START HERE - Complete guide

💡 The Big Picture

The 3 AI Amigos transforms development by orchestrating:

Product Manager Agent → Creates requirements & architecture
UX Designer Agent → Designs interfaces & experiences
Claude Code → Implements the complete system

You provide domain expertise, they build the system.

🎯 Your Next Steps

Option 1: Build Something

Read README.md thoroughly
Set up your 3 AI agents using files in
```
agents/*/config/
```
Create domain documents (use health example as template)
Run through the 5-phase process
Get a working system!

Option 2: Explore First

Look at
```
docs/images/ai-amigos-diagram.png
```
Browse the health example in
```
use-cases/
```
Read technical guides to understand patterns
Then follow Option 1 when ready

🔑 Key Files You'll Need

To Configure Agents:

agents/pm-agent/config/pm-agent-instructions.md

agents/ux-agent/config/ux-designer-agent-instructions.md

agents/code-agent/config/minimal-claude-md-template.md

To Understand What to Submit:

agents/pm-agent/example/prompts/po-prompt-for-pm-agent.md

- Prompt + attached docs

agents/ux-agent/example/prompts/po-prompt-for-ux-agent.md

- Prompt + attached docs

To See What Documents You Need:

```
docs/po-document-checklist.md
```

use-cases/multi-agent-health-insight-system/

(examples)

📝 Important Notes

Domain-Agnostic vs Domain-Specific
- ```
agents/
```
  and
```
technical-guides/
```
  work for ANY domain
- ```
use-cases/
```
  shows specific examples
- Keep them separate!
The Process is Sequential
- PM Agent first → UX Agent second → Claude Code last
- Each builds on the previous outputs
You're the Product Owner
- You provide domain knowledge
- You guide the agents
- You validate outputs

🎉 Success Looks Like

✅ 3 AI agents configured in Claude Desktop
✅ Your domain requirements ready
✅ PM creates comprehensive specs
✅ UX creates beautiful designs
✅ Claude Code builds working system
✅ System runs successfully!

Ready? Open README.md and let's build something amazing with your new AI development team!

Remember: This isn't just about tools - it's about revolutionizing how we build software. 🚀

CLAUDE.md

CLAUDE.md

🎯 What You're Looking At

🚀 Quick Navigation

Want to implement 3 AI Amigos? Start here:

Want to understand the patterns?

Want to see a complete example?

📁 Repository Structure

💡 The Big Picture

🎯 Your Next Steps

Option 1: Build Something

Option 2: Explore First

🔑 Key Files You'll Need

To Configure Agents:

To Understand What to Submit:

To See What Documents You Need:

📝 Important Notes

🎉 Success Looks Like

Related Skills

Nano Banana Pro

Markdown Converter

1password

CLAUDE.md

🎯 What You're Looking At

🚀 Quick Navigation

Want to implement 3 AI Amigos? Start here:

Want to understand the patterns?

Want to see a complete example?

📁 Repository Structure

💡 The Big Picture

🎯 Your Next Steps

Option 1: Build Something

Option 2: Explore First

🔑 Key Files You'll Need

To Configure Agents:

To Understand What to Submit:

To See What Documents You Need:

📝 Important Notes

🎉 Success Looks Like