# bluebug53/seekter architecture

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

- Interactive diagram: https://gitdiagram.com/bluebug53/seekter
- Repository: https://github.com/bluebug53/seekter

## Overview

Seekter is a Claude Code job-search agent. Its main workflow configures a personal profile, searches job sources, filters and deduplicates postings, then fills suitable applications in the user’s Chrome and records outcomes in a Markdown tracker. Separate commands log replies and produce funnel reports; users can also import an existing tracker. The graph follows README-documented behavior and the sampled scripts; skill files and other runtime subsystems were not excerpted, so their internal calls are not inferred.

Main entry points: [`.claude/skills/seekter-run/SKILL.md`](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-run/SKILL.md) (Daily run), [`scripts/seekter.py`](https://github.com/bluebug53/seekter/blob/main/scripts/seekter.py) (Tracker operations), [`applications`](https://github.com/bluebug53/seekter/tree/main/applications) (Application tracker), [`.claude/skills/seekter-log/SKILL.md`](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-log/SKILL.md) (Outcome logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Profile setup"]
  node_init["Profile interview<br/>[SKILL.md]"]
  node_profile["Search profile"]
end

subgraph group_search["Search and apply"]
  node_run["Daily run<br/>[SKILL.md]"]
  node_sources["Job sources"]
  node_freehire["Freehire sweep<br/>[freehire_sweep.py]"]
  node_eligibility["Posting filters<br/>[SKILL.md]"]
  node_ats["ATS guidance"]
end

subgraph group_tracking["Application tracking"]
  node_applications[("Application tracker")]
  node_tracker["Tracker operations<br/>[seekter.py]"]
  node_csv["CSV importer<br/>[import_csv.py]"]
end

subgraph group_insights["Follow-up and reporting"]
  node_log["Outcome logging<br/>[SKILL.md]"]
  node_report["Funnel report<br/>[SKILL.md]"]
  node_runs["Run records"]
end

subgraph group_maintenance["Kit maintenance"]
  node_git["Shareable-kit shipping<br/>[SKILL.md]"]
end

node_user(("Job seeker"))
node_chrome["Chrome browser"]
node_inbox["Webmail inbox"]

node_user -->|"answers questions"| node_init
node_init -->|"writes profile"| node_profile
node_user -->|"starts search"| node_run
node_run -->|"uses settings"| node_profile
node_run -->|"searches sources"| node_sources
node_freehire -->|"reads queries"| node_profile
node_freehire -->|"checks duplicates"| node_tracker
node_run -->|"runs sweep"| node_freehire
node_run -->|"filters postings"| node_eligibility
node_run -->|"deduplicates postings"| node_tracker
node_run -->|"consults guidance"| node_ats
node_run -->|"fills forms"| node_chrome
node_run -->|"records outcomes"| node_applications
node_tracker -->|"reads and writes"| node_applications
node_csv -->|"imports records"| node_tracker
node_tracker -->|"saves imported records"| node_applications
node_user -->|"reports outcomes"| node_log
node_log -->|"reads replies"| node_inbox
node_log -->|"updates tracker"| node_applications
node_user -->|"requests report"| node_report
node_report -->|"reads tracker"| node_applications
node_report -->|"reads run records"| node_runs
node_user -->|"ships kit"| node_git

click node_init "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-init/SKILL.md"
click node_profile "https://github.com/bluebug53/seekter/tree/main/profile"
click node_run "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-run/SKILL.md"
click node_sources "https://github.com/bluebug53/seekter/tree/main/reference/sources"
click node_freehire "https://github.com/bluebug53/seekter/blob/main/scripts/freehire_sweep.py"
click node_eligibility "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-run/SKILL.md"
click node_ats "https://github.com/bluebug53/seekter/tree/main/reference/ats"
click node_applications "https://github.com/bluebug53/seekter/tree/main/applications"
click node_tracker "https://github.com/bluebug53/seekter/blob/main/scripts/seekter.py"
click node_csv "https://github.com/bluebug53/seekter/blob/main/scripts/import_csv.py"
click node_log "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-log/SKILL.md"
click node_report "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-report/SKILL.md"
click node_runs "https://github.com/bluebug53/seekter/tree/main/runs"
click node_git "https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-git/SKILL.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_init,node_profile,node_chrome toneBlue
class node_run,node_sources,node_freehire,node_eligibility,node_ats toneAmber
class node_applications,node_tracker,node_csv toneMint
class node_log,node_report,node_runs toneRose
class node_git,node_user,node_inbox toneIndigo
```

## Components

### Profile setup

- [Profile interview](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-init/SKILL.md): `.claude/skills/seekter-init/SKILL.md`
- [Search profile](https://github.com/bluebug53/seekter/tree/main/profile): `profile`

### Search and apply

- [Daily run](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-run/SKILL.md): `.claude/skills/seekter-run/SKILL.md`
- [Job sources](https://github.com/bluebug53/seekter/tree/main/reference/sources): `reference/sources`
- [Freehire sweep](https://github.com/bluebug53/seekter/blob/main/scripts/freehire_sweep.py): `scripts/freehire_sweep.py`
- [Posting filters](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-run/SKILL.md): `.claude/skills/seekter-run/SKILL.md`
- [ATS guidance](https://github.com/bluebug53/seekter/tree/main/reference/ats): `reference/ats`

### Application tracking

- [Application tracker](https://github.com/bluebug53/seekter/tree/main/applications): `applications`
- [Tracker operations](https://github.com/bluebug53/seekter/blob/main/scripts/seekter.py): `scripts/seekter.py`
- [CSV importer](https://github.com/bluebug53/seekter/blob/main/scripts/import_csv.py): `scripts/import_csv.py`

### Follow-up and reporting

- [Outcome logging](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-log/SKILL.md): `.claude/skills/seekter-log/SKILL.md`
- [Funnel report](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-report/SKILL.md): `.claude/skills/seekter-report/SKILL.md`
- [Run records](https://github.com/bluebug53/seekter/tree/main/runs): `runs`

### Kit maintenance

- [Shareable-kit shipping](https://github.com/bluebug53/seekter/blob/main/.claude/skills/seekter-git/SKILL.md): `.claude/skills/seekter-git/SKILL.md`

### Other components

- **Job seeker**
- **Chrome browser**
- **Webmail inbox**

## Connections

- Job seeker → Profile interview: answers questions (evidence: `README.md`)
- Profile interview → Search profile: writes profile (evidence: `README.md`)
- Job seeker → Daily run: starts search (evidence: `README.md`)
- Daily run → Search profile: uses settings (evidence: `README.md`)
- Daily run → Job sources: searches sources (evidence: `README.md`)
- Freehire sweep → Search profile: reads queries (evidence: `scripts/freehire_sweep.py`)
- Freehire sweep → Tracker operations: checks duplicates (evidence: `scripts/freehire_sweep.py`)
- Daily run → Freehire sweep: runs sweep (evidence: `README.md`)
- Daily run → Posting filters: filters postings (evidence: `README.md`)
- Daily run → Tracker operations: deduplicates postings (evidence: `README.md`)
- Daily run → ATS guidance: consults guidance (evidence: `README.md`)
- Daily run → Chrome browser: fills forms (evidence: `README.md`)
- Daily run → Application tracker: records outcomes (evidence: `README.md`)
- Tracker operations → Application tracker: reads and writes (evidence: `scripts/seekter.py`)
- CSV importer → Tracker operations: imports records (evidence: `scripts/import_csv.py`)
- Tracker operations → Application tracker: saves imported records
- Job seeker → Outcome logging: reports outcomes (evidence: `README.md`)
- Outcome logging → Webmail inbox: reads replies (evidence: `README.md`)
- Outcome logging → Application tracker: updates tracker (evidence: `README.md`)
- Job seeker → Funnel report: requests report (evidence: `README.md`)
- Funnel report → Application tracker: reads tracker (evidence: `README.md`)
- Funnel report → Run records: reads run records (evidence: `README.md`)
- Job seeker → Shareable-kit shipping: ships kit (evidence: `README.md`)
