diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..489da01
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,24 @@
+# ICQ XMPP — мессенджер на nixg.ru
+
+Self-hosted XMPP-мессенджер: Prosody 13.0 + веб-клиент Converse + мост Telegram (Slidge). JID: user@nixg.ru, веб-чат chat.nixg.ru.
+
+## Документация (читать при старте сессии)
+
+- **STATUS.md** — точка входа для новой сессии: текущий статус, что работает, задачи. Читать первым.
+- INFRA.md — инфраструктура, DNS, учётные данные, TLS/LE, бэкапы.
+- BRIDGE-TELEGRAM.md — мост Telegram (Slidge): статус, регистрация.
+- WALKTHROUGH.md — разборы этапов, команды, засады.
+- PRD.md · MIGRATION.md · XEP-AUDIT.md · CHEATSHEET.md
+
+## Расположение и доступ
+
+- Проект: /opt/icq (docker compose в корне, test/ — параллельный стенд)
+- XMPP: c2s 5222 / s2s 5269 / http 5280 / https 5281 (nixg.ru)
+- Веб-чат: https://chat.nixg.ru (wss://xmpp.nixg.ru)
+- Prosody-образ: gitea.nixg.ru/hermes/icq-prosody:13.0
+- Бэкапы → Яндекс.Диск (cron 2:45), LE-серт до 2026-11-26 (продление вручную TXT)
+
+## Правила
+
+- При старте сессии из этой папки сначала прочитай STATUS.md, потом действуй.
+- Осторожно с продом: изменения в Prosody-конфиге сначала проверяй на тестовом стенде (test/).
\ No newline at end of file