К основному содержанию
плагин CX Codex

codex-project-autopilot — плагин для Claude Code: установка и обзор

Плагин codex-project-autopilot превращает идею в готовый проект: задаёт наводящие вопросы, готовит три варианта плана, пишет код и собирает чеклист для передачи в работу.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-project-autopilot@awesome-codex-plugins
Открыть на GitHub

Что делает codex-project-autopilot

Плагин ведёт разработку через шесть фиксированных фаз: discovery, planning, approval, execution, verification и handoff. Сначала он собирает требования и детали интерфейса через наводящий опрос, затем формирует три варианта плана — минимум, оптимальный и с запасом. Без явного подтверждения плана фаза реализации не запустится.

Вся память хранится локально в папке .codex-agent/ внутри каталога проекта. Чтобы снизить расход токенов, контекст разбит на отдельные файлы: phase-card.md, ultra-context.md и context-bundle.md. Задачи распределяются по встроенным ролям, среди которых solution-architect, frontend-builder, backend-builder и qa-reviewer.

Утверждённый план замораживается в approval-snapshot.json, поэтому агент не меняет архитектуру самовольно во время кодинга. Для русскоязычных интерфейсов плагин принудительно требует шрифты с поддержкой кириллицы.

Какие задачи решает

  • спланировать проект от идеи до пошагового плана с оценкой масштаба
  • сохранить архитектурный контекст и стек в локальной папке .codex-agent/
  • проверить кириллическую типографику и разделение клиентских и серверных ключей
  • собрать чеклист переменных окружения и шагов деплоя перед сдачей

Примеры запросов агенту

  • Запусти квиз по новому проекту: телеграм-бот для бронирования с админ-панелью
  • Покажи три варианта плана реализации и обоснуй рекомендуемый
  • Сделай финальную проверку и подготовь чеклист env-переменных для деплоя

Как установить codex-project-autopilot

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-project-autopilot@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о codex-project-autopilot

Как установить codex-project-autopilot в Claude Code?

Выполните обе команды по очереди: сначала /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install codex-project-autopilot@awesome-codex-plugins.

Что делает codex-project-autopilot?

Плагин структурирует создание проекта: собирает требования через опрос, формирует три варианта плана, делит разработку по ролям и готовит итоговый чеклист с инструкциями по запуску.

Где плагин сохраняет контекст и состояние проекта?

Все артефакты, логи и снимки утверждённого плана записываются в локальную директорию .codex-agent/ внутри корня проекта, а не в глобальное хранилище.

Исходный текст

codex-project-autopilot · MIT
# Codex Project Autopilot

Локальный плагин для Codex, который превращает сырую идею в понятный проектный маршрут: вопросы, brief, план, реализация, проверка и финальный handoff.

Это не просто набор промптов. Плагин ведёт проект по шагам, хранит контекст в workspace, не даёт перескочить через важные этапы и помогает доводить результат до рабочего состояния без постоянного ручного подталкивания.

Поддерживаемые платформы для локальной работы: macOS, Linux и Windows.

## Зачем он нужен

Обычный сценарий работы с ИИ выглядит так:

- пользователь пишет идею
- модель отвечает слишком общо или сразу прыгает в код
- важные требования теряются по ходу диалога
- архитектура, дизайн, безопасность и handoff оказываются недоговорёнными
- на финале всё равно приходится много переделывать руками

Этот плагин решает именно эту проблему. Он добавляет структуру, память проекта, роли, проверки и жёсткий маршрут работы.

## Что делает плагин

- принимает идею проекта и переводит её в понятный рабочий сценарий
- задаёт простые наводящие вопросы в формате квиза
- если после первых ответов информации мало, задаёт ещё одну короткую волну уточняющих вопросов
- объясняет простыми словами, зачем нужны эти уточнения и на что они влияют
- отдельно выясняет, что делает проект уникальным и на что он не должен быть похож
- определяет тип проекта и подходящий маршрут реализации
- собирает проектный контекст и план в отдельные артефакты
- предлагает 3 варианта плана: минимум, оптимально и с запасом
- рекомендует один вариант и объясняет простыми словами, почему
- делит работу по ролям: аналитика, архитектура, дизайн, фронтенд, бэкенд, база, автоматизация, QA, деплой
- не начинает реализацию, пока план не подтверждён
- замораживает утверждённый план, чтобы он не перезаписывался случайно
- проводит проверку перед финальным handoff
- собирает чеклист по секретам, env и ручным шагам
- вшивает безопасные дефолты в бриф, план, бэкенд, базу, QA и handoff
- напоминает про минимизацию данных, parameterized queries / ORM, разделение client/server ключей и базовую проверку зависимостей

