Flow Next Plan

Trasforma richieste di feature o ID Flow in specifiche .flow strutturate con task dimensionati, senza codice

di gmickel · gmickel/flow-next

Richiede configurazione ★ 8.8/10

Flow Next Plan — Trasforma richieste di feature o ID Flow in specifiche .flow strutturate con task dimensionati, senza codice

Cosa fa

Una skill di pianificazione per il plugin flow-next che converte una richiesta di feature o un ID Flow esistente in una specifica strutturata più task di dimensioni adeguate memorizzati in .flow/ tramite una CLI flowctl inclusa, applicando criteri di accettazione testabili R-ID e una regola di assenza di codice di implementazione. Si attiva sul comando slash /flow-next:plan con una descrizione testuale o un ID Flow (fn-1-add-oauth, fn-1-add-oauth.2). Pianifica solo; l'implementazione avviene successivamente in /flow-next:work.

Rapporto di test

Clonato il repo ed eseguito la flowctl inclusa (Python) in una HOME temporanea: `init` ha scaffoldato .flow/, `spec create` + `spec set-plan` + `task create` ha prodotto una specifica e un task reali, e `validate --spec` ha restituito valid:true, task_count:1. Creati due artefatti per "limita la frequenza dell'endpoint di login": un piano baseline (implementazione JS rateLimit copiata e incollata di 15 righe, un task che raggruppa 9 preoccupazioni, accettazione = "funziona e blocca troppi login") vs la specifica conforme alla skill (solo firma `function rateLimit(req,res,next):void`, Scope IN/OUT esplicito, cinque criteri di accettazione testabili numerati R1-R5, un singolo task di dimensione M, una domanda aperta emersa) — la versione skill validata pulita tramite flowctl. Non ho potuto eseguire il fan-out scout parallelo obbligatorio (repo-scout/docs-scout sono agenti secondari del plugin), quindi i riferimenti riuso file:riga sono rimasti come placeholder; questo più la dipendenza dal runtime del plugin (flowctl si risolve solo dopo aver installato l'intero plugin ed eseguito /flow-next:setup) è l'attrito di installazione. Tutti i file referenziati (steps.md, examples.md, references/html-artifacts.md, scripts/flowctl) hanno restituito HTTP 200; nessun odore di sicurezza — nessun curl|sh, blob base64 o esfiltrazione.

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

Installazione

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.

Comandi e prompt di esempio

  • /flow-next-planTrasforma richieste di feature o ID Flow in specifiche .flow strutturate con task dimensionati, senza codice

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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