Claude Code for PMs — Multi-Agent Workshop

Template repo for building multi-agent PM workflows with Claude Code.

Built for PMs who already use Claude Code, agents, and MCPs — and want to go deeper.

What's in here

agents/
  leaf/              — Single-MCP, single-job agent prompts
  orchestrators/     — Multi-agent coordinators (no direct MCP calls)
  README.md          — How to write agent prompts that work reliably

memory/
  MEMORY.md          — Session memory template
  README.md          — Memory patterns: session, semantic (Mem0), structured (Notion)

headless/
  run-agent.sh       — Run any agent from the command line
  daily-brief.sh     — Example scheduled workflow
  launchd/           — macOS LaunchAgent templates
  README.md          — Headless execution guide

scripts/
  setup-mcps.sh      — One-shot MCP server setup
  test-agent.sh      — Test agent prompts before wiring them in

docs/
  architecture.md    — 3-tier model: Dispatcher → Orchestrator → Leaf
  prompt-engineering.md — Advanced prompt patterns for agents
  patterns.md        — Fan-out, chaining, signals, memory, idempotency

Quick start

# 1. Fork and clone
git clone https://github.com/YOUR_USER/claude-code-pm-agents.git
cd claude-code-pm-agents

# 2. Set up your MCP servers
chmod +x scripts/setup-mcps.sh
# Edit scripts/setup-mcps.sh with your tokens, then run it

# 3. Customize CLAUDE.md
# Add your routing table, preferences, and key IDs

# 4. Customize memory/MEMORY.md
# Add your Slack channel IDs, Notion DB IDs, key people

# 5. Test a leaf agent
chmod +x scripts/test-agent.sh
./scripts/test-agent.sh agents/leaf/calendar-scanner.md

# 6. Run an orchestrator
./scripts/test-agent.sh agents/orchestrators/morning-brief.md

# 7. Go headless
chmod +x headless/run-agent.sh
./headless/run-agent.sh agents/orchestrators/morning-brief.md

The mental model

You (dispatcher) ──→ Orchestrator ──→ Leaf agents (parallel)
                                  ──→ Synthesize results
                                  ──→ Return to you

• Leaf agents do one thing with one tool. Reusable across orchestrators.
• Orchestrators compose leaf agents. They never touch MCP servers directly.
• You (the dispatcher) route tasks and relay results. You don't do the work.

Read docs/architecture.md for the full breakdown.

Workshop

This repo is the companion material for the "Claude Code for PMs" workshop. See the workshop guide for the session flow.

License

MIT