Resume Repository

Single-source LaTeX resume project for Alice Huston, with local build tooling and automated CI workflows.

Repository Layout

• resume.tex: source of truth for resume content and formatting.
• flake.nix: reproducible Nix environment and PDF build derivation.
• .github/prompts/resume-review.prompt.md: structured prompt used for automated review.
• .github/workflows/: CI automation for build, checks, and review PRs.
• archive/: historical outputs (including automated review notes).

Build Locally

Option 1: Nix (recommended)

Build the canonical artifact:

nix build .#default

Output PDF:

• result/Alice_Huston_Resume_Software_Engineer.pdf

Option 2: latexmk

latexmk -pdf resume.tex

Output PDF:

• resume.pdf

Option 3: pdflatex

pdflatex resume.tex

Run pdflatex multiple times if references/layout need to settle.

Development Shell

Enter the Nix development shell (includes TeX tooling):

nix develop

Clean Build Artifacts

latexmk -c

CI / Automation

• build-resume.yaml

  • Builds resume PDF on push to main when resume.tex or workflow file changes.
  • Publishes the PDF as an artifact and creates a release.

• flake-health-checks.yml

  • Runs nix flake check on pushes and pull requests.

• lock-health-checks.yml

  • Validates health of flake.lock.

• flake-update.yml

  • Scheduled lockfile update workflow that opens a PR.

• daily-resume-review.yml

  • Runs daily and on manual dispatch.
  • Builds resume, sends prompt + source to an LLM review agent, writes review output to archive/reviews/.
  • Opens a PR only if the newly generated review differs from the most recent prior review.

Secrets for Automation

Set these repository secrets for workflows that open PRs or call the model API:

• GH_TOKEN_FOR_UPDATES: token used by PR automation.
• OPENAI_API_KEY: API key for daily review workflow.

Optional environment variables:

• OPENAI_BASE_URL (default: https://api.openai.com/v1)
• OPENAI_MODEL (default: gpt-5)

Notes

• Generated files (*.aux, *.log, *.fdb_latexmk, *.fls, *.pdf, etc.) are ignored by Git.
• PDFs are configured for Git LFS via .gitattributes.