## Уникальность и дизайн

Плагин не исходит из идеи, что все проекты должны выглядеть одинаково или быть одинаково “креативными”.

Он различает:

- спокойный продуктовый интерфейс
- выразительный маркетинговый экран
- действительно смелое визуальное направление

И выбирает это не по моде, а по задаче проекта.

Для этого он:

- фиксирует `project DNA` и правила уникальности
- отдельно определяет характер продукта, визуальную смелость и язык форм
- запрещает generic-решения по умолчанию
- умеет учитывать локальные style-skills, moodboard, brand guide и `design-system.json`
- не даёт превращать каждый проект в “Awwwards-лендинг” без причины

Отдельно зафиксировано правило типографики:

- если интерфейс и контент на русском, плагин должен использовать шрифты с поддержкой кириллицы
- отсутствие кириллицы у display/body шрифта считается ошибкой качества, а не “мелкой деталью на потом”

## Для каких проектов подходит

- лендинги и продуктовые сайты
- Telegram- и AI-боты
- SaaS MVP и кабинеты
- automation-скрипты
- API-интеграции и воркеры
- смешанные проекты, где есть несколько подсистем одновременно

Например:

- Telegram-бот + админ-панель
- SaaS + база + авторизация
- лендинг + форма заявок + простая автоматизация
- API-воркер + логирование + ручной handoff

## Как он работает

Плагин ведёт проект по фиксированным фазам:

1. `discovery`  
   Собирает требования через короткий и понятный квиз.

2. `planning`  
   Формирует brief, product intelligence, технический контекст, 3 варианта плана и рекомендуемый маршрут.

3. `approval`  
   Показывает варианты плана, объясняет разницу и просит одно явное подтверждение.

4. `execution`  
   Реализует проект по утверждённому маршруту.

5. `verification`  
   Проверяет, что проект не разваливается по основным сценариям.

6. `handoff`  
   Готовит финальные инструкции: что сделано, что осталось руками, какие секреты и env нужны, как запускать и деплоить.

## Почему он полезнее обычного промпта

- не теряет контекст между сессиями
- не начинает кодить слишком рано
- не даёт смешивать анализ, дизайн и реализацию в одну кашу
- помогает не скатываться в generic-решения
- снижает риск архитектурного хаоса
- делает финальный handoff частью процесса, а не “доделкой в конце”

## Экономия токенов

Одна из главных задач плагина — не только улучшать качество, но и уменьшать расход контекста.

Для этого он использует трёхслойный режим памяти:

- `phase-card.md`
  самый короткий фазовый снимок: что делать прямо сейчас и когда вообще можно открывать docs
- `ultra-context.md`  
  короткая выжимка для текущего шага
- `context-bundle.md`  
  фазовый bundle без лишних разделов не по текущему этапу

Идея в том, что агент сначала читает минимум, потом только нужную фазовую сводку, и только потом при необходимости открывает документы или knowledge packs. За счёт этого плагин в реальной работе может тратить заметно меньше токенов, чем обычный режим “прочитай всё и подумай ещё раз”.

## Что хранится в проекте

Плагин ведёт локальную память проекта в папке `.codex-agent/`.

Важно:

- `.codex-agent` создаётся в текущей папке проекта
- он не хранится глобально
- глобально устанавливается только сам плагин в пользовательский marketplace Codex
- у каждого проекта свои локальные артефакты и своё состояние

Там сохраняются:

- квиз и ответы пользователя
- brief проекта
- продуктовый и технический контекст
- активные решения по текущей фазе
- план реализации
- дизайн-направление
- лог выполнения
- отчёт по проверке
- чеклист по секретам и env
- финальный handoff
- состояние проекта в `state.json`
- замороженный утверждённый план в `approval-snapshot.json`

Это позволяет продолжать работу без постоянного восстановления контекста с нуля.

## Встроенные роли

Плагин использует роль-оркестратор и набор специализированных ролей:

- `project-discovery`
- `solution-architect`
- `design-director`
- `frontend-builder`
- `backend-builder`
- `database-designer`
- `automation-builder`
- `qa-reviewer`
- `deploy-operator`

