# chavan-omkar/job-hunt-copilot architecture

> Architecture diagram of the GitHub repository chavan-omkar/job-hunt-copilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chavan-omkar/job-hunt-copilot
- Repository: https://github.com/chavan-omkar/job-hunt-copilot

## Overview

Job Hunt Copilot is a Claude plugin for finding recent India-focused roles and preparing tailored application materials. The main workflow is to search and rank jobs, select one or more, then build a resume and application pack. The README documents the plugin’s capabilities and integrations; the sampled source confirms the resume-generation and PDF-checking scripts. Skill and command internals were not sampled, so their detailed call structure is not asserted.

Main entry points: [`skills/tailor-resume/SKILL.md`](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/SKILL.md) (Resume tailoring), [`skills/apply-pack/SKILL.md`](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/apply-pack/SKILL.md) (Application pack), [`skills/find-jobs`](https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs) (Job source search), [`skills/find-jobs/SKILL.md`](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/find-jobs/SKILL.md) (Job search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Job discovery"]
  node_find_command["Find-jobs command<br/>[find-jobs.md]"]
  node_find_skill["Job search<br/>[SKILL.md]"]
  node_search_sources["Job source search"]
  node_filter_rank["Filter and rank"]
  node_job_list["Saved job list"]
  node_indeed{{"Indeed connector"}}
  node_web_search{{"Public web search"}}
  node_job_alerts{{"Job-alert email"}}
end

subgraph group_resume["Resume tailoring"]
  node_tailor_command["Tailor-resume command<br/>[tailor-resume.md]"]
  node_tailor_skill["Resume tailoring<br/>[SKILL.md]"]
  node_master_resume["Master resume"]
  node_keyword_mapping["Keyword and experience mapping"]
  node_ats_rules["ATS guidance<br/>[ats-rules.md]"]
end

subgraph group_application["Application materials"]
  node_apply_command["Apply-pack command<br/>[apply-pack.md]"]
  node_apply_skill["Application pack<br/>[SKILL.md]"]
  node_writing_guide["Writing guide<br/>[writing-guide.md]"]
  node_application_output["Application pack output"]
end

subgraph group_runtime["Resume utilities"]
  node_resume_build["Resume document builder<br/>[build_resume.py]"]
  node_ats_check["PDF ATS check<br/>[ats_check.py]"]
end

node_user(("Job seeker"))

node_user -->|"requests search"| node_find_command
node_find_command -->|"runs search"| node_find_skill
node_find_skill -->|"searches roles"| node_search_sources
node_search_sources -->|"queries"| node_indeed
node_search_sources -->|"searches"| node_web_search
node_job_alerts -.->|"supplies alerts"| node_search_sources
node_find_skill -->|"filters and ranks"| node_filter_rank
node_filter_rank -->|"saves results"| node_job_list
node_user -->|"requests tailoring"| node_tailor_command
node_tailor_command -->|"runs tailoring"| node_tailor_skill
node_user -->|"provides resume"| node_master_resume
node_tailor_skill -->|"extracts and maps"| node_keyword_mapping
node_tailor_skill -->|"builds resume"| node_resume_build
node_ats_rules -.->|"guides formatting"| node_tailor_skill
node_resume_build -.->|"checks PDF"| node_ats_check
node_user -->|"requests pack"| node_apply_command
node_apply_command -->|"runs pack"| node_apply_skill
node_apply_skill -->|"finds jobs"| node_search_sources
node_apply_skill -->|"tailors resume"| node_tailor_skill
node_apply_skill -.->|"uses guidance"| node_writing_guide
node_apply_skill -->|"creates materials"| node_application_output
node_tailor_skill -->|"produces resume and report"| node_application_output

click node_find_command "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/find-jobs.md"
click node_find_skill "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/find-jobs/SKILL.md"
click node_search_sources "https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs"
click node_filter_rank "https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs"
click node_job_list "https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs"
click node_tailor_command "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/tailor-resume.md"
click node_tailor_skill "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/SKILL.md"
click node_keyword_mapping "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/references/keyword-extraction.md"
click node_resume_build "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/scripts/build_resume.py"
click node_ats_rules "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/references/ats-rules.md"
click node_ats_check "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/scripts/ats_check.py"
click node_apply_command "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/apply-pack.md"
click node_apply_skill "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/apply-pack/SKILL.md"
click node_writing_guide "https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/apply-pack/references/writing-guide.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_find_command,node_find_skill,node_search_sources,node_filter_rank,node_job_list,node_indeed,node_web_search,node_job_alerts toneBlue
class node_tailor_command,node_tailor_skill,node_master_resume,node_keyword_mapping,node_ats_rules toneAmber
class node_apply_command,node_apply_skill,node_writing_guide,node_application_output toneMint
class node_resume_build,node_ats_check toneRose
class node_user toneIndigo
```

## Components

### Job discovery

- [Find-jobs command](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/find-jobs.md): `commands/find-jobs.md`
- [Job search](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/find-jobs/SKILL.md): `skills/find-jobs/SKILL.md`
- [Job source search](https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs): `skills/find-jobs`
- [Filter and rank](https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs): `skills/find-jobs`
- [Saved job list](https://github.com/chavan-omkar/job-hunt-copilot/tree/main/skills/find-jobs): `skills/find-jobs`
- **Indeed connector**
- **Public web search**
- **Job-alert email**

### Resume tailoring

- [Tailor-resume command](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/tailor-resume.md): `commands/tailor-resume.md`
- [Resume tailoring](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/SKILL.md): `skills/tailor-resume/SKILL.md`
- **Master resume**
- [Keyword and experience mapping](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/references/keyword-extraction.md): `skills/tailor-resume/references/keyword-extraction.md`
- [ATS guidance](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/references/ats-rules.md): `skills/tailor-resume/references/ats-rules.md`

### Application materials

- [Apply-pack command](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/commands/apply-pack.md): `commands/apply-pack.md`
- [Application pack](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/apply-pack/SKILL.md): `skills/apply-pack/SKILL.md`
- [Writing guide](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/apply-pack/references/writing-guide.md): `skills/apply-pack/references/writing-guide.md`
- **Application pack output**

### Resume utilities

- [Resume document builder](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/scripts/build_resume.py): `skills/tailor-resume/scripts/build_resume.py`
- [PDF ATS check](https://github.com/chavan-omkar/job-hunt-copilot/blob/main/skills/tailor-resume/scripts/ats_check.py): `skills/tailor-resume/scripts/ats_check.py`

### Other components

- **Job seeker**

## Connections

- Job seeker → Find-jobs command: requests search (evidence: `README.md`)
- Find-jobs command → Job search: runs search (evidence: `README.md`)
- Job search → Job source search: searches roles (evidence: `README.md`)
- Job source search → Indeed connector: queries (evidence: `README.md`)
- Job source search → Public web search: searches (evidence: `README.md`)
- Job-alert email → Job source search: supplies alerts (evidence: `README.md`)
- Job search → Filter and rank: filters and ranks (evidence: `README.md`)
- Filter and rank → Saved job list: saves results (evidence: `README.md`)
- Job seeker → Tailor-resume command: requests tailoring (evidence: `README.md`)
- Tailor-resume command → Resume tailoring: runs tailoring (evidence: `README.md`)
- Job seeker → Master resume: provides resume (evidence: `README.md`)
- Resume tailoring → Keyword and experience mapping: extracts and maps (evidence: `README.md`)
- Resume tailoring → Resume document builder: builds resume (evidence: `README.md`)
- ATS guidance → Resume tailoring: guides formatting
- Resume document builder → PDF ATS check: checks PDF
- Job seeker → Apply-pack command: requests pack (evidence: `README.md`)
- Apply-pack command → Application pack: runs pack (evidence: `README.md`)
- Application pack → Job source search: finds jobs (evidence: `README.md`)
- Application pack → Resume tailoring: tailors resume (evidence: `README.md`)
- Application pack → Writing guide: uses guidance
- Application pack → Application pack output: creates materials (evidence: `README.md`)
- Resume tailoring → Application pack output: produces resume and report (evidence: `README.md`)
