resume/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a resume builder using Pandoc to convert Markdown resumes with YAML metadata to PDF via LaTeX templates. The build process is containerized using Podman (Docker alternative) for reproducibility and portability.

Build and Development Commands

Build the resume PDF:

# Build default resume
make resume

# Build a custom resume with a specific filename
make resume FILE_NAME=paul-halvorsen-acme-senior-backend-engineer

The FILE_NAME variable defaults to paul-halvorsen-resume but can be overridden to use any markdown file in the directory (without the .md extension). The Makefile will:

1. Build the Podman image if it doesn't exist
2. Convert the markdown file to PDF using the default LaTeX template
3. Output a PDF with the same name as the input markdown file (but with .pdf extension)

Example workflow for custom resumes:

# Create a customized markdown resume
# paul-halvorsen-acme-senior-backend-engineer.md

# Build it
make resume FILE_NAME=paul-halvorsen-acme-senior-backend-engineer

# Output: paul-halvorsen-acme-senior-backend-engineer.pdf

Clean commands:

• make clean - Remove LaTeX log files
• make cleanpaper - Remove the generated PDF (uses FILE_NAME variable)
• make cleanpodman - Remove the Podman image and build cache (forces rebuild next time)
• make cleanall - Remove everything (logs, PDF, and Podman image)

High-Level Architecture

Resume Processing Pipeline

1. Input: Markdown file with YAML metadata block (*.md)
2. Processing: Pandoc converts markdown to LaTeX using a template
3. Output: PDF generated via LaTeX compilation
4. Containerization: All processing happens in a Podman container to ensure consistent output

Key Components

Templates (templates/ directory):

• jb2resume.latex - Default resume template (recommended)
• jb2-modern.latex - Alternative modern template

Both templates are dual-licensed under GPL v2+ and BSD 3-Clause.

Dockerfile:

• Based on pandoc/latex:latest
• Installs additional LaTeX packages: enumitem, sectsty, underscore
• Sets /data as the working volume

Makefile:

• Uses Podman (not Docker)
• FILE_NAME=paul-halvorsen-resume - Change this to build a different .md file
• USER=paul - Container user for file permissions
• Automatically detects if the Podman image needs rebuilding

Resume Structure

YAML Metadata Block (top of .md file):

---
name: [Your Name]
keywords: [comma-separated keywords for PDF metadata]
left-column:
    - [Line 1 for left column under name]
    - [Line 2 for left column]
right-column:
    - [Line 1 for right column under name]
    - [Line 2 for right column]
fontsize: [default 10pt]
fontenc: [default T1]
urlcolor: [default blue]
linkcolor: [default magenta]
numbersections: [true/false, controls section numbering]
name-color: [SVG color name like DarkSlateGray, applies to name]
section-color: [SVG color name like Tomato, applies to section headers]
---

The metadata block is required and must appear at the very top of the markdown file before any content.

Resume Content: Standard Markdown after the metadata block. Headers become sections, lists are formatted naturally.

Multiple Resume Versions

The repository contains two main resume files:

• paul-halvorsen-resume.md - Concise version (built by default via Makefile)
• paul-halvorsen-resume-detailed.md - Extended version with more details

To build a different version, either:

1. Modify the FILE_NAME variable in the Makefile, or
2. Run Pandoc directly with the desired input file

Important Notes

• The Makefile assumes Podman is installed and available
• Build output (.pdf files) and Podman artifacts (.podman-build file) are not tracked in git
• The .podman-build marker file prevents unnecessary image rebuilds (remove it to force rebuild)
• All LaTeX processing happens inside the container; no local LaTeX installation is needed

Creating Customized Resumes for Job Applications

The detailed resume (paul-halvorsen-resume-detailed.md) contains comprehensive information across all roles and projects. To create a customized resume for a specific job application:

1. Get job description - Copy the job posting or description

2. Provide to Claude Code - Share the job description with Claude Code along with a request to create a customized resume

3. Output format - Claude will create a new markdown file using the naming convention:

   paul-halvorsen-[company-name]-[role-title].md
   

   Example: paul-halvorsen-stripe-senior-rust-engineer.md

4. Build the PDF - Generate the PDF using:

   make resume FILE_NAME=paul-halvorsen-stripe-senior-rust-engineer
   

5. Expected result - A 1-2 page resume tailored to the job requirements with:

   • Reordered work experience (most relevant roles first)
   • Emphasized skills and metrics matching the job description
   • Highlighted relevant accomplishments and projects
   • Customized summary/intro focused on the role

The detailed resume includes proficiency levels, performance metrics, specializations, and comprehensive technical details that allow Claude Code to intelligently match your background to specific job requirements.