flow-next — правило для Claude Code: что делает и как установить
Правило flow-next направляет агента вести задачи через flowctl в каталоге .flow/ и запрещает обычные TODO в markdown.
MIT ★ 730 обновлён 2026-10-29
.cursor/rules/flow-next.mdcЧто делает flow-next
Правило активируется при наличии папки .flow/ или упоминании задач fn-N. Оно обязывает модель перечитывать спецификацию перед началом работы. Обычные списки задач и инструмент TodoWrite запрещены. Весь трекинг ведётся через утилиту flowctl.
Команды выполняются через скрипт плагина или локальный путь .flow/bin/flowctl. Инструкция описывает переходы задачи от start до done с фиксацией коммитов и проверок в JSON. Для подготовки спецификаций запускается связка с командой /flow-next:plan <id>.
Если утилита flowctl не найдена, агент должен запустить /flow-next:setup. Перед передачей задач утилитам вроде codex exec или claude -p правило требует изучить справку в $FLOWCTL usage.
Какие задачи решает
- отслеживать жизненный цикл задач через консоль flowctl
- фиксировать коммиты и результаты тестов при закрытии задач
- создавать спецификации и привязывать к ним планы реализации
- исключить появление разрозненных списков TODO в markdown
Примеры запросов агенту
- Покажи список текущих задач через flowctl
- Переведи задачу fn-1.2 в статус start и перечитай её спецификацию
- Отметь задачу fn-1.2 как done и приложи файл свидетельств
Как установить flow-next
Вручную: положить файлы
.cursor/rules/flow-next.mdcВо frontmatter: description, globs, alwaysApply
1Через маркетплейс плагинов
/plugin marketplace add gmickel/flow-next/plugin install flow-next@flow-next2Вручную: положить файлы
.claude/rules/flow-next.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/flow-next.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/flow-next.mdВручную: положить файлы
.clinerules/flow-next.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о flow-next
Как установить flow-next в Claude Code?
Выполните команду /plugin marketplace add gmickel/flow-next, а затем установите пакет вызовом /plugin install flow-next@flow-next.
Что делает правило flow-next?
Оно направляет ИИ вести учёт задач с префиксом fn-N.M через CLI-инструмент flowctl в директории .flow/. При этом использование временных markdown-файлов для списков задач блокируется.
Что делать, если утилита flowctl не найдена?
Если скрипт отсутствует по путям плагина или в .flow/bin/flowctl, нужно запустить команду /flow-next:setup.
Исходный текст
flow-next.mdc · MIT
---
description: Apply when the workspace contains a .flow/ directory or the conversation involves flow-next, flowctl, or fn-N task ids. Flow-Next task lifecycle and flowctl usage pull directives (Cursor guidance rail).
alwaysApply: false
---
# Flow-Next
This project uses Flow-Next for ALL task tracking. Do NOT create markdown TODOs or use TodoWrite. Re-anchor (re-read spec + task status) before every task.
Resolve flowctl once per shell block, then use `$FLOWCTL` (Cursor sets no plugin-root env var, so the derivation rung is the one that carries here):
```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"
```
- Lifecycle: `$FLOWCTL list` / `show fn-N.M` / `start fn-N.M` / `done fn-N.M --summary-file s.md --evidence-json e.json` (e.json: `{"commits": ["<sha>"], "tests": ["<cmd>"], "prs": []}`)
- BEFORE any other flowctl operation, or when unsure of a flag: run `$FLOWCTL usage` (CLI cheatsheet + orchestration recipes).
- BEFORE bridging work to another model/CLI (`codex exec`, `cursor-agent`, `claude -p`, `grok`) or picking an implementation/review model: run `$FLOWCTL usage` and follow "Orchestration & model steering" exactly.
- Creating a spec: `$FLOWCTL spec create --title "Short title" --json`, then `$FLOWCTL spec set-plan <id> --file plan.md`, then `/flow-next:plan <id>` (Cursor autocomplete may show the hyphenated form `/flow-next-plan`).
- If `flowctl` is not found: run `/flow-next:setup`.
© Gordon Mickel · MIT · gmickel/flow-next