Flow Next Plan

Zet feature requests of Flow ID's om in gestructureerde .flow specs met getaskte taken, geen code

Door gmickel · gmickel/flow-next

Werkt met setup ★ 8.8/10

Flow Next Plan — Zet feature requests of Flow ID's om in gestructureerde .flow specs met getaskte taken, geen code

Wat het doet

Een planning skill voor de flow-next plugin die een feature request of een bestaande Flow ID omzet in een gestructureerde spec plus taken van de juiste grootte, opgeslagen in .flow/ via een gebundelde flowctl CLI, waarbij testbare R-ID acceptatiecriteria en een geen-implementatie-code regel worden afgedwongen. Activeert op het /flow-next:plan slash commando met een tekstbeschrijving of een Flow ID (fn-1-add-oauth, fn-1-add-oauth.2). Het plant alleen; implementatie gebeurt later in /flow-next:work.

Testrapport

De repo gekloond en de gebundelde flowctl (Python) uitgevoerd in een tijdelijke HOME: `init` scaffolded .flow/, `spec create` + `spec set-plan` + `task create` produceerde een echte spec en taak, en `validate --spec` retourneerde valid:true, task_count:1. Twee artefacten gebouwd voor "rate limit the login endpoint": een baseline plan (15-regelige copy-paste JS rateLimit implementatie, één taak die 9 zorgen samenvoegt, acceptatie = "it works and blocks too many logins") versus de skill-gevolgde spec (alleen signature `function rateLimit(req,res,next):void`, expliciete Scope IN/OUT, vijf genummerde testbare R1-R5 acceptatiecriteria, één M-grote taak, een naar voren gebrachte open vraag) — de skill-versie valideerde schoon via flowctl. Kon de verplichte parallelle scout fan-out niet uitvoeren (repo-scout/docs-scout zijn plugin subagents), dus file:line hergebruik referenties bleven als placeholders; dat plus de plugin-runtime afhankelijkheid (flowctl lost pas op na installatie van de hele plugin en uitvoering van /flow-next:setup) is de setup-frictie. Alle gerefereerde bestanden (steps.md, examples.md, references/html-artifacts.md, scripts/flowctl) retourneerden HTTP 200; geen beveiligingsrisico's — geen curl|sh, base64 blobs, of exfiltratie.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/gmickel/flow-next.git /tmp/flow-next-plan-src
mkdir -p ~/.claude/skills
cp -R /tmp/flow-next-plan-src/plugins/flow-next/skills/flow-next-plan ~/.claude/skills/flow-next-plan
# IMPORTANT: this skill is a COMPONENT of the flow-next plugin and is NOT functional as a
# lone skill copy. It calls a bundled flowctl at $CLAUDE_PLUGIN_ROOT/scripts/flowctl (unset
# for a standalone skill) then falls back to .flow/bin/flowctl, which only exists AFTER setup.
# Proper install is via the plugin marketplace, then run setup to scaffold .flow/ and flowctl:
#   /plugin marketplace add gmickel/flow-next
#   /plugin install flow-next
#   /flow-next:setup          # creates .flow/ and .flow/bin/flowctl
# Invoke (skill is user-invocable:false — driven by the command): /flow-next:plan <feature or fn-ID>
# Deps: python3 (flowctl runtime), jq. flowctl is zero-dependency pure-stdlib Python.

Commando's en voorbeeldprompts

  • /flow-next-planZet feature requests of Flow ID's om in gestructureerde .flow specs met getaskte taken, geen code

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Plan the implementation for the fn-1-add-oauth spec
  • Create a build plan from this feature request
  • Design the implementation steps for this Flow spec