Codex Guide

Тема

Практики разработки с Codex ​

Проверено: 20 июля 2026 года.

Что это за папка ​

Это исходники русскоязычного VitePress-сайта codex.rosveb.ru и локальная база инженерных практик для работы с Codex. Здесь документируются CLI, IDE, desktop app, ChatGPT/cloud, безопасность, настройка и production-workflow. Это не исходный код OpenAI Codex.

Быстрая карта каталогов, сборки и источников истины: docs/about-project.md.

Главные ориентиры:

  • docs/ — редактируемые исходники документации;
  • docs/project-files/ и docs/.vitepress/dist/ — generated, вручную не менять;
  • docs/INDEX.md — маршрутизатор инженерных практик;
  • npm run docs:build — полная синхронизация Markdown и VitePress-сборка.

Пользовательская документация ​

В каталоге docs расположен русскоязычный VitePress-сайт по Codex CLI, конфигурации, безопасности и связи с ChatGPT/Codex cloud.

Опубликованная версия: codex.rosveb.ru.

bash
npm install
npm run docs:dev

Production-сборка и локальный preview:

bash
npm run docs:build
npm run docs:preview

Перед dev и build команда docs:sync формирует веб-каталог всех исходных Markdown-файлов проекта. Зависимости и generated build output исключаются. Каталог опубликован по адресу /project-files/.

Стартовая страница — docs/index.md, полный справочник команд — docs/cli/commands.md. Ранее собранные инженерные стандарты публикуются отдельным разделом /practices/. Практические сценарии для IDE, desktop app, review и автоматизаций находятся в разделах docs/surfaces и docs/workflows.

Этот каталог — локальный справочник по управляемой разработке с Codex: от постановки задачи и настройки контекста до проверки кода, DevOps, open-source-взаимодействия и Laravel. Это не замена официальной документации и не единый огромный промпт.

Начальная точка — docs/INDEX.md. Она указывает, какие документы читать перед конкретным видом работы. Канонические и дополнительные источники собраны в docs/SOURCES.md.

Главный принцип: «вайбкодинг» годится для исследования и быстрых прототипов, но production-разработка требует явной цели, ограничений, проверки результата и ответственности человека за изменения.

Подключение к проекту ​

В корневой AGENTS.md проекта можно добавить:

md
## Общие практики Codex

Перед существенной разработкой прочитать
`/home/aleksey/projects/codex/docs/INDEX.md` и следовать указанным там
обязательным разделам. Подключать только документы, относящиеся к текущей
задаче. При конфликте приоритет имеют ближайший AGENTS.md, документация и код
этого проекта.

Для Laravel-проекта можно дать прямую ссылку также на docs/LARAVEL.md, а для инфраструктурной работы — на docs/DEVOPS.md.

Для многоагентной разработки и оптимизации стоимости использовать docs/ORCHESTRATION.md. Перед созданием типового компонента с нуля проверить docs/REUSE.md, а при подготовке среды обратной связи — docs/DEBUGGING.md.

Принципы поддержки ​

  • У каждого документа есть дата проверки.
  • Изменяемые факты сверяются с официальной документацией перед применением.
  • Общие рекомендации не должны дублировать локальные команды, версии и порты.
  • Повторяющиеся механические требования переносятся в тесты, линтеры, CI или hooks, а не накапливаются бесконечно в AGENTS.md.