A one-page Typst resume with JSON-backed content, a shared parser-friendly renderer, controlled extraction fixtures, and project-local Codex review skills.
will_cygan_resume-data.jsoncontains the resume content.will_cygan_resume.typloads the JSON and invokes the shared renderer.tests/fixtures/golden-resume/golden-resume-template.typis the renderer.will_cygan_resume.pdfis the final artifact to inspect.
Supporting work history lives in work-experience/. It is raw evidence and
may contain additional, draft, or in-flight material not present in the final
resume.
Install Typst, Poppler, Tika, qpdf, and uv for the complete local workflow.
The pinned Source Sans 3 font cuts are already under fonts/source-sans-3/.
just compile
just page-budget
just extraction-check
just testUse just dev for a watched local preview.
Use one ordered validation plan for change acceptance; GitHub Actions runs the
same full plan. The individual just commands above remain available when
diagnosing a specific failed check.
| Change scope | Command | Ordered checks |
|---|---|---|
| Resume content | just validate-content |
compile, page budget, extraction check |
| Shared renderer | just validate-renderer |
content checks, Golden compile/provenance, Golden deep check, Golden stress matrix |
| Repository-wide / CI | just validate-full |
content checks, tests, Golden compile/provenance, Golden deep check, Golden stress matrix |
The plan reports where to inspect durable local evidence after a failure:
artifact provenance is under .extraction/artifact-provenance/, extraction
reports are under .extraction/, and Golden evidence is under
.extraction/golden-resume*/. These are local mechanical checks; they do not
establish commercial ATS behavior or hiring outcomes.
$resume-reviewreviews and tailors content against documented evidence.$resume-parsabilityevaluates PDF extraction, field associations, structure, links, fonts, and controlled layout behavior.
The parsability checks are local evidence. They do not reproduce a commercial ATS, certify screen-reader behavior, or predict hiring outcomes.
The controlled reference bundle lives under
tests/fixtures/golden-resume/. It includes anonymous data, source, a
reviewed oracle, a compiled PDF, a stress manifest, and the shared renderer.
just golden-check
just golden-stressReports and rendered evidence are written beneath .extraction/, which is
gitignored.