Если в среде уже установлены подходящие skills, плагин старается использовать их как усилители. Если их нет, он продолжает работу встроенными ролями.

## Morecil Role System

Внутри плагина роли описаны по собственной системе `Morecil Role System`.

Это значит, что у каждой роли есть:

- миссия
- контракт
- обязательные артефакты
- критерии готовности
- handoff следующей роли

Роли не копируют чужие prompt-наборы один в один. Они собраны под стиль работы этого плагина:

- меньше хаоса
- меньше generic-решений
- больше понятности для новичка
- больше контроля над scope, quality и handoff

Дополнительно у плагина есть [SOULS.md](/Users/a/tgbot/codex-project-autopilot/SOULS.md) — верхнеуровневый канон ролей и принципов. Он задаёт не только контракты, но и “характер мышления” команды, чтобы проекты не сваливались в одинаковую шаблонную генерацию.

## Orchestration Modes

Плагин поддерживает два режима оркестрации:

- `solo`  
  один агент последовательно ведёт роли внутри одного потока
- `delegated`  
  оркестратор может раздавать независимые задачи отдельным под-агентам, если проект это оправдывает

Это нужно для составных проектов вроде:

- Telegram-бот + админ-панель
- SaaS + auth + data layer
- automation + API worker + verification

При этом финальный контроль, scope и handoff всё равно остаются у оркестратора.

В `delegated` режиме плагин теперь формирует для ролей готовые `delegation packets`:

- что читать сначала
- что именно можно менять
- что роль обязана вернуть
- в каком формате делать handoff обратно

## Внутри плагина

Плагин опирается не только на skills, но и на набор внутренних механизмов:

- knowledge packs  
  локальные правила и best practices под конкретные типы задач
- playbooks  
  маршруты реализации для разных архетипов проектов
- quality gates  
  минимальные требования к результату
- cross-checks  
  взаимные проверки между ролями
- plan lock  
  заморозка утверждённого плана после approve
- ultra-mode  
  сверхэкономная работа с контекстом
- project DNA  
  краткая модель характера продукта и его оси уникальности
- design profile  
  управляемая модель визуальной смелости, языка форм и источников стиля
- anti-template rules  
  правила против шаблонной генерации

## Для кого он особенно полезен

- для новичков, которым сложно сразу правильно сформулировать задачу ИИ
- для solo-разработчиков, которым нужна структура вместо хаотичного диалога
- для тех, кто хочет вести проект по шагам, а не “магией”
- для тех, кому важно не только сгенерировать код, но и получить нормальный handoff

## Что это не делает

Плагин не заменяет мышление и не превращает любую идею в идеальный production-продукт по одной кнопке.

Он делает другое:

- снижает хаос
- удерживает структуру
- не даёт пропустить важные этапы
- помогает довести проект до более зрелого состояния

То есть это не “волшебная кнопка”, а хороший операционный слой над Codex.

## Текущее состояние

Сейчас плагин уже умеет:

- работать по-русски
- вести проект по фазам
- поддерживать несколько типов проектов
- хранить локальную память проекта
- учитывать вторичные архетипы и capabilities
- вести discovery в две волны и собирать более сильный brief
- различать спокойный, выразительный и смелый дизайн
- учитывать локальные style-skills, brand guide, moodboard и `design-system.json`
- требовать кириллически совместимые шрифты для русского интерфейса
- жёстче проверять mobile, адаптив и читаемость
- замораживать план после approve
- экономить токены через phase-card, ultra-context и фазовый context bundle
- валидировать состояние проекта перед handoff

## Установка

Этот репозиторий и есть плагин.

Его можно подключать двумя способами:

- как общий локальный плагин для всех проектов
- как локальный плагин внутри конкретного проекта

Основной рекомендуемый сценарий: установить его один раз как **общий локальный плагин** и дальше использовать в любых проектах.

При этом:

- сам плагин хранится один раз
- в каждом новом проекте создаются свои локальные `.codex-agent` файлы
- проекты не мешают друг другу

### Самый простой способ

Можно вообще не настраивать всё руками.

Достаточно дать Codex ссылку на этот GitHub-репозиторий и написать что-то вроде:

```text
Склонируй этот репозиторий и установи плагин глобально, чтобы он был доступен во всех проектах.
```

После этого Codex может:

1. скачать репозиторий
2. сам прописать `marketplace.json`
3. подключить локальный путь к плагину

