# zubair-trabzada/ai-sales-team-claude architecture

> Architecture diagram of the GitHub repository zubair-trabzada/ai-sales-team-claude, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zubair-trabzada/ai-sales-team-claude
- Repository: https://github.com/zubair-trabzada/ai-sales-team-claude

## Overview

This repository is a Claude Code sales-intelligence team: command skills guide research, qualification, outreach and pipeline reporting, with scripts for website analysis, contact discovery, BANT+MEDDIC scoring and PDF generation. The flagship workflow takes a prospect URL through discovery, five-agent parallel assessment and synthesis into a prospect analysis; follow-on skills reuse that analysis for sales work. Edges reflect README-documented routing and capabilities; source excerpts do not expose all skill-level wiring.

Main entry points: [`sales/SKILL.md`](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/sales/SKILL.md) (Sales orchestrator), [`skills/sales-prospect/SKILL.md`](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prospect/SKILL.md) (Prospect command), [`skills/sales-report-pdf/SKILL.md`](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-report-pdf/SKILL.md) (PDF reporting), [`scripts/generate_pdf_report.py`](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/generate_pdf_report.py) (PDF generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Prospect workflow"]
  node_orchestrator["Sales orchestrator<br/>[SKILL.md]"]
  node_prospect["Prospect command<br/>[SKILL.md]"]
  node_discovery["Website discovery"]
  node_contacts["Contact discovery<br/>[contact_finder.py]"]
  node_qualification["Lead scoring<br/>[lead_scorer.py]"]
  node_synthesis["Prospect synthesis<br/>[SKILL.md]"]
  node_analysis["Prospect analysis"]
end

subgraph group_agents["Analysis agents"]
  node_company_agent["Company research<br/>[sales-company.md]"]
  node_contacts_agent["Contact assessment<br/>[sales-contacts.md]"]
  node_opportunity_agent["Opportunity scoring"]
  node_competitive_agent["Competitive analysis"]
  node_strategy_agent["Outreach strategy<br/>[sales-strategy.md]"]
end

subgraph group_skills["Sales skills"]
  node_research_skill["Company research<br/>[SKILL.md]"]
  node_qualify_skill["Lead qualification<br/>[SKILL.md]"]
  node_contacts_skill["Decision makers<br/>[SKILL.md]"]
  node_competitors_skill["Competitors<br/>[SKILL.md]"]
  node_outreach_skill["Outreach sequences<br/>[SKILL.md]"]
  node_followup_skill["Follow-up<br/>[SKILL.md]"]
  node_prep_skill["Meeting preparation<br/>[SKILL.md]"]
  node_proposal_skill["Proposals<br/>[SKILL.md]"]
  node_objections_skill["Objection handling<br/>[SKILL.md]"]
  node_icp_skill["Ideal customer profile<br/>[SKILL.md]"]
  node_report_skill["Pipeline report<br/>[SKILL.md]"]
  node_pdf_skill["PDF reporting<br/>[SKILL.md]"]
end

subgraph group_runtime["Analysis scripts"]
  node_pdf_generator["PDF generator"]
  node_report_pdf["Pipeline PDF"]
end

node_user(("Sales user"))

node_user -->|"enters command"| node_orchestrator
node_orchestrator -->|"routes prospect"| node_prospect
node_orchestrator -->|"routes research"| node_research_skill
node_orchestrator -->|"routes qualification"| node_qualify_skill
node_orchestrator -->|"routes contacts"| node_contacts_skill
node_orchestrator -->|"routes competitors"| node_competitors_skill
node_orchestrator -->|"routes outreach"| node_outreach_skill
node_orchestrator -->|"routes follow-up"| node_followup_skill
node_orchestrator -->|"routes preparation"| node_prep_skill
node_orchestrator -->|"routes proposal"| node_proposal_skill
node_orchestrator -->|"routes objections"| node_objections_skill
node_orchestrator -->|"routes ICP"| node_icp_skill
node_orchestrator -->|"routes report"| node_report_skill
node_orchestrator -->|"routes PDF report"| node_pdf_skill
node_prospect -->|"runs discovery"| node_discovery
node_prospect -->|"runs analysis script"| node_contacts
node_prospect -->|"runs analysis script"| node_qualification
node_prospect -->|"launches parallel"| node_company_agent
node_prospect -->|"launches parallel"| node_contacts_agent
node_prospect -->|"launches parallel"| node_opportunity_agent
node_prospect -->|"launches parallel"| node_competitive_agent
node_prospect -->|"launches parallel"| node_strategy_agent
node_prospect -->|"synthesizes results"| node_synthesis
node_synthesis -->|"writes analysis"| node_analysis
node_analysis -->|"informs outreach"| node_outreach_skill
node_analysis -->|"informs preparation"| node_prep_skill
node_analysis -->|"informs proposal"| node_proposal_skill
node_pdf_skill -->|"generates report"| node_pdf_generator
node_pdf_generator -->|"produces PDF"| node_report_pdf

click node_orchestrator "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/sales/SKILL.md"
click node_prospect "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prospect/SKILL.md"
click node_discovery "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/analyze_prospect.py"
click node_contacts "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/contact_finder.py"
click node_qualification "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/lead_scorer.py"
click node_synthesis "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prospect/SKILL.md"
click node_company_agent "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-company.md"
click node_contacts_agent "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-contacts.md"
click node_opportunity_agent "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-opportunity.md"
click node_competitive_agent "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-competitive.md"
click node_strategy_agent "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-strategy.md"
click node_research_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-research/SKILL.md"
click node_qualify_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-qualify/SKILL.md"
click node_contacts_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-contacts/SKILL.md"
click node_competitors_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-competitors/SKILL.md"
click node_outreach_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-outreach/SKILL.md"
click node_followup_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-followup/SKILL.md"
click node_prep_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prep/SKILL.md"
click node_proposal_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-proposal/SKILL.md"
click node_objections_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-objections/SKILL.md"
click node_icp_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-icp/SKILL.md"
click node_report_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-report/SKILL.md"
click node_pdf_skill "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-report-pdf/SKILL.md"
click node_pdf_generator "https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/generate_pdf_report.py"

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_orchestrator,node_prospect,node_discovery,node_contacts,node_qualification,node_synthesis,node_analysis,node_user toneBlue
class node_company_agent,node_contacts_agent,node_opportunity_agent,node_competitive_agent,node_strategy_agent toneAmber
class node_research_skill,node_qualify_skill,node_contacts_skill,node_competitors_skill,node_outreach_skill,node_followup_skill,node_prep_skill,node_proposal_skill,node_objections_skill,node_icp_skill,node_report_skill,node_pdf_skill toneMint
class node_pdf_generator,node_report_pdf toneRose
```

## Components

### Prospect workflow

- [Sales orchestrator](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/sales/SKILL.md): `sales/SKILL.md`
- [Prospect command](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prospect/SKILL.md): `skills/sales-prospect/SKILL.md`
- [Website discovery](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/analyze_prospect.py): `scripts/analyze_prospect.py`
- [Contact discovery](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/contact_finder.py): `scripts/contact_finder.py`
- [Lead scoring](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/lead_scorer.py): `scripts/lead_scorer.py`
- [Prospect synthesis](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prospect/SKILL.md): `skills/sales-prospect/SKILL.md`
- **Prospect analysis**

### Analysis agents

- [Company research](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-company.md): `agents/sales-company.md`
- [Contact assessment](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-contacts.md): `agents/sales-contacts.md`
- [Opportunity scoring](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-opportunity.md): `agents/sales-opportunity.md`
- [Competitive analysis](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-competitive.md): `agents/sales-competitive.md`
- [Outreach strategy](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/agents/sales-strategy.md): `agents/sales-strategy.md`

### Sales skills

- [Company research](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-research/SKILL.md): `skills/sales-research/SKILL.md`
- [Lead qualification](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-qualify/SKILL.md): `skills/sales-qualify/SKILL.md`
- [Decision makers](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-contacts/SKILL.md): `skills/sales-contacts/SKILL.md`
- [Competitors](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-competitors/SKILL.md): `skills/sales-competitors/SKILL.md`
- [Outreach sequences](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-outreach/SKILL.md): `skills/sales-outreach/SKILL.md`
- [Follow-up](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-followup/SKILL.md): `skills/sales-followup/SKILL.md`
- [Meeting preparation](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-prep/SKILL.md): `skills/sales-prep/SKILL.md`
- [Proposals](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-proposal/SKILL.md): `skills/sales-proposal/SKILL.md`
- [Objection handling](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-objections/SKILL.md): `skills/sales-objections/SKILL.md`
- [Ideal customer profile](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-icp/SKILL.md): `skills/sales-icp/SKILL.md`
- [Pipeline report](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-report/SKILL.md): `skills/sales-report/SKILL.md`
- [PDF reporting](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/skills/sales-report-pdf/SKILL.md): `skills/sales-report-pdf/SKILL.md`

### Analysis scripts

- [PDF generator](https://github.com/zubair-trabzada/ai-sales-team-claude/blob/main/scripts/generate_pdf_report.py): `scripts/generate_pdf_report.py`
- **Pipeline PDF**

### Other components

- **Sales user**

## Connections

- Sales user → Sales orchestrator: enters command (evidence: `README.md`)
- Sales orchestrator → Prospect command: routes prospect (evidence: `README.md`)
- Sales orchestrator → Company research: routes research (evidence: `README.md`)
- Sales orchestrator → Lead qualification: routes qualification (evidence: `README.md`)
- Sales orchestrator → Decision makers: routes contacts (evidence: `README.md`)
- Sales orchestrator → Competitors: routes competitors (evidence: `README.md`)
- Sales orchestrator → Outreach sequences: routes outreach (evidence: `README.md`)
- Sales orchestrator → Follow-up: routes follow-up (evidence: `README.md`)
- Sales orchestrator → Meeting preparation: routes preparation (evidence: `README.md`)
- Sales orchestrator → Proposals: routes proposal (evidence: `README.md`)
- Sales orchestrator → Objection handling: routes objections (evidence: `README.md`)
- Sales orchestrator → Ideal customer profile: routes ICP (evidence: `README.md`)
- Sales orchestrator → Pipeline report: routes report (evidence: `README.md`)
- Sales orchestrator → PDF reporting: routes PDF report (evidence: `README.md`)
- Prospect command → Website discovery: runs discovery (evidence: `README.md`)
- Prospect command → Contact discovery: runs analysis script (evidence: `README.md`)
- Prospect command → Lead scoring: runs analysis script (evidence: `README.md`)
- Prospect command → Company research: launches parallel (evidence: `README.md`)
- Prospect command → Contact assessment: launches parallel (evidence: `README.md`)
- Prospect command → Opportunity scoring: launches parallel (evidence: `README.md`)
- Prospect command → Competitive analysis: launches parallel (evidence: `README.md`)
- Prospect command → Outreach strategy: launches parallel (evidence: `README.md`)
- Prospect command → Prospect synthesis: synthesizes results (evidence: `README.md`)
- Prospect synthesis → Prospect analysis: writes analysis (evidence: `README.md`)
- Prospect analysis → Outreach sequences: informs outreach (evidence: `README.md`)
- Prospect analysis → Meeting preparation: informs preparation (evidence: `README.md`)
- Prospect analysis → Proposals: informs proposal (evidence: `README.md`)
- PDF reporting → PDF generator: generates report (evidence: `README.md`)
- PDF generator → Pipeline PDF: produces PDF (evidence: `scripts/generate_pdf_report.py`)
