platform: Instructions file for Codex

AGENTS.md — как работать с платформой Доки

Инструкция для ИИ-агентов: Codex, Cursor, Copilot, Gemini CLI читают этот файл напрямую, Claude Code — через CLAUDE.md, который на него ссылается. Здесь только то, что нужно, чтобы начать работать и не сломать ничего по дороге. Подробное устройство сборки — в docs/how-its-work.md.

---

1. Правила работы

Правила смещают баланс в сторону осторожности, а не скорости. На мелких задачах включайте здравый смысл.

Сначала подумай, потом пиши

• Назови свои допущения вслух. Если не уверен — спроси.
• Если задачу можно понять двумя способами — покажи оба, не выбирай молча.
• Если есть решение проще — скажи об этом. Возражать можно и нужно.
• Если что-то непонятно — остановись и назови, что именно непонятно.

Минимум кода

• Ничего сверх того, о чём попросили.
• Никаких абстракций ради одного вызова.
• Никакой «гибкости» и «настраиваемости», которую не заказывали.
• Никакой обработки ошибок для невозможных ситуаций.
• Если получилось 200 строк там, где хватило бы 50, — перепиши.

Проверка: сказал бы опытный разработчик, что здесь переусложнено? Если да — упрощай.

Правки хирургические

• Не «улучшай» соседний код, комментарии и форматирование заодно.
• Не рефактори то, что не сломано.
• Держись существующего стиля, даже если сам написал бы иначе.
• Заметил не связанный с задачей мёртвый код — скажи о нём, но не удаляй.
• Убирай за собой только то, что осиротело из-за твоих же правок.

Проверка: каждая изменённая строка должна прослеживаться до запроса пользователя.

Цель должна быть проверяемой

Формулируй задачу так, чтобы результат можно было проверить командой:

• «добавь валидацию» → «напиши тест на неверный ввод, потом сделай, чтобы он проходил»;
• «почини баг» → «напиши тест, который его воспроизводит, потом сделай, чтобы он проходил»;
• «отрефактори X» → «убедись, что тесты зелёные до и после».

В многошаговой задаче у каждого шага должна быть своя проверка.

Тест обязателен