# rcnsnr/job-search-workflow architecture

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

- Interactive diagram: https://gitdiagram.com/rcnsnr/job-search-workflow
- Repository: https://github.com/rcnsnr/job-search-workflow

## Overview

Job Search Workflow is a local-first career workflow toolkit: users capture and triage job leads, assess fit, prepare application materials, and track progress. Its visual dashboard reads local Markdown records; an optional browser extension captures LinkedIn postings and can forward them to a local capture server. The repository also documents public-source discovery and workflow guards. The extension-to-server and several unsampled capability links are based on README statements; source excerpts do not establish their internal call paths.

Main entry points: [`dashboard/server.py`](https://github.com/rcnsnr/job-search-workflow/blob/main/dashboard/server.py) (Dashboard server), [`modes/05_DOCUMENT_OUTPUT.md`](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/05_DOCUMENT_OUTPUT.md) (Document standards), [`tools/browser-extension/utils/workflow_exporter.js`](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/utils/workflow_exporter.js) (Workflow exporter), [`tools/browser-extension/content/jobs.js`](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/content/jobs.js) (Browser capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Job Workflow"]
  node_triage["Job triage<br/>[01_JOB_TRIAGE.md]"]
  node_resume["Resume matching<br/>[02_RESUME_ATS.md]"]
  node_outreach["Recruiter outreach"]
  node_quality["Quality audit"]
  node_discovery["Source discovery"]
end

subgraph group_capture["Capture"]
  node_extension["Browser capture<br/>[jobs.js]"]
  node_profile["Scan profile"]
  node_exporter["Workflow exporter"]
  node_autoscan["Unattended scanning<br/>[autoscan.js]"]
  node_settings["Extension settings<br/>[options.js]"]
  node_worker["Extension coordinator<br/>[service_worker.js]"]
  node_capture_server["Local capture server"]
end

subgraph group_workspace["Local Workspace"]
  node_job_inbox[("Job inbox")]
  node_career_data["Career workspace"]
  node_guards["Workflow guards<br/>[workflow_guard.py]"]
  node_markdown_jobs[("Job records")]
end

subgraph group_documents["Documents"]
  node_doc_modes["Document standards"]
  node_tex_export["LaTeX export<br/>[md_to_tex.py]"]
  node_docx_export["DOCX export<br/>[md_to_docx.py]"]
end

subgraph group_operations["Operations Desk"]
  node_dashboard["Dashboard server<br/>[server.py]"]
  node_cli["Workflow CLI<br/>[__main__.py]"]
end

node_user(("Job seeker"))
node_browser(("LinkedIn Jobs"))

node_user -->|"runs triage"| node_triage
node_user -->|"starts discovery"| node_discovery
node_user -->|"prepares materials"| node_doc_modes
node_user -->|"views workspace"| node_dashboard
node_user -->|"checks records"| node_guards
node_browser -->|"provides postings"| node_extension
node_extension -.->|"exports captures"| node_exporter
node_profile -.->|"adds fit hints"| node_exporter
node_settings -->|"requests scans"| node_worker
node_autoscan -->|"posts batches"| node_capture_server
node_capture_server -->|"writes postings"| node_job_inbox
node_exporter -->|"exports for manual import"| node_job_inbox
node_job_inbox -->|"reads Markdown"| node_dashboard
node_career_data -.->|"supplies profile data"| node_dashboard
node_dashboard -->|"loads job cards"| node_markdown_jobs
node_dashboard -->|"renders local views"| node_user
node_doc_modes -.->|"guides document output"| node_tex_export
node_doc_modes -.->|"guides document output"| node_docx_export
node_cli -->|"starts server"| node_dashboard

click node_triage "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/01_JOB_TRIAGE.md"
click node_resume "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/02_RESUME_ATS.md"
click node_outreach "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/04_RECRUITER_OUTREACH.md"
click node_quality "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/07_JOB_QUALITY_AUDIT.md"
click node_discovery "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/06_PUBLIC_SOURCE_DISCOVERY.md"
click node_extension "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/content/jobs.js"
click node_profile "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/utils/workflow_profile.js"
click node_exporter "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/utils/workflow_exporter.js"
click node_autoscan "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/content/autoscan.js"
click node_settings "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/options.js"
click node_worker "https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/service_worker.js"
click node_capture_server "https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/linkedin_capture_server.py"
click node_career_data "https://github.com/rcnsnr/job-search-workflow/tree/main/templates/user-data-skeleton"
click node_guards "https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/workflow_guard.py"
click node_doc_modes "https://github.com/rcnsnr/job-search-workflow/blob/main/modes/05_DOCUMENT_OUTPUT.md"
click node_tex_export "https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/md_to_tex.py"
click node_docx_export "https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/md_to_docx.py"
click node_dashboard "https://github.com/rcnsnr/job-search-workflow/blob/main/dashboard/server.py"
click node_cli "https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/jsw/__main__.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_triage,node_resume,node_outreach,node_quality,node_discovery toneBlue
class node_extension,node_profile,node_exporter,node_autoscan,node_settings,node_worker,node_capture_server toneAmber
class node_job_inbox,node_career_data,node_guards,node_markdown_jobs toneMint
class node_doc_modes,node_tex_export,node_docx_export toneRose
class node_dashboard,node_cli,node_user,node_browser toneIndigo
```

## Components

### Job Workflow

- [Job triage](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/01_JOB_TRIAGE.md): `modes/01_JOB_TRIAGE.md`
- [Resume matching](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/02_RESUME_ATS.md): `modes/02_RESUME_ATS.md`
- [Recruiter outreach](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/04_RECRUITER_OUTREACH.md): `modes/04_RECRUITER_OUTREACH.md`
- [Quality audit](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/07_JOB_QUALITY_AUDIT.md): `modes/07_JOB_QUALITY_AUDIT.md`
- [Source discovery](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/06_PUBLIC_SOURCE_DISCOVERY.md): `modes/06_PUBLIC_SOURCE_DISCOVERY.md`

### Capture

- [Browser capture](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/content/jobs.js): `tools/browser-extension/content/jobs.js`
- [Scan profile](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/utils/workflow_profile.js): `tools/browser-extension/utils/workflow_profile.js`
- [Workflow exporter](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/utils/workflow_exporter.js): `tools/browser-extension/utils/workflow_exporter.js`
- [Unattended scanning](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/content/autoscan.js): `tools/browser-extension/content/autoscan.js`
- [Extension settings](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/options.js): `tools/browser-extension/options.js`
- [Extension coordinator](https://github.com/rcnsnr/job-search-workflow/blob/main/tools/browser-extension/service_worker.js): `tools/browser-extension/service_worker.js`
- [Local capture server](https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/linkedin_capture_server.py): `scripts/linkedin_capture_server.py`

### Local Workspace

- **Job inbox**
- [Career workspace](https://github.com/rcnsnr/job-search-workflow/tree/main/templates/user-data-skeleton): `templates/user-data-skeleton`
- [Workflow guards](https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/workflow_guard.py): `scripts/workflow_guard.py`
- **Job records**

### Documents

- [Document standards](https://github.com/rcnsnr/job-search-workflow/blob/main/modes/05_DOCUMENT_OUTPUT.md): `modes/05_DOCUMENT_OUTPUT.md`
- [LaTeX export](https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/md_to_tex.py): `scripts/md_to_tex.py`
- [DOCX export](https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/md_to_docx.py): `scripts/md_to_docx.py`

### Operations Desk

- [Dashboard server](https://github.com/rcnsnr/job-search-workflow/blob/main/dashboard/server.py): `dashboard/server.py`
- [Workflow CLI](https://github.com/rcnsnr/job-search-workflow/blob/main/scripts/jsw/__main__.py): `scripts/jsw/__main__.py`

### Other components

- **Job seeker**
- **LinkedIn Jobs**

## Connections

- Job seeker → Job triage: runs triage (evidence: `README.md`)
- Job seeker → Source discovery: starts discovery (evidence: `README.md`)
- Job seeker → Document standards: prepares materials (evidence: `README.md`)
- Job seeker → Dashboard server: views workspace (evidence: `README.md`)
- Job seeker → Workflow guards: checks records (evidence: `README.md`)
- LinkedIn Jobs → Browser capture: provides postings (evidence: `README.md`)
- Browser capture → Workflow exporter: exports captures
- Scan profile → Workflow exporter: adds fit hints
- Extension settings → Extension coordinator: requests scans (evidence: `tools/browser-extension/options.js`)
- Unattended scanning → Local capture server: posts batches (evidence: `tools/browser-extension/content/autoscan.js`)
- Local capture server → Job inbox: writes postings (evidence: `README.md`)
- Workflow exporter → Job inbox: exports for manual import (evidence: `README.md`)
- Job inbox → Dashboard server: reads Markdown (evidence: `README.md`)
- Career workspace → Dashboard server: supplies profile data
- Dashboard server → Job records: loads job cards (evidence: `dashboard/server.py`)
- Dashboard server → Job seeker: renders local views (evidence: `dashboard/server.py`)
- Document standards → LaTeX export: guides document output
- Document standards → DOCX export: guides document output
- Workflow CLI → Dashboard server: starts server (evidence: `scripts/jsw/__main__.py`)
