Flow Next Plan

Wandelt Feature-Anfragen oder Flow-IDs in strukturierte .flow-Spezifikationen mit dimensionierten Aufgaben um, ohne Code

von gmickel · gmickel/flow-next

Funktioniert mit Setup ★ 8.8/10

Flow Next Plan — Wandelt Feature-Anfragen oder Flow-IDs in strukturierte .flow-Spezifikationen mit dimensionierten Aufgaben um, ohne Code

Was es kann

Ein Planungs-Skill für das flow-next-Plugin, der eine Feature-Anfrage oder eine bestehende Flow-ID in eine strukturierte Spezifikation plus passend dimensionierte Aufgaben umwandelt, die in .flow/ über ein gebündeltes flowctl CLI gespeichert werden, wobei testbare R-ID-Akzeptanzkriterien und eine No-Implementation-Code-Regel durchgesetzt werden. Wird ausgelöst durch den Slash-Befehl /flow-next:plan mit einer Textbeschreibung oder einer Flow-ID (fn-1-add-oauth, fn-1-add-oauth.2). Er plant nur; die Implementierung erfolgt später in /flow-next:work.

Testbericht

Das Repo geklont und das gebündelte flowctl (Python) in einem temporären HOME ausgeführt: `init` gerüstete .flow/, `spec create` + `spec set-plan` + `task create` erzeugten eine echte Spezifikation und Aufgabe, und `validate --spec` gab valid:true, task_count:1 zurück. Zwei Artefakte für "rate limit the login endpoint" erstellt: einen Baseline-Plan (15-zeilige Copy-Paste-JS-rateLimit-Implementierung, eine Aufgabe, die 9 Bedenken zusammenfasst, Akzeptanz = "it works and blocks too many logins") vs. die Skill-konforme Spezifikation (nur Signatur `function rateLimit(req,res,next):void`, expliziter Scope IN/OUT, fünf nummerierte testbare R1-R5-Akzeptanzkriterien, eine einzelne M-große Aufgabe, eine aufgetauchte offene Frage) – die Skill-Version wurde via flowctl sauber validiert. Konnte den obligatorischen parallelen Scout-Fan-Out (repo-scout/docs-scout sind Plugin-Subagents) NICHT ausführen, daher blieben Datei:Zeilen-Wiederverwendungsreferenzen als Platzhalter; dies plus die Plugin-Laufzeitabhängigkeit (flowctl löst sich erst nach der Installation des gesamten Plugins und der Ausführung von /flow-next:setup auf) ist die Setup-Reibung. Alle referenzierten Dateien (steps.md, examples.md, references/html-artifacts.md, scripts/flowctl) gaben HTTP 200 zurück; keine Sicherheitsrisiken – keine curl|sh, base64-Blobs oder Exfiltration.

Getestet am: 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.

Befehle & Beispiel-Prompts

/flow-next-planWandelt Feature-Anfragen oder Flow-IDs in strukturierte .flow-Spezifikationen mit dimensionierten Aufgaben um, ohne Code

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →