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

flow-next-plan-review — скилл для Claude Code: обзор планов

Скилл flow-next-plan-review для Claude Code направляет проверку спецификаций и планов через выбранный бэкенд и запускает цикл исправлений и повторного ревью. Проверяет Flow-документы.

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

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает flow-next-plan-review

Скилл координирует ревью планов и спецификаций Flow через Codex, Copilot, Cursor, Claude Code или встроенный бэкенд. Выбор задаётся аргументом --review, настройкой спецификации, переменной окружения или конфигурацией проекта. Координатор не выносит вердикт сам: он передаёт работу выбранному проверяющему и следует его результату.

При NEEDS_WORK скилл правит текущий файл спецификации, сохраняет его через flowctl, синхронизирует затронутые задачи и передаёт документ на повторную проверку тем же бэкендом. В обычном режиме предусмотрены один проход исправлений и одно повторное ревью; для автономного цикла действуют ограничения flowctl. Сбой бэкенда останавливает проверку, а переключаться на другой бэкенд автоматически нельзя, поэтому его доступность нужно проверить заранее.

Для работы нужны Flow-спецификация и настроенный бэкенд ревью. Явный режим none, rp или export завершает общий маршрут без запуска бэкенда.

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

  • проверить план Flow перед началом реализации
  • найти проблемы в спецификации и получить вердикт ревьюера
  • исправить замечания в текущем плане и отправить его на повторное ревью
  • направить проверку через выбранный бэкенд

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

  • Запусти /flow-next:plan-review для спецификации SPEC_ID и проверь её через Codex.
  • Проведи ревью плана SPEC_ID, сосредоточься на обработке ошибок и используй --review=claude.
  • Проверь план SPEC_ID в автономном режиме: mode:autonomous.

Как установить flow-next-plan-review

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

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gmickel/flow-next --skill flow-next-plan-review -a claude-code

3Вручную: положить файлы

~/.claude/skills/flow-next-plan-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flow-next-plan-review/

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

Вопросы о flow-next-plan-review

Как установить flow-next-plan-review в Claude Code?

В Claude Code сначала добавьте маркетплейс командой /plugin marketplace add gmickel/flow-next, затем установите плагин командой /plugin install flow-next@flow-next.

Что делает flow-next-plan-review?

Он передаёт план или спецификацию Flow выбранному бэкенду на ревью, затем обрабатывает замечания и организует повторную проверку.

Как скилл выбирает бэкенд для ревью?

Сначала учитывается аргумент --review, затем настройка для конкретной спецификации, переменная FLOW_REVIEW_BACKEND и конфигурация .flow/config.json. Автоматического выбора по обнаруженной среде нет.

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

SKILL.md · MIT
---
name: flow-next-plan-review
description: Carmack-level plan review via Codex, Copilot, Cursor, Claude or a host reviewer. Use when reviewing Flow specs or design docs. Triggers on /flow-next:plan-review.
user-invocable: false
---

# Plan Review Mode

**Workflow is backend-split. Read [workflow.md](workflow.md) for common
orchestration and backend resolution, then read ONLY the file matching the
selected review backend:**

- `BACKEND=codex` → [workflow-codex.md](workflow-codex.md)
- `BACKEND=copilot` → [workflow-copilot.md](workflow-copilot.md)
- `BACKEND=cursor` → [workflow-cursor.md](workflow-cursor.md)
- `BACKEND=claude` → [workflow-claude.md](workflow-claude.md)
- `BACKEND=host` → [workflow-host.md](workflow-host.md)

Do not load the other backend files. `BACKEND=none` and an explicit
`--review=rp` or `--review=export` terminate from the common workflow without
loading any backend file.

Conduct a John Carmack-level review of spec plans.

**Role**: Code Review Coordinator (NOT the reviewer)
**Backends**: Codex CLI (codex), GitHub Copilot CLI (copilot), Cursor CLI (cursor),
Claude Code CLI (claude), or host-native (`host`)

Read [working-rules.md](../../references/working-rules.md) first unless you already have this run; it holds for every step of this skill.

## Preamble — execute common routing exactly once

Read and execute [workflow.md](workflow.md) Phase 0 once. It defines `$FLOWCTL`,
parses an explicit `--review` mode before configured-backend resolution,
resolves `SPEC_ID`, and handles `ASK`, `none`, `rp` and `export`. Never invoke
`flowctl review-backend` a second time.

## Backend Selection

Priority (first match wins):

1. `--review=codex|copilot|cursor|claude|host|none`
2. Per-spec `default_review`
3. `FLOW_REVIEW_BACKEND`
4. `.flow/config.json` `review.backend`
5. Error — no auto-detection

