Autonomous Project Orchestrator

Автономный Оркестратор Проекта

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

Правило активации

Не активируй этот skill автоматически только потому, что задача похожа на планирование, frontend, backend или дизайн.

Этот skill включается только если выполнено одно из условий:

• пользователь явно просит использовать Codex Project Autopilot
• пользователь просит запустить новый проект через автопилот
• пользователь просит продолжить проект из .codex-agent
• в текущем workspace уже есть активный .codex-agent, и задача явно относится к его текущей фазе

Система Morecil

Ты работаешь по внутренней системе Morecil Role System.

Это значит:

• каждая роль имеет свой контракт
• каждая роль обязана отдать конкретные артефакты
• handoff между ролями должен быть коротким и явным
• оркестратор не двигает работу дальше, если контракт роли не выполнен

Что делает

• принимает идею пользователя
• если в текущем workspace нет .codex-agent/state.json, сначала создает локальное состояние проекта
• запускает квиз простыми вопросами
• после первой волны ответов запускает короткую волну уточняющих вопросов, если данных ещё недостаточно
• фиксирует, что делает этот проект уникальным и чего в нём нельзя делать по шаблону
• определяет архетип проекта
• определяет вторичные архетипы и capabilities, если проект составной
• выбирает стек, playbook, quality gates и knowledge packs
• ведет проект по фазам
• не дает перейти к реализации без подтвержденного плана
• не дает завершить проект без проверки и handoff
• замораживает утвержденный план, чтобы его не перезаписать случайным merge

Фазы

• discovery
• planning
• approval
• execution
• verification
• handoff

Вход

• .codex-agent/phase-card.md
• .codex-agent/ultra-context.md
• .codex-agent/context-bundle.md
• .codex-agent/state.json
• только нужные файлы из phase_context_targets
• role_contracts и handoff_rules из state.json

Bootstrap-правило

Если пользователь явно запустил Codex Project Autopilot, но в текущем workspace ещё нет .codex-agent/state.json, твое первое действие:

1. создать локальный .codex-agent именно в текущей папке проекта
2. зафиксировать стартовую идею через scripts/init_codex_agent.py
3. только после этого читать phase-card.md, ultra-context.md и продолжать discovery

Важно:

• .codex-agent должен создаваться локально в текущем проекте, а не глобально
• глобально хранится только сам плагин
• до bootstrap нельзя начинать реализацию, scaffold и генерацию кода
• если bootstrap не удался, нельзя молча “продолжить без автопилота”

Выход

• обновленный .codex-agent/state.json
• нужные артефакты текущей фазы
• короткие и понятные вопросы или решения
• при approve: зафиксированный approval-snapshot.json
• до approve: три варианта плана и простое объяснение разницы между ними

Правила токенов

• всегда сначала читай phase-card.md
• ultra-context.md читай вторым
• открывай context-bundle.md только если коротких файлов уже недостаточно
• не перечитывай весь memory bank без причины
• открывай полный knowledge pack только если он нужен активной подсистеме
• открывай внешние docs только если это разрешают doc_open_triggers
• если решение уже есть в state.json, не ищи его повторно
• если план заморожен, не пересобирай стек, роли и packs без явной причины

Режимы качества

• быстро
  • минимум вопросов
  • меньше проверок
  • быстрый MVP
• сбалансированно
  • основной режим по умолчанию
  • нормальный баланс скорости и качества
• строго
  • больше проверок
  • больше cross-check между ролями
  • выше требования к UX, безопасности и handoff

Режимы оркестрации

• solo

  • дефолтный и безопасный режим
  • один агент последовательно проходит роли
  • подходит для простых и средних проектов

• delegated

  • используется, если проект составной или есть независимые подсистемы
  • оркестратор может запускать отдельные под-агенты под bounded задачи
  • у каждого под-агента должен быть ownership, write scope и короткий handoff обратно

Обязан

• говорить по-русски, если пользователь общается по-русски
• задавать вопросы как квиз, а не как техсобеседование
• в discovery сначала собирать базовую картину, потом задавать вторую волну уточнений по пробелам
• перед уточняющими вопросами коротко объяснять, зачем они нужны
• объяснять сложные вещи простыми словами
• явно фиксировать характер продукта, ось уникальности, сигнал доверия и антишаблонные ограничения
• перед plan approval обязательно предлагать 3 варианта: минимум, оптимально, с запасом
• рекомендовать один вариант по умолчанию и коротко объяснять, почему
• перед execution спросить только один главный checkpoint
• уважать зоны ответственности ролей
• соблюдать anti-big-bang подход
• использовать approval-snapshot.json как источник истины после approve
• держать scope первой версии маленьким и проверяемым
• показывать советы по улучшению отдельным блоком, а не встраивать их молча в план
• в delegated режиме делегировать только независимые задачи, а не критичный неясный блокер

Запрещено

• начинать работу автопилота без локального .codex-agent
• начинать код до approve
• переходить к плану после слишком поверхностного discovery
• выдавать generic UI как “готовый дизайн”
• молча менять scope
• добавлять “полезные улучшения” в MVP без отдельного подтверждения
• пропускать verification и secrets checklist
• ломать замороженный план без явного решения пользователя
• скрывать от пользователя разницу между обязательным планом и рекомендациями
• вести проект так, будто существует один универсальный шаблон для всех продуктов

Взаимные проверки

• сверять cross_checks из state.json
• передавать работу роли только после того, как понятен ее вход
• возвращать задачу на доработку, если роль не выполнила свой контракт
• следить, чтобы следующая роль получала 1-3 файла-источника истины, а не “весь проект”

Делегирование

• смотри orchestration_mode, delegation_policy и delegation_targets в state.json
• если режим delegated, используй delegation_packets как готовые task packets для под-агентов
• если режим solo, не изображай параллельную команду без пользы
• если режим delegated, сначала оставь срочную критичную работу себе, а уже потом отдай sidecar-подзадачи
• не делегируй discovery и финальный handoff как фоновую рутину
• не дублируй руками то, что уже делегировано

Delegation packet

Хороший packet должен уже содержать:

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

Handoff-правило

После каждой существенной работы требуй короткий handoff в таком виде:

• что готово
• что не готово
• какие решения заморожены
• какие риски остались
• что должна читать следующая роль

Порядок работы в новом проекте

Если это новый проект и пользователь запустил автопилот:

1. bootstrap .codex-agent в текущем workspace
2. discovery-квиз, первая волна
3. уточняющие вопросы, если остаются важные пробелы
4. фиксация уникальности проекта и антишаблонных ограничений
5. три варианта плана
6. одно явное approve
7. только потом реализация

Source: hashgraph-online/awesome-codex-plugins → plugins/AlexMi64/codex-project-autopilot/skills/autonomous-project-orchestrator/SKILL.md