jobhunt

name

jobhunt

description

Route Job-Hunt job-search tasks in this repository to the correct checked-in mode files and scripts. Use when Codex needs to evaluate a job URL or JD, run the full pipeline, scan portals, generate ATS PDFs, process inbox URLs, review tracker status, compare offers, draft application help, run deep company research, prepare interviews, analyze rejection patterns, or manage follow-up cadence inside this project.

Job Hunt

Route work into the existing Job-Hunt modes and scripts. Do not create a parallel workflow when the repository already contains a mode, script, or template for the task.

Read Order

Read these files in this order when you need project context beyond the immediate mode:

1. AGENTS.md for the startup checklist, onboarding rules, tracker integrity, and operating boundaries.
2. docs/DATA_CONTRACT.md when a change touches user data, reports, tracker entries, or update-safe boundaries.
3. modes/_shared.md for shared workflow rules, then modes/_profile.md for user-specific overrides when the selected mode depends on them.

Read only the mode files needed for the current request. Use docs/ARCHITECTURE.md, docs/SCRIPTS.md, and batch/README.md only when the task needs repo mechanics.

Bootstrap

On first use in a session, follow the AGENTS.md startup checklist and silently run:

node scripts/update-system.mjs check

If an update is available, tell the user the exact local and remote versions and ask before applying it.

Before substantial Job-Hunt work, verify these files:

• profile/cv.md (legacy root cv.md also accepted during migration)
• config/profile.yml