# carlopezzuto/recruiting architecture

> Architecture diagram of the GitHub repository carlopezzuto/recruiting, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/carlopezzuto/recruiting
- Repository: https://github.com/carlopezzuto/recruiting

## Overview

Recruiting Toolkit is a Claude Code–orchestrated recruiting workflow, not a standalone application: a user request activates specialized agents that create role-specific hiring deliverables across sourcing, interviewing, offers, and post-hire quality. The README documents the session as coordinator, automatic skill injection, and a sourcing-to-talent-partner pipeline handoff. Source excerpts were unavailable, so links reflect documented relationships only; specific agent-to-skill mappings are not shown.

Main entry points: [`.claude/agents/senior-sourcing-specialist.md`](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-sourcing-specialist.md) (Sourcing Specialist), [`.claude/agents/senior-talent-partner.md`](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-talent-partner.md) (Talent Partner), [`.claude/skills`](https://github.com/carlopezzuto/recruiting/tree/main/.claude/skills) (Recruiting Skills), [`.claude/agents/persona-builder.md`](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/persona-builder.md) (Persona Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_session["Claude Code Session"]
  node_skills["Recruiting Skills<br/>[skills]"]
end

subgraph group_sourcing["Sourcing"]
  node_sourcing_specialist["Sourcing Specialist"]
  node_persona_builder["Persona Builder<br/>[persona-builder.md]"]
  node_outreach_specialist["Outreach Specialist"]
  node_lead_researcher["Lead Researcher<br/>[lead-researcher.md]"]
end

subgraph group_talent["Talent Partner"]
  node_talent_partner["Talent Partner"]
  node_interview_architect["Interview Architect"]
  node_evaluator["Evaluation Specialist"]
  node_offer_strategist["Offer Strategist"]
  node_quality_analyst["Hiring Quality Analyst"]
end

subgraph group_shared["Shared Knowledge and Outputs"]
  node_market_analyst["Market Analyst<br/>[market-analyst.md]"]
  node_report_generator["Report Generator"]
  node_role_deliverables["Role Deliverables"]
  node_reports["Reports and Dashboards"]
end

node_user(("Recruiter"))

node_user -->|"requests work"| node_session
node_session -->|"launches"| node_sourcing_specialist
node_session -->|"launches"| node_persona_builder
node_session -->|"launches"| node_outreach_specialist
node_session -->|"launches"| node_lead_researcher
node_session -->|"launches"| node_talent_partner
node_session -->|"launches"| node_interview_architect
node_session -->|"launches"| node_evaluator
node_session -->|"launches"| node_offer_strategist
node_session -->|"launches"| node_quality_analyst
node_session -->|"launches"| node_market_analyst
node_session -->|"launches"| node_report_generator
node_skills -->|"injects knowledge"| node_sourcing_specialist
node_skills -->|"injects knowledge"| node_talent_partner
node_sourcing_specialist -->|"pipeline handoff"| node_talent_partner
node_session -->|"coordinates outputs"| node_role_deliverables
node_session -->|"coordinates outputs"| node_reports

click node_skills "https://github.com/carlopezzuto/recruiting/tree/main/.claude/skills"
click node_sourcing_specialist "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-sourcing-specialist.md"
click node_persona_builder "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/persona-builder.md"
click node_outreach_specialist "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/outreach-specialist.md"
click node_lead_researcher "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/lead-researcher.md"
click node_talent_partner "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-talent-partner.md"
click node_interview_architect "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/interview-architect.md"
click node_evaluator "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/evaluation-specialist.md"
click node_offer_strategist "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/offer-strategist.md"
click node_quality_analyst "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/hiring-quality-analyst.md"
click node_market_analyst "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/market-analyst.md"
click node_report_generator "https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/report-generator.md"
click node_role_deliverables "https://github.com/carlopezzuto/recruiting/tree/main/roles"
click node_reports "https://github.com/carlopezzuto/recruiting/tree/main/reports"

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_session,node_skills toneBlue
class node_sourcing_specialist,node_persona_builder,node_outreach_specialist,node_lead_researcher toneAmber
class node_talent_partner,node_interview_architect,node_evaluator,node_offer_strategist,node_quality_analyst toneMint
class node_market_analyst,node_report_generator,node_role_deliverables,node_reports toneRose
class node_user toneIndigo
```

## Components

### Orchestration

- **Claude Code Session**
- [Recruiting Skills](https://github.com/carlopezzuto/recruiting/tree/main/.claude/skills): `.claude/skills`

### Sourcing

- [Sourcing Specialist](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-sourcing-specialist.md): `.claude/agents/senior-sourcing-specialist.md`
- [Persona Builder](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/persona-builder.md): `.claude/agents/persona-builder.md`
- [Outreach Specialist](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/outreach-specialist.md): `.claude/agents/outreach-specialist.md`
- [Lead Researcher](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/lead-researcher.md): `.claude/agents/lead-researcher.md`

### Talent Partner

- [Talent Partner](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/senior-talent-partner.md): `.claude/agents/senior-talent-partner.md`
- [Interview Architect](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/interview-architect.md): `.claude/agents/interview-architect.md`
- [Evaluation Specialist](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/evaluation-specialist.md): `.claude/agents/evaluation-specialist.md`
- [Offer Strategist](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/offer-strategist.md): `.claude/agents/offer-strategist.md`
- [Hiring Quality Analyst](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/hiring-quality-analyst.md): `.claude/agents/hiring-quality-analyst.md`

### Shared Knowledge and Outputs

- [Market Analyst](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/market-analyst.md): `.claude/agents/market-analyst.md`
- [Report Generator](https://github.com/carlopezzuto/recruiting/blob/main/.claude/agents/report-generator.md): `.claude/agents/report-generator.md`
- [Role Deliverables](https://github.com/carlopezzuto/recruiting/tree/main/roles): `roles`
- [Reports and Dashboards](https://github.com/carlopezzuto/recruiting/tree/main/reports): `reports`

### Other components

- **Recruiter**

## Connections

- Recruiter → Claude Code Session: requests work (evidence: `README.md`)
- Claude Code Session → Sourcing Specialist: launches (evidence: `README.md`)
- Claude Code Session → Persona Builder: launches (evidence: `README.md`)
- Claude Code Session → Outreach Specialist: launches (evidence: `README.md`)
- Claude Code Session → Lead Researcher: launches (evidence: `README.md`)
- Claude Code Session → Talent Partner: launches (evidence: `README.md`)
- Claude Code Session → Interview Architect: launches (evidence: `README.md`)
- Claude Code Session → Evaluation Specialist: launches (evidence: `README.md`)
- Claude Code Session → Offer Strategist: launches (evidence: `README.md`)
- Claude Code Session → Hiring Quality Analyst: launches (evidence: `README.md`)
- Claude Code Session → Market Analyst: launches (evidence: `README.md`)
- Claude Code Session → Report Generator: launches (evidence: `README.md`)
- Recruiting Skills → Sourcing Specialist: injects knowledge (evidence: `README.md`)
- Recruiting Skills → Talent Partner: injects knowledge (evidence: `README.md`)
- Sourcing Specialist → Talent Partner: pipeline handoff (evidence: `README.md`)
- Claude Code Session → Role Deliverables: coordinates outputs (evidence: `README.md`)
- Claude Code Session → Reports and Dashboards: coordinates outputs (evidence: `README.md`)
