| name | joblit |
| description | Use when working in the Joblit repo (joblit) or when discussing job fetch (JobSpy/LinkedIn/Seek/CN platforms), resume/cover tailoring, prompt rules/skill pack, or PDF export. |
Joblit (joblit)
Job-search command center: fetch → triage → tailor CV/CL → export PDFs.
When to Use
- You are in the
ShousenZHANG/joblit repo, or the user mentions Joblit/joblit.
- The task involves job intake (JobSpy/LinkedIn, Seek manual add, CN platforms), prompt rules/skill pack, CV/CL generation, batch workflows, or PDF export.
When NOT to Use
- For repositories other than joblit (joblit-tailoring pack is for Joblit import only).
- When the task is generic job-search advice with no code or Joblit workflow involved.
Mental Model
- Intake
- AU: FetchRun → GitHub Actions → Python JobSpy → import jobs (dedupe + tombstones)
- CN: FetchRun → GitHub Actions → Python CN fetcher → import jobs
- Workspace: Jobs list + detail, search/filter, status
NEW/APPLIED/REJECTED
- Tailoring: prompt → external model → strict JSON import → LaTeX render → PDF
Key Paths (start here)
- UI pages:
app/(app)/ (jobs, fetch, resume, resume/rules)
- API routes:
app/api/ (jobs, fetch-runs, applications, application-batches, prompt-rules, admin/import)
- Server modules:
lib/server/ (AI prompts, LaTeX/PDF, persistence)
- Fetch workers: AU via
tools/fetcher/run_jobspy.py (GitHub Actions);
CN via lib/server/cnFetch/ (in-process, Vercel cron)
- Schema:
prisma/schema.prisma
More: references/PATHS.md and references/FLOWS.md.
Non‑Negotiable Rules
- Job dedupe: unique
(userId, jobUrl); normalize with canonicalizeJobUrl().
- Manual generate: never call
manual-generate without the matching promptMeta from the prompt response.
- Batch run: do not use
/trigger for Codex/batch execution (disabled by design); follow AGENTS.md.
Common Mistakes
- Calling
POST /api/applications/manual-generate without the matching promptMeta from the prompt response → import will reject with 409; always use prompt API first and pass its promptMeta into manual-generate.
- Assuming job URL is already normalized → use
canonicalizeJobUrl() before dedupe checks or storage.
- Using batch trigger for Codex/automation → trigger is disabled; follow
AGENTS.md for batch flows.
