diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0563859
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# VESTI — новостной конвейер
+
+Конвейер новостей: краулер источников → классификатор (LLM) → банк статей → веб-интерфейс отбора → публикация в Telegram (@dedinit_vesti) и Fediverse (GoToSocial @vesti@dedinit.ru).
+
+## Документация (читать при старте сессии)
+
+- **STATUS.md** — точка входа: текущее состояние, архитектура, доступы. Читать первым.
+- PRD.md — продуктовое описание.
+- WALKTHROUGH.md — разборы этапов, команды, засады.
+- TODO.md — задачи.
+
+## Расположение и доступ
+
+- Проект: /opt/vesti (docker compose в корне, services/publisher/)
+- Веб-интерфейс: https://vesti.nixg.ru (uvicorn :8400, systemd vesti-web.service)
+- Publisher: docker-контейнер vesti-publisher, 127.0.0.1:8410
+- БД: SQLite в проекте; медиа в media/
+- Бэкап: backup.sh → backups/ + Яндекс.Диск (root cron 2:45)
+- Cron Hermes: vesti-crawler-all-sources (*/30), vesti-watchdog (*/15)
+
+## Правила
+
+- При старте сессии из этой папки сначала прочитай STATUS.md (и PRD.md при необходимости), потом действуй.
+- Логи почтовых/публикационных сервисов — при наличии смотри перед диагнозом.
\ No newline at end of file