vetmanager-mcp: Instructions file for Claude Code

Правила работы Claude Code над проектом

Этот файл — основной источник инструкций для Claude Code в данном проекте. Workflow адаптирован из .cursor/rules/agent-workflow.mdc с добавлением обязательного ревью сторонней моделью.

---

1. Workplan

• Workplan хранится в Roadmap.md — единственный источник очереди работ
• Формируется на основе PRD
• Содержит только название этапа/задачи и статус (todo / in_progress / done / stop)
• Не содержит деталей реализации

---

2. Выбор задачи

• Только задачи со статусом todo
• Без незавершённых зависимостей
• Самая верхняя в списке

Запрещено:

• брать несколько задач одновременно
• перескакивать через задачи
• создавать задачи вне Workplan

---

3. PRD задачи

Перед началом реализации:

• Создать PRD в /PRD/ с явным разделом ## Цель
• Выполнить декомпозицию: подзадача ≤ 2 ч или ≤ 150 строк кода
• Изучить связанные /artifacts после создания PRD и обновить PRD проверенными фактами
• Провести PRD-review и PRD-review сторонней моделью
• Провести оценку PRD на простоту и повторить PRD-review gates после правок PRD
• Без декомпозиции реализация запрещена

Раздел ## Цель требуется с этапа 293. PRD более ранних этапов написаны по прежней договорённости — разбор начинался с «Обращения» или «Контекста», — и задним числом не переписываются: менять исторический документ ради зелёной проверки значит подделывать его. Гейт review_workflow_check.sh знает эту границу (PRD_GOAL_REQUIRED_FROM) и старые PRD не трогает.

---

3.1. Ревью сторонней моделью и бюджет

Ревью сторонней моделью означает:

• если текущий агент работает в Claude, ревью делает Codex gpt-5.5;
• если текущий агент работает в Codex, ревью делает Claude Opus.

Бюджеты:

• PRD-review сторонней моделью: максимум 2 валидных запуска на задачу; валиден только разбираемый verdict (findings или явный пустой список);
• code/diff review сторонней моделью: максимум 2 валидных запуска на задачу; валиден только разбираемый verdict (findings или явный пустой список);
• бюджеты раздельные и не расходуют друг друга;
• gpt-5.3-codex-spark можно запускать как scout/subagent безлимитно; Spark не принимает финальных решений и не расходует бюджет.
• Успех strong review: JSON-конверт Claude разобран, is_error=false, непустое поле .result разбирается по required findings schema. Валидатор вызывать напрямую как исполняемый scripts/validate_review_result.py, не через имя интерпретатора; CI проверяет этот вызов. Сбой: конверт не JSON, is_error=true, .result пусто/не разбирается/не соответствует schema либо provider/model error. stop_reason не участвует: при --json-schema structured result штатно доставляется tool call. Infrastructure failure не расходует слот, фиксируется отдельной строкой в AssumptionLog.md как неуспешная попытка N/3; для одного strong review gate допускается максимум три такие попытки всего (от 1/3 до 3/3), смена prompt/schema счётчик не сбрасывает. После третьей неуспешной попытки gate фиксируется как blocked и push запрещён до пользовательского решения или восстановления провайдера; Spark имеет отдельный лимит и в этот счётчик не входит.