# samudralaajaykumarrr/sponsor-job-agent architecture

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

- Interactive diagram: https://gitdiagram.com/samudralaajaykumarrr/sponsor-job-agent
- Repository: https://github.com/samudralaajaykumarrr/sponsor-job-agent

## Overview

Sponsor Job Agent is a local, AI-assisted job-discovery and application-preparation product, centered on a dashboard and an opt-in background agent. Its main workflow finds postings, evaluates sponsorship and employment eligibility and job fit, creates and validates a truthful tailored resume, then prepares an application and assists with provider forms while reserving sensitive or final actions for the user. The graph also includes sponsorship intelligence and the dashboard’s cross-cutting read layer. README capabilities guide the workflow; sampled source excerpts are partial, so uncertain internal wiring is omitted.

Main entry points: [`app/applications/executor.py`](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/executor.py) (Application executor), [`app/pipeline.py`](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/pipeline.py) (Job analysis pipeline), [`app/agent/orchestrator.py`](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/agent/orchestrator.py) (Agent orchestrator), [`app/main.py`](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/main.py) (Local dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dashboard and orchestration"]
  node_dashboard["Local dashboard<br/>[main.py]"]
  node_read_layer["Pipeline dashboard"]
  node_agent["Agent orchestrator<br/>[orchestrator.py]"]
end

subgraph group_discovery["Job discovery and screening"]
  node_discovery_cycle["Discovery cycle<br/>[cycle.py]"]
  node_providers["Discovery providers<br/>[registry.py]"]
  node_pipeline["Job analysis pipeline<br/>[pipeline.py]"]
  node_matching["Job matching<br/>[roles.py]"]
end

subgraph group_evidence["Sponsorship intelligence"]
  node_sponsor_decision["Sponsorship decision<br/>[decision.py]"]
  node_sponsor_registry[("Employer evidence registry<br/>[repo.py]")]
  node_review_queue["Sponsorship review<br/>[review_queue.py]"]
end

subgraph group_resume["Resume generation"]
  node_candidate["Candidate profile<br/>[profile.py]"]
  node_resume_generation["Resume generation<br/>[generator.py]"]
  node_resume_optimizer["Resume optimizer<br/>[optimizer.py]"]
  node_resume_validation["Resume quality checks<br/>[quality.py]"]
end

subgraph group_applications["Application assistance"]
  node_app_scheduler["Application scheduler<br/>[scheduler.py]"]
  node_app_executor["Application executor<br/>[executor.py]"]
  node_browser_assist["Browser assistance<br/>[browser_assist.py]"]
  node_ats_adapters["Application providers"]
  node_greenhouse_canary["Greenhouse canary"]
  node_app_state[("Application records<br/>[repo.py]")]
end

node_user(("Job seeker"))
node_ats_apis{{"Public ATS APIs"}}

node_user -->|"uses"| node_dashboard
node_dashboard -->|"starts or stops"| node_agent
node_dashboard -->|"reads dashboard data"| node_read_layer
node_agent -->|"runs discovery"| node_discovery_cycle
node_agent -->|"optimizes resumes"| node_resume_optimizer
node_agent -->|"runs preparation"| node_app_scheduler
node_discovery_cycle -->|"fetches postings"| node_providers
node_providers -->|"requests job data"| node_ats_apis
node_pipeline -->|"scores fit"| node_matching
node_pipeline -->|"evaluates sponsorship"| node_sponsor_decision
node_pipeline -->|"loads profile"| node_candidate
node_pipeline -->|"generates tailored resume"| node_resume_generation
node_sponsor_registry -->|"supplies evidence"| node_sponsor_decision
node_review_queue -->|"reads latest decision"| node_sponsor_decision
node_resume_optimizer -->|"checks quality"| node_resume_validation
node_app_scheduler -->|"dispatches executions"| node_app_executor
node_app_executor -->|"selects provider"| node_ats_adapters
node_app_executor -->|"records execution state"| node_app_state
node_app_executor -->|"runs assisted session"| node_browser_assist
node_browser_assist -->|"uses provider capabilities"| node_ats_adapters
node_greenhouse_canary -.->|"uses execution context"| node_app_executor
node_greenhouse_canary -.->|"records submission outcome"| node_app_state

click node_dashboard "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/main.py"
click node_read_layer "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/pipeline_dashboard.py"
click node_agent "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/agent/orchestrator.py"
click node_discovery_cycle "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/agent/cycle.py"
click node_providers "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/providers/registry.py"
click node_pipeline "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/pipeline.py"
click node_matching "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/matching/roles.py"
click node_sponsor_decision "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/sponsorship/decision.py"
click node_sponsor_registry "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/registry/repo.py"
click node_review_queue "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/sponsorship/review_queue.py"
click node_candidate "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/candidate/profile.py"
click node_resume_generation "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume/generator.py"
click node_resume_optimizer "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume_optimizer/optimizer.py"
click node_resume_validation "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume_optimizer/quality.py"
click node_app_scheduler "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/scheduler.py"
click node_app_executor "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/executor.py"
click node_browser_assist "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/browser_assist.py"
click node_ats_adapters "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/provider_registry.py"
click node_greenhouse_canary "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/greenhouse_canary.py"
click node_app_state "https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/repo.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_dashboard,node_read_layer,node_agent toneBlue
class node_discovery_cycle,node_providers,node_pipeline,node_matching toneAmber
class node_sponsor_decision,node_sponsor_registry,node_review_queue,node_ats_apis toneMint
class node_candidate,node_resume_generation,node_resume_optimizer,node_resume_validation toneRose
class node_app_scheduler,node_app_executor,node_browser_assist,node_ats_adapters,node_greenhouse_canary,node_app_state,node_user toneIndigo
```

## Components

### Dashboard and orchestration

- [Local dashboard](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/main.py): `app/main.py`
- [Pipeline dashboard](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/pipeline_dashboard.py): `app/pipeline_dashboard.py`
- [Agent orchestrator](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/agent/orchestrator.py): `app/agent/orchestrator.py`

### Job discovery and screening

- [Discovery cycle](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/agent/cycle.py): `app/agent/cycle.py`
- [Discovery providers](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/providers/registry.py): `app/providers/registry.py`
- [Job analysis pipeline](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/pipeline.py): `app/pipeline.py`
- [Job matching](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/matching/roles.py): `app/matching/roles.py`

### Sponsorship intelligence

- [Sponsorship decision](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/sponsorship/decision.py): `app/sponsorship/decision.py`
- [Employer evidence registry](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/registry/repo.py): `app/registry/repo.py`
- [Sponsorship review](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/sponsorship/review_queue.py): `app/sponsorship/review_queue.py`

### Resume generation

- [Candidate profile](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/candidate/profile.py): `app/candidate/profile.py`
- [Resume generation](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume/generator.py): `app/resume/generator.py`
- [Resume optimizer](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume_optimizer/optimizer.py): `app/resume_optimizer/optimizer.py`
- [Resume quality checks](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/resume_optimizer/quality.py): `app/resume_optimizer/quality.py`

### Application assistance

- [Application scheduler](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/scheduler.py): `app/applications/scheduler.py`
- [Application executor](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/executor.py): `app/applications/executor.py`
- [Browser assistance](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/browser_assist.py): `app/applications/browser_assist.py`
- [Application providers](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/provider_registry.py): `app/applications/provider_registry.py`
- [Greenhouse canary](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/greenhouse_canary.py): `app/applications/greenhouse_canary.py`
- [Application records](https://github.com/samudralaajaykumarrr/sponsor-job-agent/blob/main/app/applications/repo.py): `app/applications/repo.py`

### Other components

- **Job seeker**
- **Public ATS APIs**

## Connections

- Job seeker → Local dashboard: uses
- Local dashboard → Agent orchestrator: starts or stops
- Local dashboard → Pipeline dashboard: reads dashboard data
- Agent orchestrator → Discovery cycle: runs discovery
- Agent orchestrator → Resume optimizer: optimizes resumes
- Agent orchestrator → Application scheduler: runs preparation
- Discovery cycle → Discovery providers: fetches postings
- Discovery providers → Public ATS APIs: requests job data
- Job analysis pipeline → Job matching: scores fit
- Job analysis pipeline → Sponsorship decision: evaluates sponsorship
- Job analysis pipeline → Candidate profile: loads profile
- Job analysis pipeline → Resume generation: generates tailored resume
- Employer evidence registry → Sponsorship decision: supplies evidence
- Sponsorship review → Sponsorship decision: reads latest decision
- Resume optimizer → Resume quality checks: checks quality
- Application scheduler → Application executor: dispatches executions
- Application executor → Application providers: selects provider
- Application executor → Application records: records execution state
- Application executor → Browser assistance: runs assisted session
- Browser assistance → Application providers: uses provider capabilities
- Greenhouse canary → Application executor: uses execution context
- Greenhouse canary → Application records: records submission outcome
