# k1anshul/ai-job-search architecture

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

- Interactive diagram: https://gitdiagram.com/k1anshul/ai-job-search
- Repository: https://github.com/k1anshul/ai-job-search

## Overview

This repository is a local, Claude Code–driven job-application framework. Its documented user journey runs from profile setup through posting discovery, ranking, tailored applications, interview preparation, and outcome tracking. The graph also preserves supporting capabilities for portal search, posting safety, document production, and salary benchmarking. Evidence is limited to the README and sampled/indexed source; unsampled subsystem links are omitted where their callers are not shown.

Main entry points: [`.claude/commands/apply.md`](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/apply.md) (Application tailoring), [`.claude/skills/job-scraper`](https://github.com/k1anshul/ai-job-search/tree/master/.claude/skills/job-scraper) (Posting scrape), [`.claude/commands/setup.md`](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/setup.md) (Profile setup), [`.claude/commands/rank.md`](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/rank.md) (Job ranking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Application workflow"]
  node_setup["Profile setup<br/>[setup.md]"]
  node_profile["Candidate profile"]
  node_rank["Job ranking<br/>[rank.md]"]
  node_rankstate["Ranking state<br/>[rank_state.py]"]
  node_apply["Application tailoring<br/>[apply.md]"]
  node_interview["Interview prep<br/>[interview.md]"]
  node_outcome["Outcome tracking<br/>[outcome.md]"]
  node_state["Scrape state<br/>[scrape_state.py]"]
end

subgraph group_search["Job discovery"]
  node_scrape["Posting scrape<br/>[job-scraper]"]
  node_portal["Portal search<br/>[skills]"]
end

subgraph group_documents["Application materials"]
  node_cv["CV templates<br/>[05-cv-templates.md]"]
  node_letters["Cover letters"]
  node_pdfcheck["PDF checks<br/>[verify_pdf.py]"]
  node_layoutcheck["Layout checks<br/>[verify_layout.py]"]
end

subgraph group_support["Safety and utilities"]
  node_fetch["Page fetching<br/>[fetch_page.py]"]
  node_guard["Posting integrity<br/>[posting_guard.py]"]
  node_decode["Page decoding<br/>[page_decode.py]"]
  node_salary["Salary benchmark<br/>[salary_lookup.py]"]
  node_salaryconvert["Salary conversion"]
end

node_user(("Job seeker"))
node_claude["Claude Code"]
node_portals["Job portals"]

node_user -->|"uses"| node_claude
node_claude -->|"runs"| node_setup
node_setup -->|"builds"| node_profile
node_claude -->|"runs"| node_scrape
node_scrape -->|"searches"| node_portal
node_portal -.->|"queries"| node_portals
node_claude -->|"runs"| node_rank
node_rank -->|"records scores"| node_rankstate
node_claude -->|"runs"| node_apply
node_apply -->|"tailors"| node_cv
node_apply -->|"writes"| node_letters
node_apply -.->|"checks PDF"| node_pdfcheck
node_apply -.->|"checks layout"| node_layoutcheck
node_claude -->|"runs"| node_interview
node_claude -->|"runs"| node_outcome
node_scrape -.->|"tracks postings"| node_state
node_fetch -->|"decodes pages"| node_decode
node_guard -->|"decodes HTML"| node_decode
node_salaryconvert -->|"prepares data for"| node_salary

click node_setup "https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/setup.md"
click node_profile "https://github.com/k1anshul/ai-job-search/tree/master/.claude/skills/job-application-assistant"
click node_scrape "https://github.com/k1anshul/ai-job-search/tree/master/.claude/skills/job-scraper"
click node_portal "https://github.com/k1anshul/ai-job-search/tree/master/.agents/skills"
click node_rank "https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/rank.md"
click node_rankstate "https://github.com/k1anshul/ai-job-search/blob/master/tools/rank_state.py"
click node_apply "https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/apply.md"
click node_cv "https://github.com/k1anshul/ai-job-search/blob/master/.claude/skills/job-application-assistant/05-cv-templates.md"
click node_letters "https://github.com/k1anshul/ai-job-search/tree/master/cover_letters"
click node_pdfcheck "https://github.com/k1anshul/ai-job-search/blob/master/tools/verify_pdf.py"
click node_layoutcheck "https://github.com/k1anshul/ai-job-search/blob/master/tools/verify_layout.py"
click node_interview "https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/interview.md"
click node_outcome "https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/outcome.md"
click node_state "https://github.com/k1anshul/ai-job-search/blob/master/tools/scrape_state.py"
click node_fetch "https://github.com/k1anshul/ai-job-search/blob/master/tools/fetch_page.py"
click node_guard "https://github.com/k1anshul/ai-job-search/blob/master/tools/posting_guard.py"
click node_decode "https://github.com/k1anshul/ai-job-search/blob/master/tools/page_decode.py"
click node_salary "https://github.com/k1anshul/ai-job-search/blob/master/salary_lookup.py"
click node_salaryconvert "https://github.com/k1anshul/ai-job-search/blob/master/tools/convert_salary_excel.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_setup,node_profile,node_rank,node_rankstate,node_apply,node_interview,node_outcome,node_state toneBlue
class node_scrape,node_portal toneAmber
class node_cv,node_letters,node_pdfcheck,node_layoutcheck toneMint
class node_fetch,node_guard,node_decode,node_salary,node_salaryconvert toneRose
class node_user,node_claude,node_portals toneIndigo
```

## Components

### Application workflow

- [Profile setup](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/setup.md): `.claude/commands/setup.md`
- [Candidate profile](https://github.com/k1anshul/ai-job-search/tree/master/.claude/skills/job-application-assistant): `.claude/skills/job-application-assistant`
- [Job ranking](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/rank.md): `.claude/commands/rank.md`
- [Ranking state](https://github.com/k1anshul/ai-job-search/blob/master/tools/rank_state.py): `tools/rank_state.py`
- [Application tailoring](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/apply.md): `.claude/commands/apply.md`
- [Interview prep](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/interview.md): `.claude/commands/interview.md`
- [Outcome tracking](https://github.com/k1anshul/ai-job-search/blob/master/.claude/commands/outcome.md): `.claude/commands/outcome.md`
- [Scrape state](https://github.com/k1anshul/ai-job-search/blob/master/tools/scrape_state.py): `tools/scrape_state.py`

### Job discovery

- [Posting scrape](https://github.com/k1anshul/ai-job-search/tree/master/.claude/skills/job-scraper): `.claude/skills/job-scraper`
- [Portal search](https://github.com/k1anshul/ai-job-search/tree/master/.agents/skills): `.agents/skills`

### Application materials

- [CV templates](https://github.com/k1anshul/ai-job-search/blob/master/.claude/skills/job-application-assistant/05-cv-templates.md): `.claude/skills/job-application-assistant/05-cv-templates.md`
- [Cover letters](https://github.com/k1anshul/ai-job-search/tree/master/cover_letters): `cover_letters`
- [PDF checks](https://github.com/k1anshul/ai-job-search/blob/master/tools/verify_pdf.py): `tools/verify_pdf.py`
- [Layout checks](https://github.com/k1anshul/ai-job-search/blob/master/tools/verify_layout.py): `tools/verify_layout.py`

### Safety and utilities

- [Page fetching](https://github.com/k1anshul/ai-job-search/blob/master/tools/fetch_page.py): `tools/fetch_page.py`
- [Posting integrity](https://github.com/k1anshul/ai-job-search/blob/master/tools/posting_guard.py): `tools/posting_guard.py`
- [Page decoding](https://github.com/k1anshul/ai-job-search/blob/master/tools/page_decode.py): `tools/page_decode.py`
- [Salary benchmark](https://github.com/k1anshul/ai-job-search/blob/master/salary_lookup.py): `salary_lookup.py`
- [Salary conversion](https://github.com/k1anshul/ai-job-search/blob/master/tools/convert_salary_excel.py): `tools/convert_salary_excel.py`

### Other components

- **Job seeker**
- **Claude Code**
- **Job portals**

## Connections

- Job seeker → Claude Code: uses (evidence: `README.md`)
- Claude Code → Profile setup: runs (evidence: `README.md`)
- Profile setup → Candidate profile: builds (evidence: `README.md`)
- Claude Code → Posting scrape: runs (evidence: `README.md`)
- Posting scrape → Portal search: searches (evidence: `README.md`)
- Portal search → Job portals: queries
- Claude Code → Job ranking: runs (evidence: `README.md`)
- Job ranking → Ranking state: records scores (evidence: `tools/rank_state.py`)
- Claude Code → Application tailoring: runs (evidence: `README.md`)
- Application tailoring → CV templates: tailors (evidence: `README.md`)
- Application tailoring → Cover letters: writes (evidence: `README.md`)
- Application tailoring → PDF checks: checks PDF
- Application tailoring → Layout checks: checks layout
- Claude Code → Interview prep: runs (evidence: `README.md`)
- Claude Code → Outcome tracking: runs (evidence: `README.md`)
- Posting scrape → Scrape state: tracks postings
- Page fetching → Page decoding: decodes pages (evidence: `tools/page_decode.py`)
- Posting integrity → Page decoding: decodes HTML (evidence: `tools/posting_guard.py`)
- Salary conversion → Salary benchmark: prepares data for (evidence: `tools/convert_salary_excel.py`)
