From 3d8689a56d8ee67cdfa1b36bbad30ac36a2b0b0e Mon Sep 17 00:00:00 2001 From: Lautaro Emanuel Jimenez <132080865+Lautaro073@users.noreply.github.com> Date: Tue, 21 Jul 2026 02:38:03 -0300 Subject: [PATCH] docs(cv): flag hardcoded English section headings for non-English CVs (#200) The moderncv template's section headings (Core Competencies, Professional Experience, Education, Languages, Publications, Honors and Awards, References) and the References boilerplate line are literal English text the workflow never translates, so a CV localized in prose can sit under English scaffolding. Adds an illustrative, fork-aware rule to 05-cv-templates.md (translate the headings too, whatever your template defines) plus a verification-checklist item in CLAUDE.md. Ties into the CV-language profile setting from #179. By @Lautaro073. Heading list corrected against the stock template on review (Publications/Honors and Awards in, non-existent Independent Projects out; made illustrative for forks). --- .claude/skills/job-application-assistant/05-cv-templates.md | 6 +++++- CLAUDE.md | 1 + 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/.claude/skills/job-application-assistant/05-cv-templates.md b/.claude/skills/job-application-assistant/05-cv-templates.md index bfc55d2..38e1813 100644 --- a/.claude/skills/job-application-assistant/05-cv-templates.md +++ b/.claude/skills/job-application-assistant/05-cv-templates.md @@ -1,5 +1,5 @@ --- -framework_version: 1.2.0 +framework_version: 1.2.1 --- # CV Templates and Tailoring Guide @@ -100,6 +100,10 @@ Two related patterns are fine and should be kept: - `\vspace{1pt}` immediately after `\section{...}` (between section heading and first item) - this is between the heading and the list, not between list items. - `\vspace{3pt}` between top-level `\cventry` blocks in Professional Experience or Education - this gives breathing room between roles and renders consistently. +### Section headings must match the CV's language (important) + +Section headings such as `\section{Core Competencies}`, `Professional Experience`, `Education`, `Languages`, `Publications`, `Honors and Awards`, `References` (and any others your template defines), plus the `Available upon request.` line under References, are all **literal English text baked into the template** - they do not translate themselves. Whenever the CV language (see `CV language` in the candidate profile) is not English, translate every one of these too, whatever they are, not just the body prose - a CV with a fully localized profile statement and bullets sitting under untouched English section headers reads as sloppy and inconsistent, and it's an easy thing to forget precisely because the prose translation is the obvious, visible part of the job. Worked example for Spanish: `Competencias Clave`, `Experiencia Profesional`, `Educaci\'on`, `Idiomas`, `Publicaciones`, `Distinciones y Premios`, `Referencias`, `Disponibles a solicitud.` The same rule applies for any other target language - check this explicitly during the verification pass. + ## Section-by-Section Tailoring ### Profile Statement / Elevator Pitch (Best Practice) diff --git a/CLAUDE.md b/CLAUDE.md index 02265a1..d7ce067 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -120,6 +120,7 @@ After creating or updating a CV or cover letter, re-read the generated file and - [ ] Agentic coding / AI tooling references mention **Claude Code** by name - [ ] Cover letter is addressed to the correct person (or "Dear Hiring Manager" if unknown) - [ ] Cover letter fits approximately one page +- [ ] CV section headings (`\section{...}`) and the References boilerplate line match the CV's language, not left as the English template defaults (see `05-cv-templates.md`) ### Compiled PDF verification (MANDATORY - never skip) Both documents MUST be compiled and visually inspected via the Read tool on the PDF output. "Looks fine in the .tex" is not acceptable - LaTeX page-break decisions are unpredictable. Iterate until these all pass: