diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..85dd6ec
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# Вечерний детектив — правила работы агента
+
+## Структура
+
+- `evening_detective_server/` — отдельный Go-репозиторий бэкенда.
+- `evening_detective_frontend/` — отдельный Vue/TypeScript-репозиторий фронтенда.
+- `email_server/` — устаревающая инфраструктура собственного почтового сервера.
+- `.agents/` и `.codex/` — локальная конфигурация среды; не менять без явного запроса.
+
+## Правила
+
+1. Сначала изучай существующий поток и используй текущие паттерны проекта.
+2. Делай минимальный целевой diff; не добавляй зависимости и абстракции без необходимости.
+3. Не трогай вложенные `.git` и не смешивай историю двух дочерних репозиториев.
+4. Не коммить и не отправляй изменения без явного запроса пользователя.
+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` во фронтенде и соответствующую генерацию в бэкенде.