cv-tailor

CV Tailor

Generate tailored application materials in a repeatable, review-first workflow.

Required Inputs

• Company
• Role title
• Job description URL or pasted JD text

If JD text is thin, fetch it via URL or request pasted text before continuing.

Execution Standard

Follow references/repeatable-sop.md.

Key defaults:

1. Two-phase pipeline: Python prep → Claude analysis → Python apply.
2. Select base CV via scripts/select_base_cv.py (closest prior or Master CV fallback).
3. Validate analysis schema before generation (hard fail on invalid input).
4. Prefer formatting-safe in-place edits; do not full-rebuild resume by default.
5. Preserve dates/company names and core structure unless user asks otherwise.
6. Output artifacts + explicit change summary every run.

Workflow

Phase 1 -- Prep (Python)

Get the job description from the user. If they provide a URL, fetch it via WebFetch. If they paste text, use it directly. Write the JD text to a temp file yourself. The user should never create temp files.

# Write JD to temp file (you do this, not the user)
# Then run prep:
uv run cv-tailor/scripts/run_pipeline.py --phase prep --company "Acme" --role "AI PM" --jd-path /path/you/created.txt

Selects base CV, reads it, writes data/pending-analysis.json.

Phase 2 -- Analysis (Claude)

Report progress: "Reading JD... Analyzing against your resume..."

Read data/pending-analysis.json. It contains:

• base_cv_paragraphs -- exact strings from the base resume
• jd_text -- job description
• instructions -- what to do
• output_schema -- required output format

Produce targeted edits where old is an exact match to a paragraph in base_cv_paragraphs. Write results to data/analysis.json.

Report: "Planning X bullet edits, summary rewrite, Y-paragraph cover letter."

Preview Before Apply

Before running the apply phase, present a summary to the user:

"I'll edit X bullets, rewrite your summary, and write a Y-paragraph cover letter. Here's what changes:

• [Brief summary of each bullet edit]
• [Summary change]
• [Cover letter approach]