agents/AGENTS.md

Вечерний детектив — правила работы агента

Структура

• evening_detective_server/ — отдельный Go-репозиторий бэкенда.
• evening_detective_frontend/ — отдельный Vue/TypeScript-репозиторий фронтенда.
• email_server/ — устаревающая инфраструктура собственного почтового сервера.
• .agents/ и .codex/ — локальная конфигурация среды; не менять без явного запроса.

Правила

1. Сначала изучай существующий поток и используй текущие паттерны проекта.
2. Делай минимальный целевой diff; не добавляй зависимости и абстракции без необходимости.
3. Не трогай вложенные .git и не смешивай историю двух дочерних репозиториев.
4. Коммиты и push выполняет только пользователь. Агент никогда не коммитит и не отправляет изменения.
5. Не добавляй .env, ключи, пароли, сертификаты и локальные артефакты в Git.
6. После нетривиальных изменений запускай краткую релевантную проверку и сообщай результат.

Команды проверки

• Бэкенд: cd evening_detective_server && go test ./...
• Фронтенд: cd evening_detective_frontend && npm run type-check && npm run lint && npm run lint:css

Для изменений protobuf сначала используй существующую команду npm run proto:gen во фронтенде и соответствующую генерацию в бэкенде.

Для задач, затрагивающих evening_detective_frontend, обязательный стандарт кода находится в evening_detective_frontend/docs/FRONTEND_CODE_STANDARD.md; это единственный источник правил фронтенда.

Работа со списком задач

• Команды взаимодействия с агентом описаны в docs/agent/README.md.
• Активные задачи находятся в docs/agent/TASKS.md, архив завершённых — в docs/agent/COMPLETED_TASKS.md; не создавай task-файлы в дочерних репозиториях.
• Используй только две канонические команды из docs/agent/README.md: Новая задача: и Выполнить задачу:.
• Для Новая задача: задавай необходимые уточняющие вопросы итеративно, пока задача не станет понятной: определены цель, границы, критерии готовности, проверка, ограничения и следующий шаг. До этого не добавляй её в TASKS.md; после подтверждения полноты добавь со следующим ID и статусом TODO. Код не меняй.
• Для Выполнить задачу: сначала проверь полноту требований и задай вопросы только при блокирующей неоднозначности.
• Простую задачу выполняй без отдельного плана. Для обычной задачи составь короткий внутренний план. Для сложной или рискованной задачи сначала покажи план пользователю и дождись подтверждения.
• Делегируй только независимое исследование или ревью, когда это сокращает риск или время; последовательную маленькую задачу выполняй сам.
• В процессе: изучи текущий flow и callers, внеси минимальный diff, после каждого существенного этапа запускай релевантную проверку, исправь ошибки и обнови статус и результат в TASKS.md. После перевода задачи в DONE перенеси её в docs/agent/COMPLETED_TASKS.md.
• После любого действия сообщи ID задачи и результат; коммиты и push не выполняй.