Ship claude max orchestrate

Ship Claude Max Orchestrate v1

Используй только внутри утверждённого ship-claude-max release slice после GPT-5.5/medium plan APPROVE. Активная модель Claude Code — Conductor. На batch пишет ровно один writer: Conductor либо один Player-субагент, наследующий текущую модель без override.

Этот skill не интегрирует, не push-ит main, не выполняет bd sync, deploy, smoke или coordinator finish. Release остаётся у top-level skill.

Preconditions

При возобновлении прочитай contract.md, state.md, decision-log.md, Review Ledger и последний reviews/review-N.md. Проверь:

git rev-parse --show-toplevel
git branch --show-current
git status --short --branch
node scripts/ship/ship-coordinator.mjs status --json

Root обязан совпадать с returned worktree, BD id — с coordinator metadata, branch — с claude/ship/*. Проверь approved design/plan, slice AC, rollback, monitoring, max_g3_batches: 3, baseline evidence и непересекающийся ownership. Value Contract decision обязан быть PROCEED|MANDATORY либо ограниченным EXPERIMENT; для EXPERIMENT проверь, что это единственный slice и investment_cap ещё не исчерпан. DEFER не является precondition для implementation.

Strategy

Requirements Contract обязан содержать:

tier:
tier_triggers:
coach_profile_reason:

Выбирай минимально достаточный Tier (lowest sufficient Tier) по named evidence. Tier 1 допустим только при хотя бы одном именованном high-risk trigger; субъективная сложность или желание «перестраховаться» не являются trigger.

Tier	Named triggers	Writer	Coach profile
Tier 3	UI/copy/docs/config без runtime-risk	Player-субагент	coach-simple: gpt-5.5, medium
Tier 2	обратимые integrations/schema/lifecycle/KB/tools без Tier 1 trigger	Player при полном AC, иначе Conductor	coach-simple либо coach-complex
Tier 1	auth/security boundary; money/entitlements; concurrency/race/queue semantics; destructive migration/data integrity; необратимый external side effect	Conductor	coach-complex: gpt-5.6-sol, medium

Tier 1 выбирается только по named tier_triggers из high-risk строки, а не как default. money и race не остаются Tier 2: если slice действительно меняет entitlements/payment semantics либо concurrency correctness, это Tier 1. Упоминание этих тем без изменения соответствующего контракта не является trigger — запиши evidence.

Для Tier 2 reversible schema/lifecycle или широкий cross-component contract выбирают complex Coach; локальная обратимая integration/KB/tooling работа — simple. Неясный scope (scope uncertainty) означает возврат в top-level и bounded discovery slice, а не автоматический Tier 1. После discovery создай новый implementation contract с проверяемыми triggers.

Coach всегда read-only. Coach high запрещён, включая impasse.

Каждый внешний профиль требует task-scoped informed consent для точного destination: OpenAI Codex gpt-5.5 либо OpenAI Codex gpt-5.6-sol. Согласие на один destination не подменяет согласие на другой; не создавай consent artifact без фактического owner approval.

Tier 3 не пропускает review полностью: после green Verify выполняется один bounded Coach pass. P2/P3 не блокируют slice.

Условное делегирование (token-рычаг)

Главный контекст пересылается каждый ход, поэтому writer выбирается осознанно:

• чёткий план, литеральный код, Tier 2-3 по образцу → Player-субагент (свежий контекст, дёшево);
• Tier 1, money-path, тонкая логика, race, исследовательская работа или неполный план → Conductor руками (полный контекст важнее токенов, цена ошибки выше).

Player получает чистый контекст: Requirements Contract, последний feedback, Review Ledger, expected_bd_id, абсолютный expected_worktree и точные ownership paths. Он не запускает субагентов и не управляет Git/BD/release. Пока Player пишет, Conductor tracked-файлы не меняет.

Dossier и Review Ledger

Для каждого non-trivial slice веди:

docs/orchestrator/<bd-id>/
  contract.md
  state.md
  decision-log.md
  reviews/review-N.md

Requirements Contract содержит goal, Value Contract reference, approved design/plan, slice boundary, files, AC, tests, constraints, rollback, monitoring, tier, tier_triggers, coach_profile_reason и команды.

Ledger содержит:

accepted_invariants:
rejected_arguments:
resolved_findings:
deferred_findings:
evidence_already_checked:
current_slice_boundaries:
review_counts:
  consecutive_self_review_batches:
timing:
  active_wall_clock_ms:
  external_idle_ms:
  external_idle_reasons:
    machine_sleep_ms:
    owner_approval_ms:
    rate_limit_ms:
    provider_outage_ms:

Fresh Coach получает Contract + Ledger + base/target SHA, но не самоотчёт Player. Уже решённую finding нельзя открыть снова без нового evidence. active_wall_clock_ms считай отдельно от external_idle_ms; сумма machine_sleep_ms, owner_approval_ms, rate_limit_ms и provider_outage_ms обязана равняться external idle total.

G3: Strategy -> Player -> Verify -> Coach

Каждый behavior проходит RED -> GREEN -> REFACTOR:

1. минимальный failing test;
2. наблюдаемый RED по ожидаемой причине;
3. минимальный production code;
4. GREEN;
5. refactor только при зелёном тесте;
6. проверка diff и AC.

Один release slice содержит максимум три G3 batches.

На каждом batch:

1. Player. Conductor пишет сам либо запускает одного fresh Player.
2. Verify. Conductor запускает targeted tests, lint/types и необходимые gates. При FAIL Coach не вызывается. Самоотчёт Player не является evidence: команды гоняет Conductor.
3. Checkpoint. Conductor инспектирует diff и создаёт committed target.
4. Coach. Новый batch получает fresh SID. Simple path: --profile coach-simple; complex path: --profile coach-complex. Обязательно передай actual --writer-model и --writer-reasoning.

node scripts/ship/codex-stage-review.mjs \
  --stage code --profile coach-simple \
  --bd-id "$BD_ID" --prompt-file "$PROMPT" \
  --consent-file "$CONSENT" --output-file "$OUTPUT" \
  --decision-file "$DECISION" \
  --schema-file scripts/ship/codex-stage-review.schema.json \
  --worktree "$WORKTREE" \
  --writer-model "$ACTUAL_WRITER_MODEL" \
  --writer-reasoning "$ACTUAL_WRITER_REASONING"

5. Verdict. Scope-aware APPROVE завершает batch. Evidence-backed REQUEST_CHANGES становится кратким feedback следующей итерации.

Перед новым batch увеличь/сбрось consecutive_self_review_batches по фактическому independence предыдущего verdict. При штатном пути Claude-writer/GPT-Coach independence всегда cross_family, поэтому счётчик остаётся нулевым; он растёт только когда GPT физически недоступен и batch прошёл без внешнего Coach. Если следующий batch стал бы третьим подряд с self_review, не запускай его: закрой slice на ближайшем безопасном deployable состоянии и вернись в top-level для re-slice.

Недоступный codex CLI обрабатывай как в ship-claude-max: один recovery-проход, затем зафиксированная деградация с degradation_reason и урезанным мандатом. Semantic disagreement и BLOCKED деградацию не разрешают.

Для одного batch допускается не больше трёх REQUEST_CHANGES. Смена SID, Player, writer mode, re-ground или compaction не сбрасывает счётчик. Четвёртый REQUEST_CHANGES создаёт review_impasse:

STOP edits
-> сохранить findings и evidence
-> re-slice либо вернуться в design

Владелец не арбитр fencing tokens и технического review. Вернись к нему только если меняется утверждённое product/UX/money/legal/release решение.

Если появился четвёртый G3 batch, не продолжай в текущем worktree: доведи slice до ближайшего безопасного deployable/dark-deployable состояния, верни управление top-level и создай новый slice от обновлённого main.

Scope-aware verdict

Finding обязана содержать severity, origin, impact, disposition, blocking_evidence.

• introduced/exposed P0/P1 → fix_now;
• pre-existing/out-of-scope → bd_followup, если diff не ухудшает дефект;
• maintainability без failure path — максимум P2;
• pre-existing security/data-integrity P0 может блокировать release;
• REQUEST_CHANGES без evidence-backed fix_now недействителен.

Independence берётся только из decision wrapper:

• cross_family|cross_model: полный scope-aware мандат;
• same_model_different_effort: теория/maintainability не блокируют;
• self_review: блокируют только contract violation, proven regression, security или data integrity с evidence.

Попутно найденные баги веди по реестру ДОПОЛНИТЕЛЬНО НАЙДЕННЫЕ БАГИ из ship-claude-max и передавай его наверх вместе с handoff.

Verification resources

Targeted tests запускай без lease. Перед тяжёлым Next build:

node scripts/ship/ship-coordinator.mjs resource acquire \
  --name build --bd-id "UXI LM-abc.1" --json

Всегда освободи token:

node scripts/ship/ship-coordinator.mjs resource release \
  --name build --token "<token>" --json

При потерянном token используй resource resume только для того же BD id. Минимум: targeted tests, relevant lint/types, baseline differential и build. Green build не означает green TypeScript — для новых Prisma select/типов гоняй tsc --noEmit отдельно. Tier 1 также требует security/resilience/race, rollback и monitoring evidence.

Handoff

Перед возвратом top-level:

1. сверь каждый AC с evidence;
2. inspect полный diff и secret scan;
3. создай targeted intended commit, без git add ./git add -A и без docs/hermes-prompts/;
4. запиши committed base/target SHA;
5. обнови decision-log.md, Review Ledger и review files;
6. подготовь committed dossier для consolidated GPT-5.5/medium code review;
7. обнови BD summary, но не закрывай task до release evidence.

Верни changed files, команды и свежие результаты, remaining risks, base/target SHA, Coach verdict/profile/independence и dossier path.

Hard prohibitions

• Do not push main или session branch до integration lock.
• Do not deploy.
• Не выполняй bd sync, integration lock, smoke или coordinator finish.
• Не используй больше одного writer.
• Не позволяй Coach менять файлы.
• Не повышай Coach до high.
• Не объявляй approval без фактического scope-aware verdict.