mirror of
https://github.com/MadsLorentzen/ai-job-search.git
synced 2026-09-17 00:26:26 +00:00
refactor: fold /setup_docs into /setup as third onboarding path (#9)
* refactor: fold /setup_docs into /setup as third onboarding path - Auto-detect documents/ at /setup Step 0; offer three paths (documents folder, single CV import, interview). - Inline document-driven merge logic into setup.md as Path A: read-before- write, additive vs. conflicting bucket merge with per-conflict prompts, inference labeling for behavioral and style files, STAR-stub generation instead of fabrication. - Step 3 substeps for skill files skip when Path A populated them; non- skill substeps (CLAUDE.md, cv/main_example.tex, search-queries.md) always run. Path C interview preserved verbatim. /setup --section <name> update flow preserved. - Delete .claude/commands/setup_docs.md. - Update /reset prompts to point only at /setup. Update documents/README.md to reference /setup throughout. Update README.md to drop the standalone /setup_docs section and add upskill/ to the skills tree. - Remove the trailing comma left in .claude/settings.local.json after the PR #6 revert (was technically invalid JSON). Single onboarding entry point. documents/ folder convention unchanged. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(README): finish readme alignment for the /setup fold - Update onboarding-paths tip to reflect three paths (was "Either" before /setup_docs landed in PR #6). - Add documents/ and upskill/ entries to the file tree, both relied on by the new /setup Path A and by /upskill respectively. - Add a brief "Other commands" section briefly describing /expand and /upskill so users discover them without having to read individual command files. /reset stays in the existing "Starting over" subsection, now linked from the new section. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Mads Lorentzen
co-authored by
Claude Opus 4.7
Claude Opus 4.7
parent
2ba441f3fb
commit
974b29ec3a
@@ -61,26 +61,7 @@ claude
|
||||
/setup
|
||||
```
|
||||
|
||||
Claude will ask about your background, skills, and career goals, then populate all profile files automatically. You can import from an existing CV or answer questions interactively. The setup also configures your job search queries so `/scrape` works immediately.
|
||||
|
||||
**Alternative: populate from documents**
|
||||
|
||||
If you have a collection of career documents (CV PDF, LinkedIn export, diplomas, reference letters, past applications), drop them in the `documents/` folder and run `/setup_docs` instead. It reads all documents, cross-references them for consistency, and merges extracted data into your profile files. Safe to re-run as you add new documents.
|
||||
|
||||
```
|
||||
documents/
|
||||
├── cv/ ← Your master CV (PDF or .tex)
|
||||
├── linkedin/ ← LinkedIn profile export (Save to PDF)
|
||||
├── diplomas/ ← Degree certificates
|
||||
├── references/ ← Reference letters
|
||||
└── applications/
|
||||
└── company_role/
|
||||
├── job_posting.md
|
||||
├── cover_letter.tex
|
||||
└── outcome.md
|
||||
```
|
||||
|
||||
See `documents/README.md` for full instructions.
|
||||
`/setup` offers three paths: read your `documents/` folder if you have one populated (CV PDF, LinkedIn export, diplomas, reference letters, past applications), import a single CV pasted in chat, or walk through an interview. It auto-detects what you have and asks. Documents-folder mode is idempotent and safe to re-run as you add more material; see `documents/README.md` for the layout.
|
||||
|
||||
### 4. Search for jobs
|
||||
|
||||
@@ -104,6 +85,15 @@ If the URL can't be fetched (some job portals block automated access), you can p
|
||||
|
||||
This runs the full workflow: evaluate fit, draft CV + cover letter, review with a second agent, revise, and present the final output.
|
||||
|
||||
## Other commands
|
||||
|
||||
`/setup`, `/scrape`, and `/apply` form the core workflow. Two more commands extend it once your profile is in place:
|
||||
|
||||
- **`/expand`** enriches your profile by scanning public sources you've already linked in it (GitHub repos, portfolio site, Kaggle, Google Scholar) and looking up syllabi for named courses and certifications. Discovered competencies are added to your profile with a source tag. Useful right after `/setup` to surface skills that documents alone don't make explicit.
|
||||
- **`/upskill`** analyzes the gap between your profile and your tracked job postings (or a single posting via `/upskill <URL>`). Produces a prioritized heatmap of skill gaps and a learning plan with web-searched study resources and time estimates. Useful for career planning between applications.
|
||||
|
||||
`/reset` is also available, see [Starting over](#starting-over) below.
|
||||
|
||||
## File structure
|
||||
|
||||
```
|
||||
@@ -112,8 +102,8 @@ ai-job-search/
|
||||
├── .claude/
|
||||
│ ├── commands/
|
||||
│ │ ├── apply.md # /apply workflow (drafter-reviewer)
|
||||
│ │ ├── setup.md # /setup onboarding interview
|
||||
│ │ ├── setup_docs.md # /setup_docs document-based profile population
|
||||
│ │ ├── setup.md # /setup onboarding (documents folder, CV import, or interview)
|
||||
│ │ ├── expand.md # /expand competency enrichment from documents and online presence
|
||||
│ │ └── reset.md # /reset wipe profile data or documents folder
|
||||
│ ├── skills/
|
||||
│ │ ├── job-application-assistant/ # Core application skill
|
||||
@@ -125,7 +115,8 @@ ai-job-search/
|
||||
│ │ │ ├── 05-cv-templates.md # LaTeX CV structure + tailoring rules
|
||||
│ │ │ ├── 06-cover-letter-templates.md # LaTeX cover letter templates
|
||||
│ │ │ └── 07-interview-prep.md # STAR examples + interview framework
|
||||
│ │ └── job-scraper/ # Job search orchestration
|
||||
│ │ ├── job-scraper/ # Job search orchestration
|
||||
│ │ └── upskill/ # /upskill skill gap analysis and learning plan
|
||||
│ └── settings.local.json # Claude Code permissions
|
||||
├── .agents/skills/ # Job portal CLI tools (Denmark)
|
||||
│ ├── jobbank-search/ # Akademikernes Jobbank
|
||||
@@ -137,11 +128,19 @@ ai-job-search/
|
||||
├── cover_letters/
|
||||
│ ├── cover.cls # Custom cover letter LaTeX class
|
||||
│ └── OpenFonts/ # Lato + Raleway fonts
|
||||
├── documents/ # Career source materials for /setup Path A and /expand
|
||||
│ ├── README.md # Folder layout instructions
|
||||
│ ├── cv/ # Master CV (PDF or .tex)
|
||||
│ ├── linkedin/ # LinkedIn profile export (PDF)
|
||||
│ ├── diplomas/ # Degree certificates and transcripts
|
||||
│ ├── references/ # Reference letters
|
||||
│ └── applications/ # Past application records (<company>_<role>/)
|
||||
├── salary_lookup.py # Salary benchmarking tool (BYO data)
|
||||
├── tools/
|
||||
│ ├── convert_salary_excel.py # Convert salary Excel to JSON
|
||||
│ └── README_SALARY_TOOL.md # Salary tool setup instructions
|
||||
├── job_scraper/ # Scraper state (seen jobs, results)
|
||||
├── upskill/ # /upskill report output (markdown reports per run)
|
||||
├── job_search_tracker.csv # Application tracking spreadsheet
|
||||
└── SETUP.md # Detailed setup guide
|
||||
```
|
||||
@@ -225,7 +224,7 @@ The single biggest factor in output quality is how much detail you put into your
|
||||
|
||||
- **Role descriptions:** Don't just list job titles. Describe what you actually did in each position: specific projects, tools used, responsibilities, and measurable achievements. The more material you provide, the more precisely the system can reframe your experience for different roles.
|
||||
- **Skills in context:** Instead of listing "Python" or "project management," describe how and where you applied them. "Built ML pipelines for customer churn prediction in Python using scikit-learn" gives the system far more to work with than "Python, machine learning."
|
||||
- **Either onboarding path works:** Whether you import an existing CV or answer questions interactively via `/setup`, the principle is the same: richer input produces sharper output.
|
||||
- **All onboarding paths work:** Whether you point `/setup` at your `documents/` folder, paste a single CV, or walk through the interview, the principle is the same: richer input produces sharper output.
|
||||
|
||||
### Career path discovery
|
||||
|
||||
|
||||
Reference in New Issue
Block a user