career-os

Use when writing, modifying, or debugging browser automation code for a specific job application portal — Greenhouse, Lever, Workday, or an unknown custom ATS. Triggers on: "ATS adapter", "new adapter", "write new adapter", "Workday form", "Greenhouse selector", "Lever integration", "unknown portal", "custom ATS", "LLM vision fallback", "DOM selector not found", "form automation", "apply engine", "portal scraper", "shadow DOM", "form is being filled".

Use when implementing or modifying the CV tailoring pipeline — selecting the right CV version, reordering project/skill blocks for a specific job, generating dynamic cover letters, or updating the tailoring prompt contract. Triggers on: "CV seçimi", "CV tailoring", "özgeçmiş optimizasyonu", "cover letter", "immutable block selection", "CV versiyonu", "keyword injection", "tailored summary", "proje sıralama".

Use when writing database migrations, queries, or ORM models for this project. Triggers on: "migration yaz", "tablo oluştur", "PostgreSQL şema", "PGVector", "SQL sorgu", "Alembic", "index ekle", "ENUM güncelle", "application_data JSONB", "cv_performance_stats view", "interaction_logs", "veritabanı modeli".

Use when implementing or debugging the 3-layer duplicate application detection system — DB hash check, email parsing for manual applications, or semantic vector similarity detection. Triggers on: "duplicate prevention", "mükerrer başvuru", "aynı ilana iki kez", "email parsing", "Gmail API kontrolü", "semantic duplicate", "URL hash", "95% similarity", "already applied".

Use when building or debugging the Human-in-the-Loop Telegram integration — pausing agent tasks for user approval, sending inline button messages, handling webhook callbacks, and resuming suspended Celery tasks. Triggers on: "Telegram bot", "kullanıcı onayı", "AWAITING_APPROVAL", "inline button", "webhook callback", "task dondur", "maaş beklentisi sor", "HITL", "async approval", "human-in-the-loop".

Use when building or triggering the automated interview preparation pipeline — detecting interview invitations from email/calendar, running company research, LinkedIn analysis, and generating prep documents. Triggers on: "mülakat daveti", "interview detected", "ResearchAgent", "prep-doc", "şirket araştırma", "LinkedIn profil analizi", "takvim daveti", "ICS", "next steps email", "teknik soru tahmini", "interview prep".

Use when implementing or debugging the LLM provider fallback chain — distinguishing per-minute vs per-day rate limits, routing between Groq/Cerebras/Ollama, or handling invalid JSON responses from LLMs. Triggers on: "rate limit", "429 hatası", "model zinciri", "fallback chain", "Groq limit", "Cerebras", "günlük kota", "dakikalık limit", "AllModelsExhausted", "call_with_fallback", "provider değiştir".

Use when building or modifying the job relevance scoring pipeline — embedding-based local filtering, LLM-based deep scoring, JSON output validation, or the confidence threshold routing logic. Triggers on: "relevance score", "ilan puanlama", "embedding filter", "cosine similarity", "Groq scoring", "LLM analiz", "confidence threshold", "auto_apply karar", "match reasoning", "hard-skill analizi", "vektör benzerliği".

Use when working on the daily agent session flow, state machine transitions, Celery task orchestration, rate limiting between applications, or the session shutdown/reporting protocol. Triggers on: "session başlat", "state machine", "IDLE → DISCOVERY", "günlük kapanış", "cooldown", "daily cap", "session end", "Celery task sırası", "SESSION_START", "özet raporu", "rate limiting platformlar arası".

Use when implementing or debugging anti-bot evasion for Playwright browser automation. Triggers on: "stealth", "bot detection", "fingerprint", "Cloudflare block", "DataDome", "PerimeterX", "human typing", "mouse jitter", "natural scroll", "user-agent rotation", "WebGL randomization", "Canvas fingerprint", "hardwareConcurrency", "gaussian jitter", "keystroke latency", "playwright-stealth", "browser fingerprint", "anti-bot", "bot detection bypass".