Тогда вам останется только:

1. открыть `Skills & Apps`
2. найти `Codex Project Autopilot`
3. нажать `Install`

Для глобальной установки в репозитории есть автоустановщик:

```bash
python3 scripts/install_home_plugin.py
```

Он сам:

1. скопирует плагин в `~/plugins/codex-project-autopilot`
2. создаст или обновит `~/.agents/plugins/marketplace.json`
3. зарегистрирует плагин как общий локальный источник для Codex

### 1. Скачайте этот репозиторий

Склонируйте репозиторий или скачайте архив с GitHub.

Дальше выберите один из двух вариантов.

#### Вариант A. Глобальная установка для всех проектов

Это основной рекомендуемый вариант.

Просто запустите:

```bash
python3 scripts/install_home_plugin.py
```

После этого плагин будет зарегистрирован как пользовательский локальный плагин.

Файлы установки будут лежать так:

```text
~/
├── .agents/
│   └── plugins/
│       └── marketplace.json
└── plugins/
    └── codex-project-autopilot/
```

Готовый пример для этого режима лежит в [examples/home-marketplace.json](/Users/a/tgbot/codex-project-autopilot/examples/home-marketplace.json).

После такой установки:

- открываете любой проект в Codex
- заходите в `Skills & Apps`
- переключаетесь на пользовательский источник
- нажимаете `Install` у `Codex Project Autopilot`

Сам `.codex-agent` при этом всё равно будет создаваться уже в текущем проекте, где вы реально работаете.

#### Вариант B. Плагин лежит внутри проекта

Положите репозиторий сюда:

`plugins/autonomous-project-agent/`

Итоговая структура должна выглядеть так:

```text
ваш-проект/
├── .agents/
├── plugins/
│   └── autonomous-project-agent/
└── ...
```

### 2. Добавьте локальный marketplace

Для project-local режима в проекте должен быть файл:

`.agents/plugins/marketplace.json`

Если файла ещё нет, создайте его. Если он уже есть, добавьте в него запись для локального плагина.

Готовый пример также лежит в [examples/marketplace.json](/Users/a/tgbot/codex-project-autopilot/examples/marketplace.json).

Если не хотите редактировать JSON вручную, просто запустите:

```bash
python3 scripts/install_local_plugin.py --workspace .
```

Скрипт сам создаст или обновит `marketplace.json`.

Минимальный пример для варианта B:

```json
{
  "name": "morecil-local",
  "interface": {
    "displayName": "Morecil Local Plugins"
  },
  "plugins": [
    {
      "name": "codex-project-autopilot",
      "source": {
        "source": "local",
        "path": "./plugins/autonomous-project-agent"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}
```

Именно этот файл делает плагин видимым в `Skills & Apps`.

Если в интерфейсе Codex рядом с категорией вы видите что-то вроде `morecil-local, Productivity`, это означает:

- `Productivity` — категория самого плагина
- `morecil-local` — имя локального marketplace-источника

То есть это не две категории, а `источник + категория`.

### 3. Проверьте Python

Для локальных скриптов плагину нужен установленный Python 3.

Это важно для:

- инициализации `.codex-agent`
- локальной валидации состояния
- guardrail-проверок после записи файлов

### 4. Установите плагин в Codex

После этого:

- откройте проект в Codex
- зайдите в `Skills & Apps`
- в фильтре источников выберите нужный источник:
  - `Пользовательский` для глобальной установки
  - локальный marketplace проекта для project-local режима
- найдите `Codex Project Autopilot`
- нажмите `Install`

После установки плагин станет доступен в Codex для этого источника. Само состояние `.codex-agent` будет создаваться уже в той папке проекта, где вы реально его используете.

### Быстрый сценарий

1. Скачайте этот репозиторий.
2. Запустите `python3 scripts/install_home_plugin.py`.
3. Откройте любой проект в Codex.
4. Откройте проект в Codex.
5. Зайдите в `Skills & Apps`.
6. Выберите пользовательский источник плагинов.
7. Нажмите `Install` у `Codex Project Autopilot`.

### 5. Начните работу

После установки плагин можно использовать для:

- запуска нового проекта из идеи
- продолжения уже начатого проекта
- подготовки деплоя и секретов
- объяснения текущего проекта простым языком

### Важно