Configured values accept `backend[:model[:effort]]`; `cursor` takes a model but
no effort, `claude` takes `claude[:<model>[:<effort>]]`, and `host` and `none` are bare-only.

## Common Critical Rules

- The coordinator never self-declares a verdict.
- Stick to one backend for the full review/fix cycle.
- If `REVIEW_RECEIPT_PATH` is set, every review verdict writes a receipt.
- Any backend/transport failure outputs `RETRY: no verdict (backend or transport failure)` and stops;
  never silently fall back to a different backend. When its `CLI message:` reports a usage, credit
  or spend limit, report that message and stop instead of `RETRY:`; a retry fails the same way. Autonomous callers
  receive the same retry terminal and decide whether to re-enter. A no-verdict
  dispatch is refunded and recorded by flowctl; never manually reset the review
  counter for a transport failure. Exit 5 / `TRANSPORT_UNHEALTHY` means stop
  automatic retries and repair the backend.
- `none` skips only when selected explicitly or resolved from configuration.
- **Foreground rule:** run every `flowctl <backend> plan-review` call as one **blocking foreground** Bash call with a generous timeout (10 minutes; verdicts typically land in 1–7) — never `run_in_background` + monitor/poll (a background completion does not reliably resume a subagent context). Host-backend subagent dispatches are also blocking.

Backend-specific invocation, availability, model, session-continuity, receipt,
and anti-pattern rules live only in the selected backend file.

## Input

Arguments: $ARGUMENTS

