hr-agent-ru: Instructions file for Claude Code

hr-agent — контекст проекта

Этот файл — главный контракт для Claude Code в этом репозитории. Он описывает кто пользователь, как устроен проект и какие правила работы с данными.

Кто пользователь

Пользователь — соискатель, который ведёт поиск работы через Telegram-каналы и/или RSS-фиды job-бордов. Технический уровень варьируется: предполагается, что пользователь умеет запускать команды по инструкции, но не обязан быть программистом.

Полный профиль конкретного пользователя живёт в profile/candidate_context.md — он создаётся при онбординге и является главным источником истины для оценки вакансий. Пока он не заполнен, скиллы оценки матчинга работать не будут.

Цель проекта

Автоматизировать поиск работы:

1. Собирать вакансии из Telegram-каналов и RSS-фидов
2. Автоматически оценивать совпадение с профилем пользователя
3. Подбирать подходящее резюме под каждую вакансию или давать рекомендации по доработке
4. Генерировать персонализированные сопроводительные сообщения / cover letters
5. Отслеживать переписку с HR и автоматически обновлять статусы вакансий
6. Помогать готовиться к интервью (домашний brief + script на второй экран)

Структура проекта

hr-agent/
├── profile/
│   ├── candidate_context.example.md  # шаблон профиля (в git) — копируется в candidate_context.md при онбординге
│   ├── candidate_context.md   # профиль пользователя — главный источник для оценки вакансий (runtime, не в git)
│   ├── cv_product_web3.md      # резюме под product-роли в web3 (используется /cv-match)
│   ├── cv_bizdev_web3.md       # резюме под bizdev / partnerships-роли в web3
│   ├── cv_product_en.md        # резюме на английском под product-роли
│   ├── cv_links.example.md     # шаблон маппинга «файл резюме → публичная ссылка» (в git)
│   └── cv_links.md             # маппинг резюме на публичные ссылки — заполняется пользователем (runtime, не в git)
├── vacancies/                 # всё что связано с вакансиями
│   ├── parsing result/        # buffer + аудит-лог парсера: {date}_{channel}_{msg_id}.txt (incoming, удаляются ИИ) + {date}.json (статусы accepted/rejected, остаются)
│   ├── items/                 # папка на каждую вакансию — все длинные тексты живут здесь
│   │   └── {id} {роль} {компания}/
│   │       ├── source.md      #   полный текст вакансии (создаёт /hr-collect)
│   │       ├── card.md        #   карточка + сообщение HR (создаёт /vacancy-card)
│   │       ├── tailoring.md   #   заметки по доработке CV (создаёт /cv-match при score < 70%)
│   │       ├── correspondence.md # лог переписки с HR (создаёт /feedback-update, апендит при новых сообщениях)
│   │       ├── interview_brief.md      # контекст + доменка + tricky-вопросы (создаёт /interview-prep)
│   │       ├── interview_script.md     # лист на второй экран во время звонка (создаёт /interview-prep)
│   │       └── interview_transcript.md # пустой блокнот для записи звонка (создаёт /interview-prep, дальше не трогает)
│   ├── items_archive/         # архив папок вакансий — туда едут после /archive-vacancies, обратно — при auto-unarchive в /feedback-update
│   ├── feedback result/       # буфер парсера переписок: {ISO}_{channel}_{dialog_id}.json. Скилл /feedback-update удаляет после обработки.
│   ├── interviews/            # общая база подготовки: playbook.md (STAR, ответы, цифры, мантра) + progress_log.md (лог прогресса)
│   ├── vacancies.csv          # тонкая таблица-индекс активных вакансий (10 колонок, БЕЗ полного текста)
│   └── vacancies_archive.csv  # архивные строки (та же шапка). Создаётся /archive-vacancies при первом архивировании.
├── engine/                    # вся «техника» парсеров — пользователь сюда не заходит
│   ├── tg_collector/
│   │   ├── main.py            #   парсер Telegram-каналов (telethon) — сбор новых вакансий
│   │   └── prefilter.py       #   дешёвая пре-фильтрация постов (стоп-теги, реклама, дайджесты, дедуп, стоп-роли)
│   ├── rss_collector/main.py  # парсер RSS-фидов job-бордов (feedparser)
│   ├── feedback_collector/
│   │   ├── main.py            #   парсер ответов от HR в личных DM (telethon) — пишет last_message_utc в store
│   │   └── test_collector.py  #   pytest для парсера переписок
│   ├── archive_runner/main.py # архивирует вакансии старше 30 дней в vacancies_archive.csv + items_archive/ (--dry-run для preview)
│   ├── update_json_log.py     # утилита: проставляет accepted/rejected статусы в дневной JSON-лог parsing result/
│   ├── feedback_store/        # CLI и логика хранилища контактов/диалогов
│   │   ├── __main__.py        #   python -m feedback_store <cmd> — единая точка доступа к JSON
│   │   ├── store.py           #   Store class: атомарная запись temp+rename
│   │   ├── schema.py          #   enums (CHANNELS, ROLES, LINKED_BY), валидация
│   │   ├── migrate.py         #   one-shot миграция CSV+card.md → feedback_store.json
│   │   ├── test_store.py      #   pytest (24 теста)
│   │   └── prompts/
│   │       └── interpreter.md #   промпт LLM-интерпретатора для /feedback-update
│   ├── config/
│   │   ├── settings.py        # пути, env-переменные, прокси
│   │   ├── tg_channels.py     # список Telegram-каналов для мониторинга (шаблонный — пользователь правит под себя)
│   │   ├── rss_sources.py     # список RSS-фидов (шаблонный)
│   │   ├── prefilter_roles.py # ролевые фильтры пре-фильтрации (STOP_ROLE_PATTERNS для TG, POSITIVE_KW/NEGATIVE_KW для RSS) — шаблонный
│   │   ├── .env.example       # шаблон секретов (TELEGRAM_API_ID/HASH и т.д.)
│   │   └── .env               # API ключи (runtime, не в git — создаётся из .env.example)
│   ├── data/                  # локальное состояние парсеров (runtime, не в git — создаётся при работе)
│   │   ├── tg_state.json      # состояние Telegram-парсера (last msg_id per channel)
│   │   ├── rss_state.json     # состояние RSS-парсера (seen URLs per source)
│   │   ├── feedback_store.json # единый источник правды по контактам и диалогам (см. ниже)
│   │   └── telegram_session.session  # сессия Telegram (не трогать, не публиковать)
│   ├── requirements.txt
│   ├── collect_tg.bat         # запуск парсера вакансий
│   ├── collect_rss.bat        # запуск RSS-парсера
│   ├── collect_feedback.bat   # запуск парсера ответов HR
│   ├── archive.bat            # запуск archive_runner (можно отдельно от /archive-vacancies)
│   └── setup.bat              # первичная установка зависимостей
├── .claude/
│   ├── agents/
│   │   └── hr-daily.md        # агент @hr-daily — оркестратор: /hr-collect → /cv-match → /vacancy-card за один прогон
│   ├── commands/
│   │   ├── hr-collect.md      # скилл /hr-collect — парсеры Telegram + RSS + оценка вакансий
│   │   ├── add-vacancy.md     # скилл /add-vacancy — ручное добавление одной вакансии (LinkedIn, форумы, личка)
│   │   ├── cv-match.md        # скилл /cv-match — подбор резюме под вакансию
│   │   ├── vacancy-card.md    # скилл /vacancy-card — карточки + сообщения HR
│   │   ├── feedback-update.md # скилл /feedback-update — парсинг ответов HR + апдейт статусов + correspondence.md (умеет auto-unarchive)
│   │   ├── interview-prep.md  # скилл /interview-prep — подготовка к интервью (brief + script + transcript)
│   │   └── archive-vacancies.md # скилл /archive-vacancies — архив старше 30 дней (кроме «назначено интервью»)
│   ├── settings.json          # общие разрешения Claude Code (в git)
│   └── settings.local.json    # локальные разрешения Claude Code (в git)
├── .gitignore                 # исключает секреты (.env, *.session, engine/data/) и мусор (__pycache__ и т.п.)
├── README.md                  # описание проекта для GitHub
├── LICENSE
├── pipeline.png               # схема пайплайна (используется в README)
└── CLAUDE.md