Ну и вот вам ещё парочка пропмтов, которые я использую с Codex регулярно. Каждый из них, разумеется, нужно допиливать под конкретную задачу и особенности проекта. В одно сообщение не влезло, ловите несколько:
AGENTS.md# Задача
Создай (или обнови) в корне репозитория файл AGENTS.md, который станет исчерпывающей шпаргалкой для дальнейшей автоматизации. Документ должен рождаться из самого кода: прежде чем писать, проанализируй структуру проекта, конфигурационные файлы и историю коммитов.
## Как работать
Сначала собери контекст. Просмотри:
* файлы, явно задающие правила (например package.json, composer.json, pyproject.toml, Makefile, docker‑compose.yml, .github/workflows);
* настройки тестов и линтеров;
* историю git, чтобы понять фактические соглашения именования и частоту используемых команд.
Затем построй черновик, где каждый раздел отвечает на вопрос «как мне сэкономить время при следующем вызове». Проверь, что в финальной версии нет лишних подробностей (избыточных для автоматизации) и отсутствуют недостающие шаги, без которых агент начнёт задавать уточняющие вопросы.
## Что обязательно описать
### Навигация по коду
Укажи точки входа (bin‑скрипты, запуск приложения, тестовый раннер) и пути, которые можно смело игнорировать (скомпилированные артефакты, временные каталоги).
### Повторяемые команды
Приведи стандартные команды для запуска тестов, линтеров, миграций, сборки образов и развёртывания. Добавь примечания, когда нужны переменные окружения или специфические флаги.
### Соглашения о стиле
Опиши реальные, а не декларируемые правила: табы или пробелы, максимальная длина строки, формат сообщений коммита. Если настроены автоформатеры (pre‑commit, black, prettier) — укажи их конфигурацию и команды.
### Ограничения и переменные среды
Зафиксируй минимальные версии интерпретаторов, набор обязательных переменных окружения и значения по умолчанию, безопасные для локального запуска.
### Зависимости и менеджеры пакетов
Перечисли используемые менеджеры (npm, pipenv, poetry, go modules) и типовые сценарии: установка, обновление, аудит.
### Система CI/CD
Расскажи, какой pipeline собирает проект, какие проверки считаются обязательными, где находятся конфигурации workflow и как локально воспроизвести сборку.
### Расхождения и подводные камни
Отметь известные проблемы (например, нестабильные версии зависимостей, необходимость ручного патча) и предложи безопасные обходы.
### Полезные ссылки
Дай точечные ссылки на внешние руководства, если они экономят время (например, политика версионирования или дизайн‑система).
### Информацию о локализации (переводе) строк
Если применимо, укажи механики локализации и место хранения переводов.
### Обязательно добавь о необходимости обновления AGENTS.md в случае, если в репозитории произошли какие-то изменения в перечисленных пунктах.
## Финальное действие
Сформируй AGENTS.md, сохрани в корне репозитория, зафиксируй коммит с сообщением «docs: bootstrap AGENTS.md». В комментарии к коммиту коротко опиши, какие данные были автоматически обнаружены, а какие добавлены эвристически.
