# kumbham8888/career-ops-job-hunting architecture

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

- Interactive diagram: https://gitdiagram.com/kumbham8888/career-ops-job-hunting
- Repository: https://github.com/kumbham8888/career-ops-job-hunting

## Overview

Career Ops is an AI-assisted job-search and career-management toolkit, used through coding-agent commands and prompt modes. Its main workflow scans and evaluates opportunities, records applications and reports, then supports follow-up, interview preparation, and progress review. The tree documents additional CV/PDF/Word generation, batch processing, training, and pattern analysis. Source excerpts confirm scanner, tracker analytics, and dashboard behavior; links between prompt modes and unsampled implementation details are therefore shown only where the file layout supports the capability, not as asserted calls.

Main entry points: [`career-ops/modes`](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/modes) (Job modes), [`career-ops/dashboard/main.go`](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/main.go) (Pipeline dashboard), [`career-ops/data`](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/data) (Application pipeline), [`career-ops/dashboard/internal/data/career.go`](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/data/career.go) (Tracker parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_job_flow["Job Search Flow"]
  node_job_modes["Job modes"]
  node_job_scanner["Job scanner<br/>[scan.mjs]"]
  node_application_pipeline[("Application pipeline")]
  node_batch_flow["Batch workflow"]
  node_followup["Follow-up cadence"]
  node_interview_prep["Interview preparation<br/>[interview-prep.md]"]
end

subgraph group_career_materials["Career Materials"]
  node_cv_templates["CV templates"]
  node_document_export["Document export<br/>[generate-pdf.mjs]"]
  node_word_export["Word export<br/>[generate-word.mjs]"]
end

subgraph group_tracking_insights["Tracking &amp; Insights"]
  node_tracker_data["Tracker parsing<br/>[career.go]"]
  node_application_model["Career metrics<br/>[career.go]"]
  node_reports["Evaluation reports"]
  node_pattern_analysis["Pattern analysis"]
  node_tracker_health["Tracker checks"]
end

subgraph group_interfaces["Agent &amp; Dashboard Interfaces"]
  node_agent_commands["Agent commands<br/>[SKILL.md]"]
  node_tracker_dashboard["Pipeline dashboard<br/>[main.go]"]
  node_pipeline_screen["Pipeline screen<br/>[pipeline.go]"]
  node_progress_screen["Progress screen<br/>[progress.go]"]
  node_report_viewer["Report viewer<br/>[viewer.go]"]
end

node_user(("Job seeker"))
node_job_boards{{"Job board APIs"}}
node_external_ai{{"AI assistants"}}

node_user -->|"starts tasks"| node_agent_commands
node_agent_commands -->|"offers workflows"| node_job_modes
node_user -->|"runs scan"| node_job_scanner
node_job_scanner -->|"fetches listings"| node_job_boards
node_job_scanner -->|"records discoveries"| node_application_pipeline
node_job_modes -.->|"guides tasks"| node_external_ai
node_job_modes -->|"tracks applications"| node_application_pipeline
node_job_modes -->|"produces evaluations"| node_reports
node_batch_flow -->|"supports bulk tracking"| node_application_pipeline
node_tracker_dashboard -->|"loads and updates"| node_tracker_data
node_tracker_data -->|"reads tracker"| node_application_pipeline
node_tracker_data -->|"reads summaries"| node_reports
node_tracker_data -->|"computes metrics"| node_application_model
node_tracker_dashboard -->|"builds views"| node_application_model
node_tracker_dashboard -->|"dispatches pipeline"| node_pipeline_screen
node_tracker_dashboard -->|"dispatches progress"| node_progress_screen
node_tracker_dashboard -->|"opens reports"| node_report_viewer
node_pipeline_screen -->|"requests status changes"| node_tracker_dashboard
node_pattern_analysis -->|"analyzes outcomes"| node_application_pipeline
node_pattern_analysis -->|"extracts dimensions"| node_reports
node_tracker_health -->|"validates entries"| node_application_pipeline
node_tracker_health -->|"checks links"| node_reports
node_job_modes -->|"supports follow-up"| node_followup
node_job_modes -->|"offers preparation"| node_interview_prep
node_cv_templates -->|"supplies layouts"| node_document_export
node_cv_templates -->|"supplies layouts"| node_word_export
node_job_modes -->|"supports tailoring"| node_cv_templates

click node_agent_commands "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/.claude/skills/career-ops/SKILL.md"
click node_job_modes "https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/modes"
click node_job_scanner "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/scan.mjs"
click node_application_pipeline "https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/data"
click node_batch_flow "https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/batch"
click node_tracker_dashboard "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/main.go"
click node_tracker_data "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/data/career.go"
click node_application_model "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/model/career.go"
click node_pipeline_screen "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/pipeline.go"
click node_progress_screen "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/progress.go"
click node_report_viewer "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/viewer.go"
click node_reports "https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/reports"
click node_pattern_analysis "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/analyze-patterns.mjs"
click node_tracker_health "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/verify-pipeline.mjs"
click node_followup "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/followup-cadence.mjs"
click node_interview_prep "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/modes/interview-prep.md"
click node_cv_templates "https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/templates"
click node_document_export "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/generate-pdf.mjs"
click node_word_export "https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/generate-word.mjs"

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_job_modes,node_job_scanner,node_application_pipeline,node_batch_flow,node_followup,node_interview_prep toneBlue
class node_cv_templates,node_document_export,node_word_export toneAmber
class node_tracker_data,node_application_model,node_reports,node_pattern_analysis,node_tracker_health,node_job_boards toneMint
class node_agent_commands,node_tracker_dashboard,node_pipeline_screen,node_progress_screen,node_report_viewer toneRose
class node_user,node_external_ai toneIndigo
```

## Components

### Job Search Flow

- [Job modes](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/modes): `career-ops/modes`
- [Job scanner](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/scan.mjs): `career-ops/scan.mjs`
- [Application pipeline](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/data): `career-ops/data`
- [Batch workflow](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/batch): `career-ops/batch`
- [Follow-up cadence](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/followup-cadence.mjs): `career-ops/followup-cadence.mjs`
- [Interview preparation](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/modes/interview-prep.md): `career-ops/modes/interview-prep.md`

### Career Materials

- [CV templates](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/templates): `career-ops/templates`
- [Document export](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/generate-pdf.mjs): `career-ops/generate-pdf.mjs`
- [Word export](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/generate-word.mjs): `career-ops/generate-word.mjs`

### Tracking & Insights

- [Tracker parsing](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/data/career.go): `career-ops/dashboard/internal/data/career.go`
- [Career metrics](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/model/career.go): `career-ops/dashboard/internal/model/career.go`
- [Evaluation reports](https://github.com/kumbham8888/career-ops-job-hunting/tree/master/career-ops/reports): `career-ops/reports`
- [Pattern analysis](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/analyze-patterns.mjs): `career-ops/analyze-patterns.mjs`
- [Tracker checks](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/verify-pipeline.mjs): `career-ops/verify-pipeline.mjs`

### Agent & Dashboard Interfaces

- [Agent commands](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/.claude/skills/career-ops/SKILL.md): `career-ops/.claude/skills/career-ops/SKILL.md`
- [Pipeline dashboard](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/main.go): `career-ops/dashboard/main.go`
- [Pipeline screen](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/pipeline.go): `career-ops/dashboard/internal/ui/screens/pipeline.go`
- [Progress screen](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/progress.go): `career-ops/dashboard/internal/ui/screens/progress.go`
- [Report viewer](https://github.com/kumbham8888/career-ops-job-hunting/blob/master/career-ops/dashboard/internal/ui/screens/viewer.go): `career-ops/dashboard/internal/ui/screens/viewer.go`

### Other components

- **Job seeker**
- **Job board APIs**
- **AI assistants**

## Connections

- Job seeker → Agent commands: starts tasks
- Agent commands → Job modes: offers workflows
- Job seeker → Job scanner: runs scan
- Job scanner → Job board APIs: fetches listings
- Job scanner → Application pipeline: records discoveries
- Job modes → AI assistants: guides tasks
- Job modes → Application pipeline: tracks applications
- Job modes → Evaluation reports: produces evaluations
- Batch workflow → Application pipeline: supports bulk tracking
- Pipeline dashboard → Tracker parsing: loads and updates
- Tracker parsing → Application pipeline: reads tracker
- Tracker parsing → Evaluation reports: reads summaries
- Tracker parsing → Career metrics: computes metrics
- Pipeline dashboard → Career metrics: builds views
- Pipeline dashboard → Pipeline screen: dispatches pipeline
- Pipeline dashboard → Progress screen: dispatches progress
- Pipeline dashboard → Report viewer: opens reports
- Pipeline screen → Pipeline dashboard: requests status changes
- Pattern analysis → Application pipeline: analyzes outcomes
- Pattern analysis → Evaluation reports: extracts dimensions
- Tracker checks → Application pipeline: validates entries
- Tracker checks → Evaluation reports: checks links
- Job modes → Follow-up cadence: supports follow-up
- Job modes → Interview preparation: offers preparation
- CV templates → Document export: supplies layouts
- CV templates → Word export: supplies layouts
- Job modes → CV templates: supports tailoring