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

flow-next-plan — скилл для Claude Code: планы и установка

Скилл flow-next-plan превращает описание функции или существующую спецификацию в план задач, опираясь на исследование репозитория. Он пригодится до начала реализации: код скилл не пишет.

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

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

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

На вход можно дать идею, ID спецификации или задачи либо идентификатор, который разрешает flowctl. Результат — спецификация и задачи в .flow/; этот каталог служит единственным трекером, а изменения проходят через flowctl. В плане фиксируются контракты, файлы, порядок работ и заметки по реализации, но не готовые модули.

Скилл сначала инициализирует flowctl и сохраняет снимок настроек, затем запускает исследовательские субагенты параллельно — их набор зависит от глубины плана. По умолчанию глубина короткая; её можно изменить через --depth=standard или --depth=deep. Идею с несколькими важными неизвестными он направит на этап исследования, а не станет разбирать как готовую спецификацию.

Без входного запроса скилл попросит описать задачу; в автономном режиме остановится с NEEDS_HUMAN. Для работы нужен репозиторий с конфигурацией flowctl: запускать инициализацию из каталога скилла нельзя. Это ограничение важно — там flowctl не найдёт конфигурацию проекта.

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

  • разложить запрос на функцию на спецификацию и задачи
  • составить план реализации по ID спецификации
  • разрешить ID задачи через flowctl и спланировать её
  • зафиксировать порядок работ и файлы для каждой задачи

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

  • Составь план для добавления OAuth-входа в приложение.
  • Разбей спецификацию fn-1-add-oauth на задачи.
  • Спланируй задачу fn-1-add-oauth.2 с глубиной --depth=standard.

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

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 -a claude-code

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

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

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

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

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

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

Выполните /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next.

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

Он исследует репозиторий и создаёт спецификацию с задачами в .flow/. Код при этом не пишет.

Где flow-next-plan хранит план?

Спецификации и задачи хранятся в .flow/, а изменения выполняются через flowctl. Другой список задач вместо этого каталога использовать нельзя.

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

SKILL.md · MIT
---
name: flow-next-plan
description: Create structured build plans from feature requests or Flow IDs. Use when planning features or designing implementation. Triggers on /flow-next:plan with text descriptions or Flow IDs (fn-1-add-oauth, fn-1-add-oauth.2, or legacy fn-1, fn-1.2, fn-1-xxx, fn-1-xxx.2).
user-invocable: false
---

# Flow plan

Turn an idea or an existing spec into a spec with right-sized tasks in `.flow/`, grounded in repo research. Plan writes no code.

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

**`.flow/` is the only task tracker.** Every spec and task is created or changed through `flowctl`. A markdown TODO list, a TodoWrite call, or a plan file kept outside `.flow/` as the record has broken this.

## Preamble

**flowctl is bundled, not installed globally** (`which flowctl` fails). Define it once; later blocks here and in `steps.md` use `$FLOWCTL`:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

Check once for flowctl copies left by an older install layout:

```bash
LEFTOVERS=""
for p in .flow/bin/flowctl .flow/bin/flowctl.cmd .flow/bin/flowctl.py \
         .flow/bin/flowctl_bootstrap.py .flow/bin/flowctl-help.txt \
         .flow/bin/flowctl_tracker .flow/templates/spec.md .flow/usage.md; do
  [ -e "$p" ] && LEFTOVERS="${LEFTOVERS}${p}"$'\n' || true
done   # || true: an empty LEFTOVERS (the normal case) must read as success
```

None present: say nothing. Any present: print one line saying nothing reads them and they can be deleted by hand or by `/flow-next:setup`, then continue. Never ask, stop, or delete here.

## No implementation code

The spec states what and why as contracts; each task states how: named files, the repo pattern to follow (`file:line`), ordering, and non-obvious gotchas. Code in a plan is limited to signatures and interfaces, pointers to existing patterns, a recent or surprising API from docs-scout, and a gotcha from practice-scout. A full function or module body, or a copy-paste block over about 10 lines, has broken this: implementation happens in `/flow-next:work` with fresh context, and code written here is paid for again there and drifts.

## Input

Full request: $ARGUMENTS

Accepts a freeform idea; a spec id `fn-N-slug` (legacy `fn-N`, `fn-N-xxx`); a task id `fn-N-slug.M` (legacy `fn-N.M`, `fn-N-xxx.M`); a tracker handle such as `wor-17` that `flowctl show` resolves (always the existing spec or task, never a new idea; see Step 1); and chained instructions such as "then review with /flow-next:plan-review".

Empty input: ask "What should I plan? Give me the feature or bug in 1-5 sentences." Under autonomy, report `NEEDS_HUMAN: no planning input provided` and stop.

A ready or captured spec is plan input. An unshaped, oversized idea with several consequential unknowns is not: recommend `/flow-next:chart` (or `/flow-next:flow --explain` when unsure) and stop. Plan decomposes understood work; it does not replace discovery.

## Options

**Autonomy.** The literal token `mode:autonomous` in `$ARGUMENTS` (strip it) or `FLOW_AUTONOMOUS=1` sets `AUTONOMOUS=1`. Then no question is ever asked: explicit flags win, and anything unset takes its default (depth below, research `repo-scout`, review the configured backend, `none` when it is `ASK`). A genuinely unanswerable ambiguity stops with a one-line `NEEDS_HUMAN: <reason>`.