- Лучший режим для повседневной работы — глобальная установка через `install_home_plugin.py`.
- В этом режиме один и тот же плагин доступен в любых проектах.
- Если вы используете project-local установку, тогда да: папку плагина и `marketplace.json` нужно добавить в конкретный проект.
- `.codex-agent` не является частью самого плагина. Эта папка создаётся автоматически в текущем workspace, где вы запускаете плагин.

## Куда развивать дальше

Следующие сильные направления для развития:

- ещё более умные role contracts
- расширенная поддержка смешанных проектов
- более строгие phase transitions
- автоматическое обновление scorecard и verification report
- ещё более агрессивная экономия токенов на длинных проектах
- более глубокие product/design heuristics для нетиповых задач

## Итог

Codex Project Autopilot нужен для того, чтобы Codex работал не как генератор случайных ответов, а как управляемая мини-команда с памятью, этапами, проверками и финальной передачей проекта.

Если коротко:  
идея -> вопросы -> план -> подтверждение -> реализация -> проверка -> handoff

## Проверка локально

Если хотите быстро проверить, что плагин не повреждён после скачивания:

```bash
python3 -m py_compile scripts/*.py tests/*.py
python3 -m unittest discover -s tests
```

© Morecil · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
project-risk-register lyndonkl Скилл project-risk-register для Claude Code выявляет, оценивает и расставляет приоритеты рисков проекта по матрице вероятности и воздействия, назначает владельцев и планы смягчения. Структурирует реестр рисков. CX Codex +1 108установок project-artifact официальный Anthropic Скилл project-artifact для Claude Code — собирает данные проекта в HTML-статусную страницу с вкладками. Даёт общий обзор нескольких направлений, который легко обновлять и передавать команде. CX Codex +1 2 323установок gsd-autonomous open-gsd Скилл gsd-autonomous для Claude Code, который проходит оставшиеся этапы проекта: обсуждение, планирование и выполнение. Обновляет прогресс после каждого этапа и завершает веху. CX Codex +1 577установок autopilot SethGammon Скилл autopilot автоматизирует очередь задач из папки .planning/intake/: составляет бриф, вносит правки в код и проверяет результат. CX Codex +1 ★ 937звёзд репо project-session-manager Yeachan-Heo Скилл project-session-manager автоматизирует создание отдельных git-воркtræев для каждой задачи, PR или фичи, с опциональной оркестровкой tmux-сессий. Позволяет параллельно работать над несколькими ветками без конфликтов. CX Codex +1 937установок gsd-new-project open-gsd Скилл gsd-new-project для Claude Code инициализирует новый проект через сбор контекста и создаёт файл .planning/PROJECT.md. CX Codex +1 589установок

Из того же набора391

Весь набор →
nueton-receipts Плагин nueton-receipts считает, сколько раз агент сказал «готово», и сверяет каждое утверждение с командами той же сессии: подтверждено, опровергнуто или не проверено. CX Codex ★ 1 596звёзд репо rag-reviewer Плагин rag-reviewer проводит ревью пулл-реквестов с учётом контекста всего репозитория через гибридный RAG, граф кода в Neo4j и инлайн-комментарии. CX Codex ★ 1 596звёзд репо quiver quiver ведёт разработку от идеи до pull request: помогает спланировать работу, выполнить задачи, проверить код и сохранить результаты на диске. CX Codex ★ 1 596звёзд репо quality-engineering-skills Плагин quality-engineering-skills для Claude Code и Codex объединяет 23 скилла и 8 агентов по качеству для автопрома и производства: от 8D и FMEA до аудитов стандартов. CX Codex ★ 1 596звёзд репо pro-launch Плагин pro-launch для Claude Code и Codex проводит продукт от идеи до запуска через фазы, артефакты и контрольные ворота. Ведёт проработку названия, интерфейса, GTM и релиза. CX Codex ★ 1 596звёзд репо praxis Плагин praxis для Claude Code и Codex, который заводит дисциплину рабочих процессов: агент описывает цель и критерии готовности, а не шаги. CX Codex ★ 1 596звёзд репо project-memory-core Плагин project-memory-core сохраняет архитектурные решения, статус задач и контекст репозитория в локальном хранилище Obsidian в формате Markdown. CX Codex ★ 1 596звёзд репо personal-data-protection Плагин personal-data-protection для Claude Code и Codex группирует обязанности по персональным данным в шести странах Юго-Восточной Азии по слоям стека. В нём есть чек-листы для новых функций, полей данных, подрядчиков и утечек. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой