AGENTS.md

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