# The 9-Agent AI Outreach System

Everything from the video, in one place: the story, the full technical breakdown, a step-by-step build guide, the actual cold-email formula, and the 9 n8n workflow files themselves, ready to import.

**Start here based on what you want:**

| I want to... | Read this |
|---|---|
| Understand why this exists and what it does, in plain terms | [ARTICLE.md](ARTICLE.md) |
| Understand exactly how each of the 9 agents works, and why | [documentation.md](documentation.md) |
| Actually build my own copy, step by step | [BUILD-YOUR-OWN.md](BUILD-YOUR-OWN.md) |
| See the exact cold-email formula and structure | [EMAIL-FORMULA.md](EMAIL-FORMULA.md) |
| Get the workflow files to import into my own n8n | [workflows/](workflows/) |

---

## The 9 agents, at a glance

| # | Agent | Job |
|---|---|---|
| 1 | Prospect Hunter | Finds companies matching your ideal customer profile |
| 2 | Contact Enrichment | Finds the decision-maker and a verified email |
| 3 | Email Writer | Drafts a personalized email and quality-gates its own output |
| 4 | Digest & Sender | Your one-click approval inbox, nothing sends without you |
| 5 | Reply Tracker | Detects replies and stops follow-ups instantly |
| 6 | Bounce Handler | Finds and verifies a working alternate contact on bounce |
| 7 | Follow-up Sequencer | Threaded, scheduled follow-ups (day 3 / 7 / 14) |
| 8 | Focused Leads | A dedicated track for people who actually replied |
| 9 | API Key Manager | Self-service key refill, keeps the system running with zero downtime |

---

## Before you import anything

Every file in [`workflows/`](workflows/) has had all credentials, API keys, and personal identifying information stripped out. On import into n8n, you'll need to:
1. Connect your own Supabase, Gmail, and LLM provider credentials to each node.
2. Drop in your own Tavily and AbstractAPI keys.
3. Rename the webhook paths to something unique to your n8n instance.
4. Rewrite the prompts for your own niche and value proposition.

[BUILD-YOUR-OWN.md](BUILD-YOUR-OWN.md) walks through all of this in order, including the full database schema you'll need in Supabase.

---

## Questions

If something in here is unclear, or you'd rather have this built for you than build it yourself, reach out, details are in [ARTICLE.md](ARTICLE.md).