**Depth.** `--depth=short` ("quick", "minimal"), `--depth=standard` ("normal"), `--depth=deep` ("comprehensive", "detailed"). Default SHORT. Depth picks the scout set (Step 1) and the spec sections (Step 4).

**Research.** Always `repo-scout`; `--research=grep` is a no-op and any other value is ignored.

**Review.** `--review=codex` ("review with codex", "codex review", "use codex"), `--review=host` ("host review", "use host": the host-native fresh-context reviewer), `--review=none` or `--no-review` ("no review", "skip review"). `--review=rp` and `--review=export` were removed: say "RepoPrompt review (rp, export) was removed in flow-next 8.0.0; review backends: claude, codex, copilot, cursor, host." once and treat review as nothing configured (`ASK`, below).


Initialize and capture one preflight snapshot before routing or scouting (also under autonomy), from the repository root (never this skill's directory, where flowctl finds no config). Every later config read uses this literal path:

```bash
$FLOWCTL init --json
PLAN_CFG="${TMPDIR:-/tmp}/flow-plan-config-<suffix>.json"
$FLOWCTL preflight --json > "$PLAN_CFG" || printf '{"key":null,"value":{}}' > "$PLAN_CFG"
```

Plan asks no setup question: flags win, depth takes its default, and review uses the configured
backend from the snapshot (`.probes.review_backend.value.backend`). When that reads `ASK` (nothing
configured), review is `none` and the handoff says once "no review backend set; run setup or set
review.backend". Show the hint:

```
(Tip: --depth=short|standard|deep, --review=codex|copilot|cursor|claude|host|none)
```

## Workflow

Read [steps.md](steps.md) and follow each step in order. Its optional paths (readiness warning, Route A, tracker-first mint, tracker projection, review, next-steps menu) load their references only when the step's condition holds.

**Step 1 launches every scout in the depth-appropriate set, in ONE parallel Task call.** A plan whose research skipped a scout in its tier, or ran the set sequentially, has broken this.

## Output

- Spec: `.flow/specs/<spec-id>.json` + `.md`; tasks: `.flow/tasks/<spec-id>.M.json` + `.md`.
- No code changes. Specs and tasks live in `.flow/`; temporary drafts (the `/tmp` bodies steps.md writes) are fine.

© Gordon Mickel · MIT · gmickel/flow-next

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
ux-flow-plan jnsahaj Скилл ux-flow-plan помогает составить план архитектуры от сценария пользователя к коду в виде дерева переходов. Пригодится перед рефакторингом или разработкой фичи, чтобы не лезть сразу в детали реализации. CX Codex +1 147установок ship-learn-next davila7 Превращает транскрипт, статью или туториал в план конкретных действий по циклу Ship-Learn-Next: сделать, осмыслить, спланировать следующий шаг. CX Codex +1 82установок next mag123c Скилл next для старта сессии: читает последний файл планирования, смотрит git-лог и говорит, что делать дальше. CX Codex +1 ★ 196звёзд репо ce-plan EveryInc Скилл ce-plan для Claude Code и Codex: оформляет пошаговые планы задач разработки без запуска кода. Разбивает фичу на этапы и передаёт план исполнителю. CX Codex +1 4 000установок ralph-plan mastra-ai Скилл ralph-plan для Claude Code помогает по шагам составить команду ralph-loop через диалог и анализ кодовой базы. CX Codex +1 2 600установок speckit-plan github-spec-kit Скилл speckit-plan запускает воркфлоу планирования фичи в структуре spec-kit и готовит артефакты проектирования: исследовательские заметки и контракты интерфейсов. CX Codex +1 2 600установок

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

Весь набор →
docs-gap-scout Субагент docs-gap-scout смотрит на планируемое изменение и говорит, какие документы в репозитории придётся обновить, а какие останутся нетронутыми. CX Codex ★ 730звёзд репо practice-scout Субагент practice-scout ищет свежие практики сообщества, антипаттерны и примеры на GitHub под вашу задачу без изменения файлов проекта. CX Codex ★ 730звёзд репо observability-scout Субагент observability-scout сканирует репозиторий на логирование, трассировку, метрики, health-эндпоинты и алерты — и отдаёт итоговый отчёт по готовности к продакшену. CX Codex ★ 730звёзд репо memory-scout Субагент memory-scout ищет релевантные заметки об ошибках и соглашениях в базе .flow/memory/ перед планированием новой задачи. CX Codex ★ 730звёзд репо flow-next Скилл flow-next для Claude Code управляет задачами и спецификациями в .flow/: показывает списки и статусы, создаёт задачи и закрывает выполненные. Помогает разобраться, что запланировано и готово к работе. CX Codex +1 ★ 730звёзд репо github-scout Субагент github-scout для Claude Code ищет на GitHub примеры кода, реализации библиотек и открытые issues. Находит решения для изучения перед написанием своего кода. CX Codex ★ 730звёзд репо flow-next-prospect Скилл flow-next-prospect для Claude Code придумывает и ранжирует идеи развития на основе файлов репозитория. Запускается по просьбе обсудить, что строить дальше. CX Codex +1 ★ 730звёзд репо flow-next-map Скилл flow-next-map оборачивает clawpatch map, чтобы построить индекс функций и модулей репозитория на ~20 языках. По умолчанию работает без LLM-вызовов. CX Codex +1 ★ 730звёзд репо

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

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