# Resume Source Map

Use `jobs-resume-studio/` as the resume repo unless the user names another path.
Treat the repo as the source of truth.

## Canonical sources

- `jobs-resume-studio/resume_vault.json`: explicitly approved achievements
- `jobs-resume-studio/resume_workflow_state.json`: draft, content-approved, and
  rendered-final source state
- `jobs-resume-studio/resume_library_db.json`: generated search corpus,
  including unapproved drafts
- `jobs-resume-studio/resumes/source_library.md`
- `jobs-resume-studio/resumes/resume_master_2026.md`
- `jobs-resume-studio/resume_library_inventory.json`

Do not treat the broad library as evidence that a bullet was approved. Check
`approval_status` and the canonical vault.

## Tailored resumes

Tailored markdown lives under:

```text
jobs-resume-studio/resumes/<company_or_role>/<YYYY-MM-DD>/...md
```

Job descriptions and role-radar intake live under:

```text
jobs-resume-studio/job-descriptions/<company_or_role>/<YYYY-MM-DD>/jd.md
```

Use filenames like:

```text
darsh_shah_<company>_<role>_resume_<YYYY-MM-DD>.md
```

Final rendered files live under:

```text
jobs-resume-studio/final resumes/<YYYY-MM-DD>/<Company>/<Role>/...docx
jobs-resume-studio/final resumes/<YYYY-MM-DD>/<Company>/<Role>/...pdf
```

Completion history:

```text
jobs-resume-studio/resumes/resume_completion_log.md
```

## Tools in repo

- DOCX renderer: `jobs-resume-studio/scripts/generate_resume_docx.js`
- Orphan-tail layout QA: `jobs-resume-studio/scripts/check_bullet_wrapping.py`
- Page-fill QA: `jobs-resume-studio/scripts/check_page_fill.py`
- Library builders/indexers:
  - `jobs-resume-studio/scripts/build_resume_library.py`
  - `jobs-resume-studio/scripts/index_resume_library.py`
- Approval and state tool:
  - `jobs-resume-studio/skills/resume-system/scripts/resume_bank.py`

## Base resume selection

Prefer an existing tailored resume with the closest narrative before starting
from the master resume.

- Finance, GTM, pricing, FP&A, deal desk: start from the latest finance strategy
  variant or a close company/role folder.
- Product, data, usage, analytics, product strategy: start from the closest
  product/data tailored variant.
- Operator, chief of staff, business operations: start from a recent operator or
  strategy variant.
- Accounting, controllership, operations finance: start from a variant that
  already balances finance rigor with operating execution.
- If none fits, start from `resumes/resume_master_2026.md` and pull from the
  vault and source library.

## Reuse-first search

Before drafting, search nearby sources for stronger bullets with the same role,
theme, or JD keywords. Build a quick bench list from:

- the target draft
- approved achievements in `resume_vault.json`
- `resume_master_2026.md`
- `source_library.md`
- `resume_library_db.json`
- prior tailored resumes under `resumes/`

Treat broad-library results as candidates. Rewrite only what needs to change
for fit, accuracy, narrative, or one-page layout, and persist only after
explicit approval.