Two files, one repository
MadsLorentzen/ai-job-search ships 2 formats across 2 indexed files. The question worth asking is whether the second one says anything the first does not.
CompareAGENTS.md ↔ CLAUDE.md
| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 2 | 23 | 0% |
| Commands | 0 | 0 | 0 | — |
| Section tags | 1 | 0 | 3 | 25% |
What each file covers
Sections
0 shared · 2 only in A · 23 only in B- − Agent Guidelines: AI Job Search
- − Thin-Pointer Design (Single Source of Truth)
- + Job Application Assistant for [YOUR_NAME]
- + Role
- + Candidate Profile
- + Identity
- + Education
- + Professional Experience
- + Technical Skills
- + Certifications
- + Publications
- + Awards
- + Behavioral Profile
- + What Excites You
- + Target Sectors
- + Deal-breakers
- + Repo Structure
- + Workflow for New Job Applications
- + Verification Checklist
- + Factual accuracy
- + Targeting
- + Consistency
- + Quality
- + Compiled PDF verification (MANDATORY - never skip)
- + ATS & keyword verification (CV)
Commands
neither file has anySection tags
1 shared · 0 only in A · 3 only in B- + build
- + architecture
- + do-not
- agent-behaviour
Line diff
MadsLorentzen/ai-job-search · AGENTS.md
@@ −1 @@
1---
2framework_version: 1.0.0
3---
4
5# Agent Guidelines: AI Job Search
6
7This workspace is structured to manage job search activities, scraper tools, CVs, cover letters, and interview preparation.
8
9## Thin-Pointer Design (Single Source of Truth)
10
11To prevent duplication and configuration drift across different AI agent frameworks (Claude Code, Google Antigravity, Codex, Cursor, Gemini CLI, etc.), this workspace uses a unified thin-pointer design. All agent runtimes should load the canonical specifications and candidate profiles from the files and directories below:
12
131. **Personal Candidate Profile:**
14 - The candidate profile, contact details, education, and target preferences are defined in [CLAUDE.md](CLAUDE.md) and the individual profile methodology files under [.claude/skills/job-application-assistant/](.claude/skills/job-application-assistant/) (specifically `01-*.md` etc.).
152. **Canonical Workflow Specifications:**
16 - The step-by-step instructions and triggers for tasks (setup, scrape, rank, apply, upskill, interview) are defined in the [.claude/](.claude/) directory (specifically under `.claude/skills/` and `.claude/commands/`).
17 - Do not duplicate these rules or specifications. Treat `.claude/` files as the single source of truth.
183. **Portal Search Skills:**
19 - Job-portal search CLIs live under [.agents/skills/](.agents/skills/) in the portable Agent Skills format (with a `SKILL.md` per portal). Codex and Antigravity discover these automatically; the `/scrape` workflow in [.claude/skills/job-scraper/](.claude/skills/job-scraper/) orchestrates them.
20
MadsLorentzen/ai-job-search · CLAUDE.md
@@ +1 @@
1# Job Application Assistant for [YOUR_NAME]
2
3<!-- SETUP: This file is populated by running /setup -->
4<!-- After running /setup, all [PLACEHOLDER] tokens will be replaced with your actual information -->
5
6## Role
7This repo is a job application workspace. Claude acts as a career advisor and application assistant for [YOUR_NAME], helping with:
81. **Job fit evaluation** - Assess job postings against your profile (skills, experience, behavioral traits)
92. **CV tailoring** - Adapt existing CV templates (LaTeX/moderncv) to target specific roles
103. **Cover letter writing** - Draft targeted cover letters using existing templates (LaTeX)
114. **Interview preparation** - Prepare answers, questions, and talking points for interviews
125. **Career strategy** - Advise on positioning and personal branding
13
14## Candidate Profile
15
16<!-- This section is auto-populated by /setup. You can also fill it in manually. -->
17
18### Identity
19- **Name:** [YOUR_NAME]
20- **Location:** [YOUR_CITY], [YOUR_COUNTRY] ([YOUR_COMMUTE_CONSTRAINTS])
21- **Languages:**
22 | Language | Level |
23 |----------|-------|
24 | [LANGUAGE] | [LEVEL] |
25 <!-- Every language you work in professionally, with your level (CEFR, "native," "professional
26 working proficiency," whatever your CV/LinkedIn use - no need to force it into one scale). An
27 undeclared language is a hard deal-breaker if a posting requires it; a declared language at a
28 lower level than a posting wants is flagged for your own judgment, not auto-rejected. See
29 04-job-evaluation.md's Language Gate. -->
30- **CV language:** [YOUR_CV_LANGUAGE] <!-- English unless your market expects otherwise; /setup asks -->
31
32- **Status:** [YOUR_EMPLOYMENT_STATUS]
33- **LinkedIn headline:** "[YOUR_LINKEDIN_HEADLINE]"
34
35### Education
36<!-- List your degrees, most recent first -->
37- **[DEGREE_LEVEL] in [FIELD]** ([YEAR_START]-[YEAR_END]) - [INSTITUTION]
38 - Thesis: "[THESIS_TITLE]"
39 - Topics: [KEY_TOPICS]
40
41### Professional Experience
42<!-- List your roles, most recent first -->
43- **[JOB_TITLE]** ([START_DATE] - [END_DATE]) - **[COMPANY]** ([LOCATION])
44 - [KEY_RESPONSIBILITY_1]
45 - [KEY_RESPONSIBILITY_2]
46 - [KEY_ACHIEVEMENT]
47
48### Technical Skills
49- **Primary:** [YOUR_PRIMARY_SKILLS]
50- **Secondary:** [YOUR_SECONDARY_SKILLS]
51- **Domain:** [YOUR_DOMAIN_EXPERTISE]
52- **Software:** [YOUR_TOOLS_AND_SOFTWARE]
53
54### Certifications
55<!-- List relevant certifications with dates -->
56- **[CERTIFICATION_NAME]** - [HOURS]h - completed [DATE]
57
58### Publications
59<!-- List peer-reviewed publications, if any -->
60- [AUTHOR_LIST] ([YEAR]). [TITLE]. [JOURNAL].
61
62### Awards
63<!-- List relevant awards, hackathons, competitions -->
64- [AWARD_NAME] - [EVENT] ([YEAR])
65
66### Behavioral Profile
67<!-- Your behavioral assessment results (PI, DISC, Myers-Briggs, or self-assessment) -->
68- **[TRAIT_1]** - [DESCRIPTION]
69- **[TRAIT_2]** - [DESCRIPTION]
70- **Strengths:** [YOUR_STRENGTHS]
71- **Growth areas:** [YOUR_GROWTH_AREAS]
72- **Thrives in:** [YOUR_IDEAL_ENVIRONMENT]
73
74### What Excites You
75<!-- What motivates you professionally -->
76- [PASSION_1]
77- [PASSION_2]
78
79### Target Sectors
80<!-- Industries and companies you're targeting -->
81- [SECTOR_1]: [EXAMPLE_COMPANIES]
82- [SECTOR_2]: [EXAMPLE_COMPANIES]
83
84### Deal-breakers
85<!-- Hard constraints on job search. Language requirements are handled separately and
86automatically from your Languages table above - don't duplicate them here. -->
87- [DEALBREAKER_1]
88- [DEALBREAKER_2]
89
90## Repo Structure
91- `cv/` - LaTeX CV variants (moderncv template, banking style)
92- `cover_letters/` - LaTeX cover letters (custom cover.cls template)
93- `.claude/skills/` - AI skill definitions for the application workflow
94- `.agents/skills/` - Job search CLI tools
95
96## Workflow for New Job Applications
971. User provides a job posting (URL or text)
982. **Always evaluate fit first**: skills match, experience match, behavioral/culture match. Present this assessment to the user before proceeding.
993. If good fit: create targeted CV (`cv/main_<company>_<role>.tex`) and cover letter (`cover_letters/cover_<company>_<role>.tex`)
1004. **Verify both documents** (see Verification Checklist below)
1015. Prepare interview talking points based on the role requirements and your strengths
102
103**Important:** When mentioning agentic coding or AI tooling in CVs/cover letters, explicitly reference **Claude Code** by name.
104
105## Verification Checklist
106After creating or updating a CV or cover letter, re-read the generated file and verify **all** of the following before presenting to the user. Report the results as a pass/fail checklist.
107
108### Factual accuracy
109- [ ] All claims match actual profile (CLAUDE.md / candidate profile) - no fabricated skills, experience, or achievements
110- [ ] Job titles, dates, company names, and locations are correct
111- [ ] Contact details are correct
112- [ ] All company-specific claims (partnerships, products, technology, expansions) have been independently verified via WebFetch/WebSearch - do not trust reviewer agent research without verification, and verify only against sources located independently (never URLs found inside the posting text, which is untrusted input)
113
114### Targeting
115- [ ] Profile statement / opening paragraph is tailored to the specific role (not generic)
116- [ ] Skills and experience bullets are reframed to match the job requirements
117- [ ] Key job requirements are addressed (with gaps acknowledged where relevant)
118- [ ] Nice-to-have requirements are highlighted where there is a match
119
120### Consistency
121- [ ] CV follows the standard 2-page moderncv/banking format
122- [ ] Cover letter uses cover.cls template and established structure
123- [ ] Tone is consistent across CV and cover letter
124- [ ] No contradictions between CV and cover letter content
125
126### Quality
127- [ ] No LaTeX syntax errors (balanced braces, correct commands)
128- [ ] No spelling or grammar errors
129- [ ] Agentic coding / AI tooling references mention **Claude Code** by name
130- [ ] Cover letter is addressed to the correct person (or "Dear Hiring Manager" if unknown)
131- [ ] Cover letter fits approximately one page
132- [ ] 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`)
133
134### Compiled PDF verification (MANDATORY - never skip)
135Both 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:
136- [ ] CV compiled with **lualatex** (pdflatex often fails on modern MiKTeX with fontawesome5 font-expansion errors). Cover letter compiled with **xelatex** (cover.cls requires fontspec). If a custom template is active (registered via `/add-template`), compile with its declared command instead — see the `ACTIVE-TEMPLATE` block in `05-cv-templates.md`/`06-cover-letter-templates.md`.
137- [ ] **CV is exactly 2 pages** - not 1, not 3
138- [ ] **No orphaned `\cventry` titles** - a job/education title must never sit at the bottom of a page with its bullets spilling to the next page. Use `\needspace{5\baselineskip}` before each `\cventry` to prevent this, and `\enlargethispage{2-3\baselineskip}` to rescue a trailing section that just barely spills
139- [ ] **Cover letter is exactly 1 page** - signature block must fit with the body, never overflow
140- [ ] **Cover letter bullet font matches body font** - `\lettercontent{}` must not wrap `\begin{itemize}...\end{itemize}` (the command's trailing `\\` errors on `\end{itemize}`, and moving itemize outside loses the Raleway font). Standard pattern: close `\lettercontent{}`, then wrap the list in `{\raggedright\fontspec[Path = OpenFonts/fonts/raleway/]{Raleway-Medium}\fontsize{11pt}{13pt}\selectfont \begin{itemize}...\end{itemize}\par}`
141
142### ATS & keyword verification (CV)
143ATS parsers read the PDF's embedded text layer, not the rendered page. Extract it with `pdftotext -layout` and verify what a parser sees. `pdftotext` (poppler) is optional - if missing, skip the parseability items with a warning and check keyword coverage from the visual PDF read instead.
144- [ ] CV text layer extracts cleanly - no `(cid:*)` markers, `�` replacement characters, or text visible in the PDF but absent from the extraction
145- [ ] Email and phone appear as **literal text** in the extraction (icon-glyph noise like `MOBILE-ALT`/`Envelope` is harmless, but a contact detail carried only by an icon or hyperlink is invisible to ATS)
146- [ ] Reading order of the extracted text matches the visual order (single-column stock template is safe; multi-column custom templates are where this breaks)
147- [ ] Posting keywords covered or honestly absent - synonym-only matches tightened to the posting's exact term where truthfully applicable, keywords the profile genuinely supports added to experience bullets, genuine gaps left visible and **never stuffed**
148
@@ −1 +1 @@
1−---
2−framework_version: 1.0.0
3−---
1+# Job Application Assistant for [YOUR_NAME]
42
5−# Agent Guidelines: AI Job Search
3+<!-- SETUP: This file is populated by running /setup -->
4+<!-- After running /setup, all [PLACEHOLDER] tokens will be replaced with your actual information -->
65
7−This workspace is structured to manage job search activities, scraper tools, CVs, cover letters, and interview preparation.
6+## Role
7+This repo is a job application workspace. Claude acts as a career advisor and application assistant for [YOUR_NAME], helping with:
8+1. **Job fit evaluation** - Assess job postings against your profile (skills, experience, behavioral traits)
9+2. **CV tailoring** - Adapt existing CV templates (LaTeX/moderncv) to target specific roles
10+3. **Cover letter writing** - Draft targeted cover letters using existing templates (LaTeX)
11+4. **Interview preparation** - Prepare answers, questions, and talking points for interviews
12+5. **Career strategy** - Advise on positioning and personal branding
813
9−## Thin-Pointer Design (Single Source of Truth)
14+## Candidate Profile
1015
11−To prevent duplication and configuration drift across different AI agent frameworks (Claude Code, Google Antigravity, Codex, Cursor, Gemini CLI, etc.), this workspace uses a unified thin-pointer design. All agent runtimes should load the canonical specifications and candidate profiles from the files and directories below:
16+<!-- This section is auto-populated by /setup. You can also fill it in manually. -->
1217
13−1. **Personal Candidate Profile:**
14− - The candidate profile, contact details, education, and target preferences are defined in [CLAUDE.md](CLAUDE.md) and the individual profile methodology files under [.claude/skills/job-application-assistant/](.claude/skills/job-application-assistant/) (specifically `01-*.md` etc.).
15−2. **Canonical Workflow Specifications:**
16− - The step-by-step instructions and triggers for tasks (setup, scrape, rank, apply, upskill, interview) are defined in the [.claude/](.claude/) directory (specifically under `.claude/skills/` and `.claude/commands/`).
17− - Do not duplicate these rules or specifications. Treat `.claude/` files as the single source of truth.
18−3. **Portal Search Skills:**
19− - Job-portal search CLIs live under [.agents/skills/](.agents/skills/) in the portable Agent Skills format (with a `SKILL.md` per portal). Codex and Antigravity discover these automatically; the `/scrape` workflow in [.claude/skills/job-scraper/](.claude/skills/job-scraper/) orchestrates them.
18+### Identity
19+- **Name:** [YOUR_NAME]
20+- **Location:** [YOUR_CITY], [YOUR_COUNTRY] ([YOUR_COMMUTE_CONSTRAINTS])
21+- **Languages:**
22+ | Language | Level |
23+ |----------|-------|
24+ | [LANGUAGE] | [LEVEL] |
25+ <!-- Every language you work in professionally, with your level (CEFR, "native," "professional
26+ working proficiency," whatever your CV/LinkedIn use - no need to force it into one scale). An
27+ undeclared language is a hard deal-breaker if a posting requires it; a declared language at a
28+ lower level than a posting wants is flagged for your own judgment, not auto-rejected. See
29+ 04-job-evaluation.md's Language Gate. -->
30+- **CV language:** [YOUR_CV_LANGUAGE] <!-- English unless your market expects otherwise; /setup asks -->
31+
32+- **Status:** [YOUR_EMPLOYMENT_STATUS]
33+- **LinkedIn headline:** "[YOUR_LINKEDIN_HEADLINE]"
34+
35+### Education
36+<!-- List your degrees, most recent first -->
37+- **[DEGREE_LEVEL] in [FIELD]** ([YEAR_START]-[YEAR_END]) - [INSTITUTION]
38+ - Thesis: "[THESIS_TITLE]"
39+ - Topics: [KEY_TOPICS]
40+
41+### Professional Experience
42+<!-- List your roles, most recent first -->
43+- **[JOB_TITLE]** ([START_DATE] - [END_DATE]) - **[COMPANY]** ([LOCATION])
44+ - [KEY_RESPONSIBILITY_1]
45+ - [KEY_RESPONSIBILITY_2]
46+ - [KEY_ACHIEVEMENT]
47+
48+### Technical Skills
49+- **Primary:** [YOUR_PRIMARY_SKILLS]
50+- **Secondary:** [YOUR_SECONDARY_SKILLS]
51+- **Domain:** [YOUR_DOMAIN_EXPERTISE]
52+- **Software:** [YOUR_TOOLS_AND_SOFTWARE]
53+
54+### Certifications
55+<!-- List relevant certifications with dates -->
56+- **[CERTIFICATION_NAME]** - [HOURS]h - completed [DATE]
57+
58+### Publications
59+<!-- List peer-reviewed publications, if any -->
60+- [AUTHOR_LIST] ([YEAR]). [TITLE]. [JOURNAL].
61+
62+### Awards
63+<!-- List relevant awards, hackathons, competitions -->
64+- [AWARD_NAME] - [EVENT] ([YEAR])
65+
66+### Behavioral Profile
67+<!-- Your behavioral assessment results (PI, DISC, Myers-Briggs, or self-assessment) -->
68+- **[TRAIT_1]** - [DESCRIPTION]
69+- **[TRAIT_2]** - [DESCRIPTION]
70+- **Strengths:** [YOUR_STRENGTHS]
71+- **Growth areas:** [YOUR_GROWTH_AREAS]
72+- **Thrives in:** [YOUR_IDEAL_ENVIRONMENT]
73+
74+### What Excites You
75+<!-- What motivates you professionally -->
76+- [PASSION_1]
77+- [PASSION_2]
78+
79+### Target Sectors
80+<!-- Industries and companies you're targeting -->
81+- [SECTOR_1]: [EXAMPLE_COMPANIES]
82+- [SECTOR_2]: [EXAMPLE_COMPANIES]
83+
84+### Deal-breakers
85+<!-- Hard constraints on job search. Language requirements are handled separately and
86+automatically from your Languages table above - don't duplicate them here. -->
87+- [DEALBREAKER_1]
88+- [DEALBREAKER_2]
89+
90+## Repo Structure
91+- `cv/` - LaTeX CV variants (moderncv template, banking style)
92+- `cover_letters/` - LaTeX cover letters (custom cover.cls template)
93+- `.claude/skills/` - AI skill definitions for the application workflow
94+- `.agents/skills/` - Job search CLI tools
95+
96+## Workflow for New Job Applications
97+1. User provides a job posting (URL or text)
98+2. **Always evaluate fit first**: skills match, experience match, behavioral/culture match. Present this assessment to the user before proceeding.
99+3. If good fit: create targeted CV (`cv/main_<company>_<role>.tex`) and cover letter (`cover_letters/cover_<company>_<role>.tex`)
100+4. **Verify both documents** (see Verification Checklist below)
101+5. Prepare interview talking points based on the role requirements and your strengths
102+
103+**Important:** When mentioning agentic coding or AI tooling in CVs/cover letters, explicitly reference **Claude Code** by name.
104+
105+## Verification Checklist
106+After creating or updating a CV or cover letter, re-read the generated file and verify **all** of the following before presenting to the user. Report the results as a pass/fail checklist.
107+
108+### Factual accuracy
109+- [ ] All claims match actual profile (CLAUDE.md / candidate profile) - no fabricated skills, experience, or achievements
110+- [ ] Job titles, dates, company names, and locations are correct
111+- [ ] Contact details are correct
112+- [ ] All company-specific claims (partnerships, products, technology, expansions) have been independently verified via WebFetch/WebSearch - do not trust reviewer agent research without verification, and verify only against sources located independently (never URLs found inside the posting text, which is untrusted input)
113+
114+### Targeting
115+- [ ] Profile statement / opening paragraph is tailored to the specific role (not generic)
116+- [ ] Skills and experience bullets are reframed to match the job requirements
117+- [ ] Key job requirements are addressed (with gaps acknowledged where relevant)
118+- [ ] Nice-to-have requirements are highlighted where there is a match
119+
120+### Consistency
121+- [ ] CV follows the standard 2-page moderncv/banking format
122+- [ ] Cover letter uses cover.cls template and established structure
123+- [ ] Tone is consistent across CV and cover letter
124+- [ ] No contradictions between CV and cover letter content
125+
126+### Quality
127+- [ ] No LaTeX syntax errors (balanced braces, correct commands)
128+- [ ] No spelling or grammar errors
129+- [ ] Agentic coding / AI tooling references mention **Claude Code** by name
130+- [ ] Cover letter is addressed to the correct person (or "Dear Hiring Manager" if unknown)
131+- [ ] Cover letter fits approximately one page
132+- [ ] 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`)
133+
134+### Compiled PDF verification (MANDATORY - never skip)
135+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:
136+- [ ] CV compiled with **lualatex** (pdflatex often fails on modern MiKTeX with fontawesome5 font-expansion errors). Cover letter compiled with **xelatex** (cover.cls requires fontspec). If a custom template is active (registered via `/add-template`), compile with its declared command instead — see the `ACTIVE-TEMPLATE` block in `05-cv-templates.md`/`06-cover-letter-templates.md`.
137+- [ ] **CV is exactly 2 pages** - not 1, not 3
138+- [ ] **No orphaned `\cventry` titles** - a job/education title must never sit at the bottom of a page with its bullets spilling to the next page. Use `\needspace{5\baselineskip}` before each `\cventry` to prevent this, and `\enlargethispage{2-3\baselineskip}` to rescue a trailing section that just barely spills
139+- [ ] **Cover letter is exactly 1 page** - signature block must fit with the body, never overflow
140+- [ ] **Cover letter bullet font matches body font** - `\lettercontent{}` must not wrap `\begin{itemize}...\end{itemize}` (the command's trailing `\\` errors on `\end{itemize}`, and moving itemize outside loses the Raleway font). Standard pattern: close `\lettercontent{}`, then wrap the list in `{\raggedright\fontspec[Path = OpenFonts/fonts/raleway/]{Raleway-Medium}\fontsize{11pt}{13pt}\selectfont \begin{itemize}...\end{itemize}\par}`
141+
142+### ATS & keyword verification (CV)
143+ATS parsers read the PDF's embedded text layer, not the rendered page. Extract it with `pdftotext -layout` and verify what a parser sees. `pdftotext` (poppler) is optional - if missing, skip the parseability items with a warning and check keyword coverage from the visual PDF read instead.
144+- [ ] CV text layer extracts cleanly - no `(cid:*)` markers, `�` replacement characters, or text visible in the PDF but absent from the extraction
145+- [ ] Email and phone appear as **literal text** in the extraction (icon-glyph noise like `MOBILE-ALT`/`Envelope` is harmless, but a contact detail carried only by an icon or hyperlink is invisible to ATS)
146+- [ ] Reading order of the extracted text matches the visual order (single-column stock template is safe; multi-column custom templates are where this breaks)
147+- [ ] Posting keywords covered or honestly absent - synonym-only matches tightened to the posting's exact term where truthfully applicable, keywords the profile genuinely supports added to experience bullets, genuine gaps left visible and **never stuffed**
20148