Format: `<flow-spec-id> [focus areas] [--review=<mode>] [mode:autonomous]`. `mode:autonomous` marks an
unattended run (working-rules.md's review loop applies); it is not a focus area.

## Workflow

1. Execute [workflow.md](workflow.md) Phase 0.
2. If it returns for `none`, `rp` or `export`, stop. Do not read a backend file.
3. Read exactly the selected `workflow-<backend>.md`.
4. Execute one backend dispatch and carry its verdict directly into the shared
   Fix Loop below.
5. Continue in that loop until its terminal contract is satisfied.

## Fix Loop (INTERNAL)

**The fix loop never pauses for user confirmation**; never use AskUserQuestion in it. Which findings it fixes, and which it lists as follow-ups, follows the Review section of [working-rules.md](../../references/working-rules.md).

`MAJOR_RETHINK` is not a fix-loop input. Surface the reviewer's rationale and
stop with `BLOCKED: DESIGN_CONFLICT`. `NEEDS_HUMAN` is not one either: stop and hand the
reviewer's question to the person, on every backend. Only `NEEDS_WORK` enters the loop.

Attended: one fix pass, then one re-review, whose verdict is terminal. When working-rules.md's
review loop applies (an unattended run, or a request to review until SHIP), repeat the steps
below until SHIP or an `ESCALATE:`. The flowctl cap below stays as the backstop; never keep an
agent-side counter.

**The cap is enforced deterministically by flowctl:** every dispatch reserves a
spec-scoped round before launch. SHIP / NEEDS_WORK / MAJOR_RETHINK / NEEDS_HUMAN consume it;
a no-verdict transport failure is durably recorded and refunded. At
`${MAX_REVIEW_ITERATIONS:-8}` verdict rounds, flowctl refuses with `ESCALATE:`
and exit 4. More than `${MAX_REVIEW_TRANSPORT_FAILURES:-2}` consecutive
no-verdict failures stop separately with `TRANSPORT_UNHEALTHY` + exit 5.
Callers invoke plan-review once and act on its terminal result. The verdict
counter resets only on SHIP or an explicit re-plan, never on an edit, fresh
invocation, or transport failure.**

**ANTI-PATTERN:** a delivered verdict is never a transport failure - never
re-dispatch or re-frame `NEEDS_WORK` as a backend/sandbox problem to claim a
refund. And never widen the reviewer sandbox: reviewers are read-only by
contract, so a sandbox-blocked reviewer means something asked it to mutate the
workspace. Fix that instead (Windows resolves via `auto`).

When the verdict is `NEEDS_WORK`:

1. Parse all valid issues from reviewer feedback.
2. Fix the user-edited current spec, never a checkpoint copy: edit the spec
   file in place (`spec_path` from `$FLOWCTL show <SPEC_ID> --json`), then
   persist that file. The file on disk is the input, so an edit the user made
   between cycles survives; on a `set-plan` failure, surface its error and stop
   the cycle.

   ```bash
   $FLOWCTL spec set-plan <SPEC_ID> --file <spec path> --json
   ```

3. Sync affected task specs when requirements, acceptance, design decisions,
   interfaces, retry/error semantics, or state values changed.
4. Re-enter the SAME selected backend file's re-review step. Never load or mix
   another backend. Codex/Copilot/Cursor/Claude resume only through a same-mode receipt;
   host uses a fresh read-only subagent.
5. Attended, stop after that one re-review: `SHIP` completes; `NEEDS_WORK` surfaces the
   surviving findings to the caller, never a second fix pass. In the review loop, repeat
   from step 1 as above.

**Done when:** the review ends in one of exactly five states — a `SHIP` from the
backend, a re-review `NEEDS_WORK` with its surviving findings surfaced, a
`MAJOR_RETHINK` escalated as `BLOCKED: DESIGN_CONFLICT`, a
`RETRY: no verdict (backend or transport failure)` from a backend/transport failure, or flowctl's
`ESCALATE:` cap refusal with the surviving findings surfaced. A round that ends
with a `NEEDS_WORK` neither fixed in the current spec nor re-entered into the
same backend has broken this.

**Maintainability pointer.** When the verdict's `maintainability:` block names a finding
(anything other than `none identified`): read
[references/maintainability-pointer.md](references/maintainability-pointer.md) and record it.

Recovery after context compaction:

```bash
$FLOWCTL checkpoint restore --spec <SPEC_ID> --json
```

Every re-review follows the selected backend file's receipt/status rules.

© Gordon Mickel · MIT · gmickel/flow-next

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
react-flow-code-review existential-birds Скилл react-flow-code-review для Claude Code и Codex проверяет код на @xyflow/react по чек-листу: антипаттерны, лишние ре-рендеры, типы. Фиксирует тормоза графа и пересоздание нод. CX Codex +1 329установок ux-flow-plan jnsahaj Скилл ux-flow-plan помогает составить план архитектуры от сценария пользователя к коду в виде дерева переходов. Пригодится перед рефакторингом или разработкой фичи, чтобы не лезть сразу в детали реализации. CX Codex +1 147установок w-review-plan blockmatic-icebox Скилл w-review-plan для Claude Code проверяет цели, допущения, задачи, риски и ссылки в плане. Сверяет его с кодом и документацией проекта. CX Codex +1 649установок gsd-plan-review-convergence open-gsd Скилл gsd-plan-review-convergence для Claude Code и Codex запускает цикл ревью и доработки плана разработки с участием нескольких внешних ИИ-агентов. CX Codex +1 581установок plan-devex-review garrytan Скилл plan-devex-review для Claude Code разбирает план developer experience в диалоге. Он включается для ревью DX и проверки онбординга разработчиков. CX Codex +1 378установок plan-founder-review ulpi-io Скилл plan-founder-review читает план и его JSON, сверяет пути и заявленное переиспользование с реальным репозиторием и выносит вердикт APPROVE, REVISE или REJECT до того, как агенты начнут работу. CX Codex +1 170установок

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

Весь набор →
flow-next-tracker-sync Скилл flow-next-tracker-sync проецирует спеку flow-next в задачу Linear, GitHub, GitLab или Jira и сверяет тело, статус и комментарии. Спека остаётся источником правды. CX Codex +1 ★ 730звёзд репо claude-md-scout Субагент claude-md-scout оценивает содержательность файлов CLAUDE.md и AGENTS.md по шкале из восьми пунктов, проверяя наличие реальных команд и проектных правил перед стартом работы. CX Codex ★ 730звёзд репо flow-gap-analyst Субагент flow-gap-analyst разбирает краткое описание функции и находит пробелы, неоднозначности и пограничные случаи. Он помогает собрать вопросы, на которые нужно ответить до начала разработки. CX Codex ★ 730звёзд репо flow-next-deps Скилл flow-next-deps для Claude Code показывает граф зависимостей спеков, порядок выполнения и цепочки блокировок. Помогает определить, что заблокировано и в каком порядке запускать спеки. CX Codex +1 ★ 730звёзд репо flow-next-impl-review Запускает ревью реализации в стиле Джона Кармака через указанный бэкенд — claude, codex, copilot, cursor или человека. Вызывается командой /flow-next:impl-review. CX Codex +1 ★ 730звёзд репо flow-next-work Скилл flow-next-work исполняет задачи и спецификации Flow-Next по шагам: готовит ветку Git, ведёт трекинг через flowctl, запускает тесты и фиксирует коммиты. CX Codex +1 ★ 730звёзд репо flow-next-spec-completion-review Скилл flow-next-spec-completion-review сверяет готовую спеку с её требованиями: закрывают ли все задачи вместе то, что было задумано. Пригодится перед тем, как считать работу по спеке законченной. CX Codex +1 ★ 730звёзд репо flow-next-capture Скилл flow-next-capture превращает текущий диалог с агентом в готовую спецификацию .flow/specs/<spec-id>.md через внутреннюю утилиту flowctl без потери договорённостей. CX Codex +1 ★ 730звёзд репо

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

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