# jeetpatel92/cold-email-agent-system architecture

> Architecture diagram of the GitHub repository jeetpatel92/cold-email-agent-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeetpatel92/cold-email-agent-system
- Repository: https://github.com/jeetpatel92/cold-email-agent-system

## Overview

Cold Outreach Agent System is a Claude Code skill-orchestrated service for running B2B cold-email campaigns. Its principal workflow moves from client/ICP intake through lead sourcing, qualification, personalization and copy QA to draft campaign upload, deliverability monitoring, and iterative improvement. Claude Code’s Task tool provides parallel personalization agents; scripts integrate with sourcing, enrichment, sending, and domain services, while intermediate state is stored in files rather than a database. The README documents the overall flow; unsampled skill and script internals are represented only where the tree supports them.

Main entry points: [`skills/campaign-strategy/SKILL.md`](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/campaign-strategy/SKILL.md) (Campaign Strategy), [`skills/cold-email-kickoff/SKILL.md`](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-kickoff/SKILL.md) (Client Intake), [`skills`](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills) (Lead Sourcing), [`skills/smartlead-api/SKILL.md`](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-api/SKILL.md) (Campaign Sending)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Intake And Strategy"]
  node_intake["Client Intake<br/>[SKILL.md]"]
  node_icp["ICP Onboarding<br/>[SKILL.md]"]
  node_strategy["Campaign Strategy<br/>[SKILL.md]"]
  node_magnet["Lead Magnet Ideation<br/>[SKILL.md]"]
end

subgraph group_leads["Lead Operations"]
  node_sourcing["Lead Sourcing"]
  node_prospeo["Prospeo Export"]
  node_research["Research Pipeline"]
  node_contact["Contact Lookup<br/>[find-contacts.ts]"]
  node_fitprompt["ICP Fit Scoring<br/>[SKILL.md]"]
  node_quality["List Quality Scoring<br/>[score-list.ts]"]
end

subgraph group_campaign["Campaign Preparation"]
  node_personalize["Lead Personalization<br/>[SKILL.md]"]
  node_enrichment["Lead Enrichment"]
  node_copy["Campaign Copy<br/>[SKILL.md]"]
  node_spamcheck["Spam Guardrail<br/>[SKILL.md]"]
  node_upload["Draft Campaign Upload<br/>[upload.ts]"]
end

subgraph group_operations["Sending Operations"]
  node_infra["Domain Provisioning"]
  node_inboxes["Inbox Management"]
  node_inboxlib["Inbox API Utilities<br/>[_lib.ts]"]
  node_send["Campaign Sending<br/>[SKILL.md]"]
end

subgraph group_feedback["Monitoring And Iteration"]
  node_deliverability["Deliverability Checks"]
  node_incident["Incident Response<br/>[SKILL.md]"]
  node_experiments["Experiment Design<br/>[SKILL.md]"]
  node_replies["Reply Scoring"]
  node_weekly["Weekly Operating Rhythm<br/>[SKILL.md]"]
end

node_operator(("Campaign Operator"))
node_claude(("Claude Code"))
node_files["JSON And YAML Files"]

node_operator -->|"runs workflow"| node_claude
node_claude -->|"invokes skills"| node_intake
node_intake -->|"chains intake"| node_icp
node_intake -->|"chains intake"| node_strategy
node_intake -->|"chains intake"| node_magnet
node_icp -->|"defines targeting"| node_strategy
node_strategy -->|"informs ideation"| node_magnet
node_magnet -->|"guides sourcing"| node_sourcing
node_sourcing -->|"includes search"| node_prospeo
node_sourcing -->|"includes discovery"| node_research
node_sourcing -->|"includes lookup"| node_contact
node_prospeo -->|"provides leads"| node_fitprompt
node_research -->|"provides leads"| node_fitprompt
node_contact -->|"provides leads"| node_fitprompt
node_fitprompt -->|"scores list"| node_quality
node_quality -->|"passes qualified list"| node_personalize
node_claude -->|"fans out agents"| node_personalize
node_personalize -->|"produces variants"| node_copy
node_enrichment -.->|"adds lead context"| node_personalize
node_copy -->|"checks copy"| node_spamcheck
node_spamcheck -->|"guards upload"| node_upload
node_upload -->|"uploads draft"| node_send
node_operator -->|"starts campaign"| node_send
node_infra -.->|"provisions pool"| node_inboxes
node_inboxes -->|"uses utilities"| node_inboxlib
node_send -->|"monitors sending"| node_deliverability
node_deliverability -->|"handles problems"| node_incident
node_deliverability -->|"informs iteration"| node_experiments
node_send -->|"fetches replies"| node_replies
node_experiments -->|"feeds learning"| node_strategy
node_replies -->|"feeds learning"| node_strategy
node_weekly -->|"maintains cadence"| node_deliverability
node_claude -->|"passes state"| node_files

