diff --git a/security-analysis/README.md b/security-analysis/README.md
new file mode 100644
index 0000000..d4d1479
--- /dev/null
+++ b/security-analysis/README.md
@@ -0,0 +1,69 @@
+# security-analysis
+
+Результаты автоматической security-проверки этого репозитория:
+Level 0 (детерминированные сканеры) и Level 1 (AI PR review) из
+требований AI Security Engine. Заводится и сопровождается
+пайплайном `seed-security-scanning` (platform-infra) — правки
+этого README переживут только до следующего его запуска.
+
+## Что здесь лежит
+
+- `policy.yml` — какие severity блокируют merge и какой минимальный
+  confidence нужен, чтобы находка вообще считалась. Общий для
+  обоих уровней.
+- `findings/pr-<номер>/<unix-время>[-review].json` — находки
+  конкретного скана: массив объектов вида
+
+  ```json
+  {
+    "id": "...", "source": "semgrep|gitleaks|ai-review",
+    "category": "sast|secret|auth|idor|injection|...",
+    "severity": "critical|high|medium|low", "confidence": 0.0,
+    "file": "...", "line_start": 0, "line_end": 0,
+    "title": "...", "description": "...", "rule_id": "...",
+    "cwe": "CWE-...", "status": "OPEN",
+    "created_at": "...", "pr_number": 0, "commit_sha": "..."
+  }
+  ```
+
+  У находок Level 1 (`source: ai-review`) дополнительно есть
+  `impact`, `exploit_scenario`, `evidence`, `recommendation`.
+
+## Уровни
+
+- **Level 0** (`security/scan`) — semgrep + gitleaks, без LLM.
+  Быстро и воспроизводимо, ловит известные классы проблем.
+  Запускается на каждый PR.
+- **Level 1** (`security/review`) — headless-агент
+  (`security-reviewer`, read-only: без bash/edit/webfetch) читает
+  диф PR через шлюз (модель `coder-fast`) и ищет то, что
+  детерминированные сканеры не видят: логические дыры
+  авторизации, IDOR, SSRF и т.п. Не идёт по всему репозиторию —
+  только диф и то, что нужно дочитать по grep/glob. Тоже на
+  каждый PR.
+- **Level 2** (Deep Security Audit) — по запросу
+  (`workflow_dispatch` на `security.yml`, вход `domains` —
+  какие домены проверять, пусто = все). Шесть доменных
+  read-only агентов (`audit-auth`, `audit-authz`,
+  `audit-injection`, `audit-ssrf`, `audit-secrets`,
+  `audit-business-logic`) идут по ВСЕМУ репозиторию
+  последовательно (не параллельно — проще отлаживать, дороже
+  по времени), модель `coder-think` (рассуждение, не
+  экономичная `coder-fast`). Каждая находка проходит через
+  независимого верификатора (`audit-verifier`), который
+  пытается её ОПРОВЕРГНУТЬ, а не подтвердить — подтверждённые
+  находки попадают в отчёт (`security-analysis/deep-audit/<время>/`,
+  Markdown + JSON), не подтверждённые отбрасываются молча.
+  Результат — отдельный pull request с отчётом, не блокирует
+  merge (это аудит, не гейт).
+
+## Кто это делает
+
+Комментарии и статусы всех уровней — от имени
+`<репозиторий>-security-bot`, отдельной учётки с правом записи
+только на этот репозиторий. Не токен разработчика и не
+администратора: у бота нет прав ни на что, кроме комментирования
+PR и записи находок сюда же. У Level 1 и Level 2 — свои,
+отдельные ключи шлюза (`SECURITY_REVIEWER_LITELLM_KEY` только на
+`coder-fast`, `DEEP_AUDIT_LITELLM_KEY` только на `coder-think`),
+каждый со своим бюджетом.