plan-panel

name: plan-panel description: | Use when user wants a multi-role review of a proposed plan / RFC / implementation strategy. Spawns a "panel" of expert subagents (architect, qa, judge — always; security/frontend/backend/data/ops conditional based on detected scope), each with a strict checklist-driven protocol. Final judge synthesizes findings into priority-ranked action list with cross-examination of conflicts.

TRIGGER on: • «проверь план», «верифицируй план», «собери панель», «посмотри план с разных сторон» • «что упустил в плане», «что важно учесть» • «прогони ревью», «нужна команда экспертов», «нужно мнение архитектора + qa + ...» • "review this plan", "verify this plan", "panel review", "expert review" • Explicit: «/plan-review», «/plan-panel», «/panel» • --from-task (Stage 1): «спланируй и проверь X», «сделай план под задачу X и прогони панель», "plan and verify X", "draft a plan for X and review it" — когда ПЛАНА ЕЩЁ НЕТ, есть только задача.

Также активируется когда пользователь явно даёт большой план и просит «прежде чем начнём» / «прежде чем кодить» / «давай разберёмся» — это сигнал что нужна верификация.

HEAVY MODE по умолчанию (5-8 ролей + Fable judge с cross-examination конфликтов между ролями). Lite — через флаг --lite. Cost ~$0.70-2.50 за full run. allowed-tools: - Bash - Read - Write - Workflow - Agent - AskUserQuestion

plan-panel — multi-role plan verification

Flow (3 фазы)

User план → /plan-review
   ↓
Phase 1: SCOPE DETECTION (1 agent, Haiku)
   → читает план + project context (~/projects/<slug>.md если найден)
   → возвращает scope.json: { scope_tags, selected_roles, complexity, rationale }
   → пользователь видит выбранные роли, может override
   ↓
Phase 2: PARALLEL ROLE REVIEW (N agents, Sonnet)
   → выбранные роли работают параллельно с одинаковым input (план + scope.json)
   → каждая выдаёт structured JSON по схеме из _shared.md
   → агрегация в review.md (sole-author rule)
   ↓
Phase 3: JUDGE SYNTHESIS (1 agent, Fable, HEAVY mode)
   → читает все role outputs
   → ищет конфликты между ролями
   → если есть конфликт — ДЕЛАЕТ cross-examination round: задаёт уточняющий
     вопрос конкретной роли и переоценивает
   → выдаёт priority-ranked action list + ищет gaps (что НИ ОДНА роль не покрыла)
   → final verdict: PASS / FAIL / NEEDS-WORK
   ↓
Persistence:
   project/.plan-panel/<ts>-<slug>/  + копия в $CLAUDECORE_PATH/plan-panel/<project>/<ts>/
   plan.md, scope.json, review.md, judge.md, metadata.json
   ↓
Финал: показ judge.md пользователю + опциональный prompt на /panel-feedback

Запуск

~/.claude/skills/plan-panel/workflow/panel.js

Это Workflow script. Вызывается через Workflow tool Claude Code когда срабатывает trigger. См. workflow/panel.js для детерминистской орк.

Trigger phrases / activation

См. frontmatter description. Когда пользователь пишет «проверь план», «собери панель» и т.п. — этот skill активируется, дальше Claude должен:

1. Понять что план — это либо текущее сообщение пользователя, либо последний значимый план в session (если он сказал «проверь то что мы только что обсудили»)
2. Сохранить план в <persistence_dir>/plan.md (по схеме ниже)
3. Запустить Workflow({scriptPath: "~/.claude/skills/plan-panel/workflow/panel.js", args: {plan_text, project_slug, mode}}) ⚠️ Workflow-песочница без ФС-доступа — передавай содержимое плана инлайн в plan_text, а не путь. Если план уже на диске (plan.md) — сначала Read его, затем подставь текст в plan_text. (panel.js читает args.plan_text, поля plan_path нет.)
4. После завершения — показать пользователю summary из judge.md + предложить /panel-feedback

Запуск --from-task (Stage 1: задача без плана)

Когда пользователь даёт задачу, а не план (триггеры выше / явный --from-task):

1. Setup persistence с run_type=from-task: bash lib/persist.sh "<cwd>" "<task-slug>" from-task → <project_dir>|<central_dir>|<ts>
2. Запустить reviewer-loop workflow: Workflow({scriptPath: "~/.claude/skills/plan-panel/workflow/reviewer-loop.js", args: {task_text, project_slug, cwd, project_dir, timestamp, mode, max_iters: 2, panel_path: "~/.claude/skills/plan-panel/workflow/panel.js"}})
   • Phase 0 Draft (Fable planner, читает код) → петля: panel.js (scope→roles→judge) → revise ×≤2.
   • scope-once: scoper считается на iter 1, переиспользуется (precomputed_scoper) далее.