click node_intake "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-kickoff/SKILL.md"
click node_icp "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/icp-onboarding/SKILL.md"
click node_strategy "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/campaign-strategy/SKILL.md"
click node_magnet "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/lead-magnet-brainstorm/SKILL.md"
click node_sourcing "https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills"
click node_prospeo "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-starter-kit/scripts/prospeo-full-export.ts"
click node_research "https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/auto-research-public/scripts"
click node_contact "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/blitz-list-builder/scripts/find-contacts.ts"
click node_fitprompt "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/icp-prompt-builder/SKILL.md"
click node_quality "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/list-quality-scorecard/scripts/score-list.ts"
click node_personalize "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/personalization-subagent-pattern/SKILL.md"
click node_enrichment "https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/cold-email-starter-kit/scripts/enrichments"
click node_copy "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/campaign-copywriting/SKILL.md"
click node_spamcheck "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/spam-word-checker/SKILL.md"
click node_upload "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-campaign-upload-public/scripts/upload.ts"
click node_infra "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-starter-kit/scripts/zapmail-full-setup.ts"
click node_inboxes "https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/smartlead-inbox-manager/scripts"
click node_inboxlib "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-inbox-manager/scripts/_lib.ts"
click node_send "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-api/SKILL.md"
click node_deliverability "https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/email-deliverability-audit/scripts"
click node_incident "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/deliverability-incident-response/SKILL.md"
click node_experiments "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/experiment-design/SKILL.md"
click node_replies "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/positive-reply-scoring/scripts/aggregate-scores.ts"
click node_weekly "https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-weekly-rhythm/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_intake,node_icp,node_strategy,node_magnet toneBlue
class node_sourcing,node_prospeo,node_research,node_contact,node_fitprompt,node_quality toneAmber
class node_personalize,node_enrichment,node_copy,node_spamcheck,node_upload toneMint
class node_infra,node_inboxes,node_inboxlib,node_send toneRose
class node_deliverability,node_incident,node_experiments,node_replies,node_weekly,node_operator,node_claude,node_files toneIndigo
```

## Components

### Intake And Strategy

- [Client Intake](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-kickoff/SKILL.md): `skills/cold-email-kickoff/SKILL.md`
- [ICP Onboarding](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/icp-onboarding/SKILL.md): `skills/icp-onboarding/SKILL.md`
- [Campaign Strategy](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/campaign-strategy/SKILL.md): `skills/campaign-strategy/SKILL.md`
- [Lead Magnet Ideation](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/lead-magnet-brainstorm/SKILL.md): `skills/lead-magnet-brainstorm/SKILL.md`

### Lead Operations

- [Lead Sourcing](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills): `skills`
- [Prospeo Export](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-starter-kit/scripts/prospeo-full-export.ts): `skills/cold-email-starter-kit/scripts/prospeo-full-export.ts`
- [Research Pipeline](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/auto-research-public/scripts): `skills/auto-research-public/scripts`
- [Contact Lookup](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/blitz-list-builder/scripts/find-contacts.ts): `skills/blitz-list-builder/scripts/find-contacts.ts`
- [ICP Fit Scoring](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/icp-prompt-builder/SKILL.md): `skills/icp-prompt-builder/SKILL.md`
- [List Quality Scoring](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/list-quality-scorecard/scripts/score-list.ts): `skills/list-quality-scorecard/scripts/score-list.ts`

### Campaign Preparation

- [Lead Personalization](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/personalization-subagent-pattern/SKILL.md): `skills/personalization-subagent-pattern/SKILL.md`
- [Lead Enrichment](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/cold-email-starter-kit/scripts/enrichments): `skills/cold-email-starter-kit/scripts/enrichments`
- [Campaign Copy](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/campaign-copywriting/SKILL.md): `skills/campaign-copywriting/SKILL.md`
- [Spam Guardrail](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/spam-word-checker/SKILL.md): `skills/spam-word-checker/SKILL.md`
- [Draft Campaign Upload](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-campaign-upload-public/scripts/upload.ts): `skills/smartlead-campaign-upload-public/scripts/upload.ts`

### Sending Operations

- [Domain Provisioning](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-starter-kit/scripts/zapmail-full-setup.ts): `skills/cold-email-starter-kit/scripts/zapmail-full-setup.ts`
- [Inbox Management](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/smartlead-inbox-manager/scripts): `skills/smartlead-inbox-manager/scripts`
- [Inbox API Utilities](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-inbox-manager/scripts/_lib.ts): `skills/smartlead-inbox-manager/scripts/_lib.ts`
- [Campaign Sending](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/smartlead-api/SKILL.md): `skills/smartlead-api/SKILL.md`

### Monitoring And Iteration

- [Deliverability Checks](https://github.com/jeetpatel92/cold-email-agent-system/tree/main/skills/email-deliverability-audit/scripts): `skills/email-deliverability-audit/scripts`
- [Incident Response](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/deliverability-incident-response/SKILL.md): `skills/deliverability-incident-response/SKILL.md`
- [Experiment Design](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/experiment-design/SKILL.md): `skills/experiment-design/SKILL.md`
- [Reply Scoring](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/positive-reply-scoring/scripts/aggregate-scores.ts): `skills/positive-reply-scoring/scripts/aggregate-scores.ts`
- [Weekly Operating Rhythm](https://github.com/jeetpatel92/cold-email-agent-system/blob/main/skills/cold-email-weekly-rhythm/SKILL.md): `skills/cold-email-weekly-rhythm/SKILL.md`

### Other components

- **Campaign Operator**
- **Claude Code**
- **JSON And YAML Files**

## Connections

- Campaign Operator → Claude Code: runs workflow (evidence: `README.md`)
- Claude Code → Client Intake: invokes skills (evidence: `README.md`)
- Client Intake → ICP Onboarding: chains intake (evidence: `README.md`)
- Client Intake → Campaign Strategy: chains intake (evidence: `README.md`)
- Client Intake → Lead Magnet Ideation: chains intake (evidence: `README.md`)
- ICP Onboarding → Campaign Strategy: defines targeting (evidence: `README.md`)
- Campaign Strategy → Lead Magnet Ideation: informs ideation (evidence: `README.md`)
- Lead Magnet Ideation → Lead Sourcing: guides sourcing (evidence: `README.md`)
- Lead Sourcing → Prospeo Export: includes search (evidence: `README.md`)
- Lead Sourcing → Research Pipeline: includes discovery (evidence: `README.md`)
- Lead Sourcing → Contact Lookup: includes lookup (evidence: `README.md`)
- Prospeo Export → ICP Fit Scoring: provides leads (evidence: `README.md`)
- Research Pipeline → ICP Fit Scoring: provides leads (evidence: `README.md`)
- Contact Lookup → ICP Fit Scoring: provides leads (evidence: `README.md`)
- ICP Fit Scoring → List Quality Scoring: scores list (evidence: `README.md`)
- List Quality Scoring → Lead Personalization: passes qualified list (evidence: `README.md`)
- Claude Code → Lead Personalization: fans out agents (evidence: `README.md`)
- Lead Personalization → Campaign Copy: produces variants (evidence: `README.md`)
- Lead Enrichment → Lead Personalization: adds lead context
- Campaign Copy → Spam Guardrail: checks copy (evidence: `README.md`)
- Spam Guardrail → Draft Campaign Upload: guards upload (evidence: `README.md`)
- Draft Campaign Upload → Campaign Sending: uploads draft (evidence: `README.md`)
- Campaign Operator → Campaign Sending: starts campaign (evidence: `README.md`)
- Domain Provisioning → Inbox Management: provisions pool
- Inbox Management → Inbox API Utilities: uses utilities (evidence: `skills/smartlead-inbox-manager/scripts/list-health.ts`)
- Campaign Sending → Deliverability Checks: monitors sending (evidence: `README.md`)
- Deliverability Checks → Incident Response: handles problems (evidence: `README.md`)
- Deliverability Checks → Experiment Design: informs iteration (evidence: `README.md`)
- Campaign Sending → Reply Scoring: fetches replies (evidence: `README.md`)
- Experiment Design → Campaign Strategy: feeds learning (evidence: `README.md`)
- Reply Scoring → Campaign Strategy: feeds learning (evidence: `README.md`)
- Weekly Operating Rhythm → Deliverability Checks: maintains cadence (evidence: `README.md`)
- Claude Code → JSON And YAML Files: passes state (evidence: `README.md`)
