Flow Next Plan

Omdanner feature-anmodninger eller Flow IDs til strukturerede .flow specs med sized tasks, ingen kode

Af gmickel · gmickel/flow-next

Virker med opsætning ★ 8.8/10

Flow Next Plan — Omdanner feature-anmodninger eller Flow IDs til strukturerede .flow specs med sized tasks, ingen kode

Hvad det gør

En planlægnings-skill til flow-next plugin'et, der konverterer en feature-anmodning eller et eksisterende Flow ID til en struktureret spec plus passende sized tasks gemt i .flow/ via et bundtet flowctl CLI, der håndhæver testbare R-ID acceptkriterier og en ingen-implementeringskode regel. Udløses på /flow-next:plan slash-kommandoen med en tekstbeskrivelse eller et Flow ID (fn-1-add-oauth, fn-1-add-oauth.2). Den planlægger kun; implementering sker senere i /flow-next:work.

Testrapport

Klonede repoet og kørte den bundtede flowctl (Python) i en midlertidig HOME: `init` scaffoldede .flow/, `spec create` + `spec set-plan` + `task create` producerede en reel spec og task, og `validate --spec` returnerede valid:true, task_count:1. Byggede to artefakter til "rate limit login-endpointet": en baseline plan (15-linjers copy-paste JS rateLimit implementering, én task der klumper 9 bekymringer sammen, accept = "den virker og blokerer for mange logins") vs. den skill-følgende spec (kun signatur `function rateLimit(req,res,next):void`, eksplicit Scope IN/OUT, fem nummererede testbare R1-R5 acceptkriterier, én enkelt M-sized task, et fremhævet åbent spørgsmål) — den skill-følgende version validere rent via flowctl. Kunne IKKE køre den obligatoriske parallelle scout fan-out (repo-scout/docs-scout er plugin subagenter), så fil:linje genbrugsreferencer forblev pladsholdere; det plus plugin-runtime-afhængigheden (flowctl løses kun efter installation af hele plugin'et og kørsel af /flow-next:setup) er friktionspunktet for opsætning. Alle refererede filer (steps.md, examples.md, references/html-artifacts.md, scripts/flowctl) returnerede HTTP 200; ingen sikkerhedsrisici — ingen curl|sh, base64 blobs eller exfiltration.

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

Installation

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.

Kommandoer og eksempelprompter

  • /flow-next-planOmdanner feature-anmodninger eller Flow IDs til strukturerede .flow specs med sized tasks, ingen kode

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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