Add agent guidelines and make OPE markdown renderer-safe

Author: Yurashku

AGENT.md

@@ -0,0 +1,65 @@
+# AGENT.md — постоянные инструкции для AI-агентов (Codex-first)
+
+Этот файл хранит **долгоживущие правила проекта**. Любой агент, работающий в репозитории, должен читать его перед изменениями.
+
+## 1) Приоритеты
+
+1. Корректность и воспроизводимость.
+2. Понятная документация для начинающих.
+3. Минимальные и аккуратные изменения без «лишнего шума» в diff.
+
+## 2) Обязательные правила при любом изменении
+
+- Всегда обновляй `README.md`, если меняется поведение, структура, workflow, команды запуска или документы, на которые должен ориентироваться пользователь.
+- Перед коммитом обязательно переисполняй все `*.ipynb`, которые относятся к изменению, и коммить обновлённые outputs.
+- Если есть tutorial-файлы, обновляй шаги/описания при любом изменении, влияющем на обучение пользователя.
+
+## 3) Правила markdown и отображения формул
+
+Цель: одинаковая читаемость на GitHub и локально (в т.ч. без MathJax/KaTeX).
+
+- Предпочитай plain-text формулы в блоках ` ```text `, если есть риск, что рендерер не поддерживает LaTeX.
+- Для математических обозначений в тексте предпочитай `code spans` (`pi_B`, `mu_hat`, `p_A(a|x)`).
+- Не полагайся только на `$$...$$` как на единственный способ донести формулу.
+- Если используешь LaTeX, обязательно добавляй рядом plain-text эквивалент.
+
+## 4) Стиль документации
+
+- Пиши кратко, структурно, на понятном русском.
+- У каждого сложного метода должны быть:
+  - интуиция,
+  - формула,
+  - ограничения/допущения,
+  - ссылка(и) на первоисточник.
+- Для ссылок на научные материалы предпочитай первичные источники: arXiv, PMLR, JMLR, официальные docs.
+
+## 5) Технический workflow для Codex
+
+- Перед работой: `git status` + просмотр затронутых файлов.
+- После изменений: локальные проверки (минимум — тесты и/или запуск релевантных скриптов).
+- Для ноутбуков: `jupyter nbconvert --to notebook --execute <path> --inplace`.
+- Перед коммитом проверяй, что в индексе нет временных файлов (`__pycache__`, служебные артефакты и т.п.).
+
+## 6) Коммиты и PR
+
+- Один логический коммит = одна цель.
+- Заголовок коммита: коротко и по сути.
+- В PR описании обязательно:
+  - что изменено,
+  - зачем,
+  - какие проверки выполнены,
+  - есть ли ограничения окружения.
+
+## 7) Границы изменений
+
+- Не менять API/поведение без явного описания в README и tutorial.
+- Не добавлять тяжёлые зависимости без необходимости.
+- Не удалять пользовательские инструкции из документации без явного запроса.
+
+## 8) Быстрый checklist перед финалом
+
+- [ ] README обновлён.
+- [ ] Tutorial/ноутбуки переисполнены и сохранены с outputs.
+- [ ] Markdown читается и на GitHub, и локально.
+- [ ] Тесты/проверки выполнены.
+- [ ] Diff чистый, без временных файлов.

AGENTS.md

@@ -0,0 +1,5 @@
+# AGENTS.md
+
+См. основной файл постоянных инструкций: `AGENT.md`.
+
+Если оба файла присутствуют, использовать правила из `AGENT.md` как каноничные для этого репозитория.

README.md

@@ -106,7 +106,15 @@ print(v_ips, v_snips, v_dm, v_dr, dr_ci)
 - `docs/ope_methods_math_guide_ru.md`
 
 В гайде разобраны: On-policy baseline, Replay, IPS, SNIPS, DM, DR, SNDR, Switch-DR и bootstrap CI.
-Формулы в гайде приведены в GitHub-совместимом markdown-формате (`$...$` и `$$...$$`) для корректного отображения.
+Формулы в гайде приведены в plain-text формате (без обязательной LaTeX-разметки), чтобы корректно читаться и на GitHub, и в локальных Markdown-просмотрщиках.
+
+## Постоянные инструкции для AI-агентов
+
+В репозиторий добавлены постоянные инструкции для агентных инструментов (в т.ч. Codex):
+
+- `AGENT.md` — каноничный набор постоянных правил и workflow,
+- `AGENTS.md` — указатель на `AGENT.md` для совместимости с авто-подхватом инструкций.
+
 
 ## Быстрый синтетический запуск