orchestrator-structures.md устарел: нет Scenario-Coder и Phase 3d

[axelboman277]

Версия

v0.6.0 (последний релиз, проверено по main).

Файл

framework/workflows/references/orchestrator-structures.md

Суть проблемы

Справочный файл orchestrator-structures.md рассинхронизирован с остальными артефактами v0.6.0. Он отражает 3-фазную схему Phase 3 (a → b → c, без Scenario-Coder), которая, судя по full-cycle.md и наличию отдельного субагента scenario-coder.md, в этом релизе уже заменена на 4-фазную (3a → 3b → 3c → 3d).

Конкретные расхождения

1. Структура task_dir/.context/

В orchestrator-structures.md:

├── developer-code-context.md ← Developer-Code (Phase 3c)

— developer-code помечен как Phase 3c, и отсутствует scenario-coder-context.md.

В то же время framework/workflows/full-cycle.md:

Phase 3 is strictly ordered: 3a -> 3b -> 3c -> 3d.

Phase 3c: Scenario-Coder

Scenario-Coder makes Phase 3a .feature scenarios executable.

Phase 3d: Developer-Code

Developer-Code implements production BSL …

И framework/subagents/scenario-coder.md существует как отдельный субагент роли.

2. Reviewer scopes

В orchestrator-structures.md (раздел Reviewer-context файлов):

├── reviewer-context-bdd.md   ← Reviewer (Phase 3a)
├── reviewer-context-tests.md ← Reviewer (Phase 3b)
├── reviewer-context-code.md  ← Reviewer (Phase 3c)

— отсутствует reviewer-context-bdd-steps.md для ревью executable BDD-шагов от Scenario-Coder. То же самое в блоке sessions.json: ключ reviewer-bdd-steps отсутствует.

В full-cycle.md и orchestrator.md Reviewer запускается на каждой фазе включая 3c (Scenario-Coder), значит scope bdd-steps нужен.

3. Диаграмма оркестратора

В orchestrator-structures.md:

  ┌ Scenario-Author(3a) ─► Review ─┐
  └ Developer-Tests(3b) ─► Review ──┘
  ──► Developer-Code(3c) ──► Review

— Scenario-Coder в схеме не упоминается. Аналогично в «Схема параллельного запуска Phase 3»: после параллельных 3a/3b сразу идёт Phase 3c (Developer-Code), минуя Scenario-Coder.

4. sessions.json

В блоке примера:

"developer-code": "agent-bbb",
...
"reviewer-bdd":     "agent-xxx",
"reviewer-tests":   "agent-fff",
"reviewer-code":    "agent-ggg",

— нет ключа scenario-coder и нет reviewer-bdd-steps.

Почему это важно

Файл является references/-приложением к orchestrator.md и описывает раскладку артефактов на диске — какие context-файлы создаёт оркестратор и какие scopes использует Reviewer. Если кто-то берёт orchestrator-structures.md как шаблон task_dir (в т.ч. через автоматизацию), то:

• не создаётся scenario-coder-context.md → теряется handoff Phase 3c (исполняемые .feature/@exportscenarios);
• не запускается Reviewer scope bdd-steps → ревью BDD-шагов выпадает из workflow;
• developer-code ошибочно стартует как Phase 3c, что ломает порядок фаз и приоритет источников истины (full-cycle.md говорит «3c = Scenario-Coder»).

Внутреннее противоречие внутри одного релиза: full-cycle.md + subagents/scenario-coder.md + subagents/developer-code.md описывают 4-фазную модель, а references/orchestrator-structures.md — 3-фазную.

Предполагаемая причина

Похоже на регресс синхронизации при выпуске v0.6.0: основная инновация релиза — разделение Phase 3 на 3a/3b/3c/3d (введение роли Scenario-Coder). full-cycle.md и каталог subagents/ обновили, а справочный orchestrator-structures.md остался в состоянии предыдущей итерации (предположительно, v0.5.x), когда Scenario-Coder ещё не было.

Предложение по фиксу

Привести orchestrator-structures.md в соответствие с full-cycle.md v0.6.0:

1. Раздел «Структура task_dir»:

   • вставить scenario-coder-context.md ← Scenario-Coder (Phase 3c) между developer-tests-context.md и developer-code-context.md;
   • переименовать комментарий у developer-code-context.md с Phase 3c на Phase 3d;
   • добавить reviewer-context-bdd-steps.md ← Reviewer (Phase 3c) рядом с reviewer-context-code.md (которое теперь Phase 3d).

2. Раздел «Структура sessions.json»:

   • добавить ключи scenario-coder и reviewer-bdd-steps.

3. Диаграмма оркестратора и схема параллельного запуска Phase 3:

   • после параллельных 3a/3b добавить шаг Phase 3c: Scenario-Coder → Review (bdd-steps);
   • Phase 3d: Developer-Code → Review (code).

Если нужно — могу прислать PR с предложенным патчем.

Окружение

Сверка проводилась как часть аудита соответствия проекта (downstream-адаптация v0.6.0). Локально мы сознательно НЕ копируем orchestrator-structures.md именно из-за описанного расхождения и используем единственным источником истины по структуре task_dir свой адаптированный orchestrator.md.