Files
ai-job-search/AGENTS.md
T
Jovin Nicholas 1db48568b3 feat(agents-config): add root AGENTS.md thin-pointer specification (#159)
Root AGENTS.md pointer file per the architecture decision in discussion #78: documents both config roots (.agents/skills/ portable portal skills, .claude/ orchestration) and the profile entry points, carries a framework_version marker registered in both version tools.

Design case made by @erikpr1994 in the #78 architecture thread; implementation by @jovin-nicholas.
2026-07-15 22:33:42 +02:00

1.5 KiB

framework_version
framework_version
1.0.0

Agent Guidelines: AI Job Search

This workspace is structured to manage job search activities, scraper tools, CVs, cover letters, and interview preparation.

Thin-Pointer Design (Single Source of Truth)

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:

  1. Personal Candidate Profile:
  2. Canonical Workflow Specifications:
    • The step-by-step instructions and triggers for tasks (setup, scrape, rank, apply, upskill, interview) are defined in the .claude/ directory (specifically under .claude/skills/ and .claude/commands/).
    • Do not duplicate these rules or specifications. Treat .claude/ files as the single source of truth.
  3. Portal Search Skills:
    • Job-portal search CLIs live under .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/ orchestrates them.