3. После завершения — записать версии плана через lib/persist-plan.sh <project_dir> <N> (strip + canonical), плюс артефакты финальной панели (review.md/judge.md) как в обычном flow.
4. Показать пользователю: финальный verdict, сколько кругов, converged?/ceiling?, top-5 действий, путь к plan.md. Если next_action:'finalize' — закрыть петлю фразой «архитектура подтверждена, остаток — DoD кодинга → дальше /finalize по diff», без предложения ещё круга.

Edge-cases (обрабатывает reviewer-loop):

• задача расплывчата → clarification:true + open_questions[] → показать пользователю, НЕ гонять петлю;
• code_was_read=false → warning (план не заземлён на код);
• не сошлось за MAX_ITERS → converged:false + reason; oscillation (critical вырос) → ранний break;
• ceiling:true + next_action:'finalize' → confidence вышла на плато при NEEDS-WORK, остаток — implementation-DoD. Не предлагать новый круг — направить на /finalize (см. ниже). Срабатывает только на NEEDS-WORK (FAIL/UNCERTAIN петля доводит до MAX_ITERS как раньше) и требует ≥2 итераций (на iter 1 prevConfidence=null → guard fail-open).

Флаги: --lite/--ultra управляют глубиной review-фаз (как обычно); cost-gate для --from-task --ultra.

Persistence dirs (hybrid)

Project-local: <cwd>/.plan-panel/<YYYY-MM-DD_HH-MM>-<plan-slug>/ Central mirror: $CLAUDECORE_PATH/plan-panel/<project-slug>/<YYYY-MM-DD_HH-MM>-<plan-slug>/

<project-slug> определяется через project-map skill ($CLAUDECORE_PATH/projects/<slug>.md if cwd matches a known project) или fallback на basename cwd.

Создаются обе папки + symlink: central → project (чтобы редактирование одного отражалось в обоих).

Modes

• standard (default heavy): scoper + architect + qa + judge + relevant conditional roles. Judge с cross-examination. Fable для judge, Sonnet для остальных. ~$0.70-2.50 if API, $0 if Max.
• --lite: scoper + architect + qa + judge. Без conditional ролей, без cross-exam. Sonnet роли, Fable judge. ~$0.20 if API, $0 if Max.
• --ultra: standard + Phase 4 «CrossModel». Финальный план + Claude judge.md прогоняется через GPT-5 + Gemini 2.5 Pro параллельно как outside opinion. Meta-judge синтезирует 3 точки зрения. Cross-model часть всегда платная (API через 1Password items OpenAI + Gemini): ~+$0.10-0.20 на real план. Для критических планов где важно «третье мнение».

Output to user

После завершения workflow возвращает:

• Path к judge.md
• Summary action list (top-5 priority)
• Conflict count (если были)
• Gap count (что ни одна роль не покрыла)
• Кнопка: «дай feedback по ролям» → /panel-feedback

Ceiling-handoff (verdict=NEEDS-WORK): если final_verdict_reasoning судьи говорит, что остаток critical — implementation-уровня (архитектурных не осталось), это потолок панели (PASS запрещает любой critical, а детальный план всегда вскрывает implementation-critical из текста — см. roles/judge.md §Ceiling). Не предлагать ещё круг plan-review — сказать пользователю: «замысел подтверждён, priority_actions = DoD-чеклист для кодинга; верификация реализации → /finalize (code-review по diff)».

Не забывать

• Не запускать на тривиальных планах (1-2 шага, без сложности). Scoper должен возвращать complexity: 'low' → можно skip с предложением "план тривиальный, нужен ли panel?".
• Не двойной запуск: если в этой же сессии уже был /plan-review на тот же план — спросить пользователя re-run или показать предыдущий результат. Если прошлый прогон вернул NEEDS-WORK с implementation-уровня остатком (ceiling) — по умолчанию НЕ перезапускать, а направить на /finalize: новый круг не сойдётся к PASS, только сожжёт токены (2-3 раунда достаточно — потолок ~0.85).
• Версионирование plan.md: если план эволюционировал — каждый run создаёт новую папку timestamp'a, старые не перезаписываются.

Acceptance criteria (Done-when) для каждой фазы

Edge cases