# akbardevop/ai-job-agent architecture

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

- Interactive diagram: https://gitdiagram.com/akbardevop/ai-job-agent
- Repository: https://github.com/akbardevop/ai-job-agent

## Overview

AI Job Application Agent is a Claude Code career-coaching product, not primarily a standalone CLI. The central workflow starts with a job-search conversation, turns the user’s goals into a researched slate, then supports applications, outreach, follow-ups, and progress review. Skills provide the coaching and domain stages; scripts automate ATS forms, email, resume parsing and rendering, and tracker views or updates. The README documents the skill-to-tool roles; sampled scripts confirm several implementation details. Some skill internals and runtime data wiring were not sampled, so those relationships are shown only where documented.

Main entry points: [`skills/job-apply/SKILL.md`](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-apply/SKILL.md) (Application skill), [`skills/job-coach/SKILL.md`](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-coach/SKILL.md) (Career coach), [`skills/job-outreach/SKILL.md`](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-outreach/SKILL.md) (Outreach skill), [`skills/job-followup/SKILL.md`](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-followup/SKILL.md) (Follow-up skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coaching["Coaching and planning"]
  node_coach["Career coach<br/>[SKILL.md]"]
  node_setup["Job setup<br/>[SKILL.md]"]
  node_market["Market research<br/>[SKILL.md]"]
  node_evaluate["Role evaluation<br/>[SKILL.md]"]
  node_patterns["Search patterns<br/>[SKILL.md]"]
end

subgraph group_applications["Applications and CV"]
  node_apply["Application skill<br/>[SKILL.md]"]
  node_linkedin["LinkedIn apply"]
  node_greenhouse["Greenhouse apply"]
  node_lever["Lever apply<br/>[lever-apply.js]"]
  node_jobvite["Jobvite apply<br/>[jobvite-apply.js]"]
  node_ashby["Ashby apply<br/>[ashby-apply.js]"]
  node_cv["Tailored CV"]
  node_resume["Resume parsing<br/>[parse-resume.mjs]"]
end

subgraph group_engagement["Outreach and inbox"]
  node_outreach["Outreach skill<br/>[SKILL.md]"]
  node_coldemail["Cold email<br/>[send-cold-email.js]"]
  node_outlooksend["Outlook send<br/>[outlook-send.js]"]
  node_triage["Inbox triage<br/>[outlook-triage.js]"]
  node_followup["Follow-up skill<br/>[SKILL.md]"]
end

subgraph group_tracking["Tracking and review"]
  node_track["Tracker skill<br/>[SKILL.md]"]
  node_status["Status updates"]
  node_sheetsync["Sheet sync"]
  node_mirror["Tracker mirror<br/>[mirror-tracker.mjs]"]
  node_dashboard["Dashboard<br/>[job-dashboard.mjs]"]
  node_statusskill["Status skill<br/>[SKILL.md]"]
end

node_user(("Job seeker"))
node_externalats{{"ATS portals"}}
node_linkedinservice{{"LinkedIn"}}
node_outlook{{"Outlook"}}
node_msmtp{{"msmtp"}}
node_googlesheets[("Google Sheets")]

node_user -->|"starts search"| node_coach
node_coach -->|"sets up"| node_setup
node_coach -->|"researches market"| node_market
node_coach -->|"scores roles"| node_evaluate
node_coach -->|"analyzes patterns"| node_patterns
node_coach -->|"dispatches"| node_apply
node_coach -->|"dispatches"| node_outreach
node_coach -->|"reviews progress"| node_dashboard
node_user -->|"requests application"| node_apply
node_apply -->|"uses tool"| node_linkedin
node_apply -->|"uses tool"| node_greenhouse
node_apply -->|"uses tool"| node_lever
node_apply -->|"uses tool"| node_jobvite
node_apply -->|"uses tool"| node_ashby
node_apply -->|"renders CV"| node_cv
node_linkedin -->|"submits to"| node_externalats
node_greenhouse -->|"submits to"| node_externalats
node_lever -->|"submits to"| node_externalats
node_jobvite -->|"submits to"| node_externalats
node_ashby -->|"submits to"| node_externalats
node_apply -->|"parses resume"| node_resume
node_outreach -->|"sends email"| node_coldemail
node_coldemail -->|"hands message"| node_msmtp
node_outreach -->|"contacts people"| node_linkedinservice
node_user -->|"checks inbox"| node_triage
node_triage -->|"searches messages"| node_outlook
node_user -->|"requests follow-ups"| node_followup
node_followup -.->|"checks replies"| node_triage
node_followup -.->|"sends follow-up"| node_outlooksend
node_outlooksend -.->|"sends message"| node_outlook
node_user -->|"reports update"| node_statusskill
node_statusskill -->|"updates status"| node_status
node_user -->|"requests tracker"| node_track
node_track -->|"reads overview"| node_dashboard
node_status -->|"updates rows"| node_googlesheets
node_status -->|"updates local CSV"| node_sheetsync
node_sheetsync -.->|"syncs tracker"| node_googlesheets
node_mirror -.->|"mirrors tracker"| node_dashboard

click node_coach "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-coach/SKILL.md"
click node_setup "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-setup/SKILL.md"
click node_market "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-coach/SKILL.md"
click node_evaluate "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-evaluate/SKILL.md"
click node_patterns "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-patterns/SKILL.md"
click node_apply "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-apply/SKILL.md"
click node_linkedin "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/linkedin-easy-apply.js"
click node_greenhouse "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/greenhouse-apply.js"
click node_lever "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/lever-apply.js"
click node_jobvite "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/jobvite-apply.js"
click node_ashby "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/ashby-apply.js"
click node_cv "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/generate-tailored-cv.mjs"
click node_resume "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/parse-resume.mjs"
click node_outreach "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-outreach/SKILL.md"
click node_coldemail "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/send-cold-email.js"
click node_outlooksend "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/outlook-send.js"
click node_triage "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/outlook-triage.js"
click node_followup "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-followup/SKILL.md"
click node_track "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-track/SKILL.md"
click node_status "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/tracker-status-update.py"
click node_sheetsync "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/google-sheet-sync.py"
click node_mirror "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/mirror-tracker.mjs"
click node_dashboard "https://github.com/akbardevop/ai-job-agent/blob/main/scripts/job-dashboard.mjs"
click node_statusskill "https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-status/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_coach,node_setup,node_market,node_evaluate,node_patterns toneBlue
class node_apply,node_linkedin,node_greenhouse,node_lever,node_jobvite,node_ashby,node_cv,node_resume,node_googlesheets toneAmber
class node_outreach,node_coldemail,node_outlooksend,node_triage,node_followup toneMint
class node_track,node_status,node_sheetsync,node_mirror,node_dashboard,node_statusskill toneRose
class node_user,node_externalats,node_linkedinservice,node_outlook,node_msmtp toneIndigo
```

## Components

### Coaching and planning

- [Career coach](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-coach/SKILL.md): `skills/job-coach/SKILL.md`
- [Job setup](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-setup/SKILL.md): `skills/job-setup/SKILL.md`
- [Market research](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-coach/SKILL.md): `skills/job-coach/SKILL.md`
- [Role evaluation](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-evaluate/SKILL.md): `skills/job-evaluate/SKILL.md`
- [Search patterns](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-patterns/SKILL.md): `skills/job-patterns/SKILL.md`

### Applications and CV

- [Application skill](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-apply/SKILL.md): `skills/job-apply/SKILL.md`
- [LinkedIn apply](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/linkedin-easy-apply.js): `scripts/linkedin-easy-apply.js`
- [Greenhouse apply](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/greenhouse-apply.js): `scripts/greenhouse-apply.js`
- [Lever apply](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/lever-apply.js): `scripts/lever-apply.js`
- [Jobvite apply](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/jobvite-apply.js): `scripts/jobvite-apply.js`
- [Ashby apply](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/ashby-apply.js): `scripts/ashby-apply.js`
- [Tailored CV](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/generate-tailored-cv.mjs): `scripts/generate-tailored-cv.mjs`
- [Resume parsing](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/parse-resume.mjs): `scripts/parse-resume.mjs`

### Outreach and inbox

- [Outreach skill](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-outreach/SKILL.md): `skills/job-outreach/SKILL.md`
- [Cold email](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/send-cold-email.js): `scripts/send-cold-email.js`
- [Outlook send](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/outlook-send.js): `scripts/outlook-send.js`
- [Inbox triage](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/outlook-triage.js): `scripts/outlook-triage.js`
- [Follow-up skill](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-followup/SKILL.md): `skills/job-followup/SKILL.md`

### Tracking and review

- [Tracker skill](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-track/SKILL.md): `skills/job-track/SKILL.md`
- [Status updates](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/tracker-status-update.py): `scripts/tracker-status-update.py`
- [Sheet sync](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/google-sheet-sync.py): `scripts/google-sheet-sync.py`
- [Tracker mirror](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/mirror-tracker.mjs): `scripts/mirror-tracker.mjs`
- [Dashboard](https://github.com/akbardevop/ai-job-agent/blob/main/scripts/job-dashboard.mjs): `scripts/job-dashboard.mjs`
- [Status skill](https://github.com/akbardevop/ai-job-agent/blob/main/skills/job-status/SKILL.md): `skills/job-status/SKILL.md`

### Other components

- **Job seeker**
- **ATS portals**
- **LinkedIn**
- **Outlook**
- **msmtp**
- **Google Sheets**

## Connections

- Job seeker → Career coach: starts search (evidence: `README.md`)
- Career coach → Job setup: sets up (evidence: `README.md`)
- Career coach → Market research: researches market (evidence: `README.md`)
- Career coach → Role evaluation: scores roles (evidence: `README.md`)
- Career coach → Search patterns: analyzes patterns (evidence: `README.md`)
- Career coach → Application skill: dispatches (evidence: `README.md`)
- Career coach → Outreach skill: dispatches (evidence: `README.md`)
- Career coach → Dashboard: reviews progress (evidence: `README.md`)
- Job seeker → Application skill: requests application (evidence: `README.md`)
- Application skill → LinkedIn apply: uses tool (evidence: `README.md`)
- Application skill → Greenhouse apply: uses tool (evidence: `README.md`)
- Application skill → Lever apply: uses tool (evidence: `README.md`)
- Application skill → Jobvite apply: uses tool (evidence: `README.md`)
- Application skill → Ashby apply: uses tool (evidence: `README.md`)
- Application skill → Tailored CV: renders CV (evidence: `README.md`)
- LinkedIn apply → ATS portals: submits to (evidence: `scripts/linkedin-easy-apply.js`)
- Greenhouse apply → ATS portals: submits to (evidence: `scripts/greenhouse-apply.js`)
- Lever apply → ATS portals: submits to (evidence: `scripts/lever-apply.js`)
- Jobvite apply → ATS portals: submits to (evidence: `scripts/jobvite-apply.js`)
- Ashby apply → ATS portals: submits to (evidence: `scripts/ashby-apply.js`)
- Application skill → Resume parsing: parses resume (evidence: `README.md`)
- Outreach skill → Cold email: sends email (evidence: `README.md`)
- Cold email → msmtp: hands message (evidence: `scripts/send-cold-email.js`)
- Outreach skill → LinkedIn: contacts people (evidence: `README.md`)
- Job seeker → Inbox triage: checks inbox (evidence: `README.md`)
- Inbox triage → Outlook: searches messages (evidence: `scripts/outlook-triage.js`)
- Job seeker → Follow-up skill: requests follow-ups (evidence: `README.md`)
- Follow-up skill → Inbox triage: checks replies
- Follow-up skill → Outlook send: sends follow-up
- Outlook send → Outlook: sends message
- Job seeker → Status skill: reports update (evidence: `README.md`)
- Status skill → Status updates: updates status (evidence: `README.md`)
- Job seeker → Tracker skill: requests tracker (evidence: `README.md`)
- Tracker skill → Dashboard: reads overview (evidence: `README.md`)
- Status updates → Google Sheets: updates rows (evidence: `scripts/tracker-status-update.py`)
- Status updates → Sheet sync: updates local CSV (evidence: `scripts/tracker-status-update.py`)
- Sheet sync → Google Sheets: syncs tracker
- Tracker mirror → Dashboard: mirrors tracker
