Flow Next Deps

Renderizza le dipendenze delle specifiche flow-next come fasi ready/blocked e segnala i deadlock di dipendenza

di gmickel · gmickel/flow-next

Richiede configurazione ★ 9.2/10

Flow Next Deps — Renderizza le dipendenze delle specifiche flow-next come fasi ready/blocked e segnala i deadlock di dipendenza

Cosa fa

Una skill plugin flow-next che legge i metadati delle specifiche tramite il flowctl CLI incluso e calcola un grafo di dipendenza: quali specifiche sono ready vs blocked, fasi di esecuzione parallela, il critical path e deadlock irrisolvibili (cicli o dipendenze mancanti). Si attiva su frasi come "cosa blocca cosa", "in che ordine dovrebbero essere eseguite le specifiche", "critical path" o "quali specifiche possono essere eseguite in parallelo". Ispezione di sola lettura; le modifiche sono delegate a flowctl spec add-dep/rm-dep.

Rapporto di test

Clonato il repo e eseguita l'esatta pipeline della skill contro i propri dati .flow/ usando il flowctl (Python 3.13) e jq inclusi. Gather ha restituito 142 specifiche (128 fatte, 14 aperte); i Passaggi 2/3 hanno prodotto 13 specifiche Phase-1 READY, fn-143 in Phase 2 bloccata da fn-142, e un set di deadlock vuoto. La baseline (elenco ingenuo di open-spec + raw-dep) implicava 4 specifiche bloccate (fn-73/132/135/138 mostrano deps=[fn-139/122/141]); la skill ha correttamente risolto quelle tre dipendenze come fatte e ha posizionato tutte e quattro in Phase 1 READY, quindi la risoluzione delle 'done' ha cambiato la risposta per 4 delle 14 specifiche. Il verdetto è setup, non pass, perché la skill è una sub-skill plugin: un semplice cp di SKILL.md è inutile senza il binario flowctl e un progetto .flow/ inizializzato. Tutti e 3 i file referenziati hanno restituito HTTP 200; nessun security smell nel corpo di sola lettura jq/flowctl.

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

Installazione

# Bare skill copy — satisfies ~/.claude/skills/flow-next-deps/SKILL.md but is NON-FUNCTIONAL alone:
git clone --depth 1 https://github.com/gmickel/flow-next.git /tmp/flow-next-deps-src
mkdir -p ~/.claude/skills
cp -R /tmp/flow-next-deps-src/plugins/flow-next/skills/flow-next-deps ~/.claude/skills/flow-next-deps
#
# REQUIRED to actually run (the skill calls $FLOWCTL = the bundled flowctl CLI, not on PATH):
#   1. Python 3.11+ and jq (brew install jq) must be present.
#   2. The flowctl binary lives at plugins/flow-next/scripts/flowctl inside the repo — it is
#      resolved via ${CLAUDE_PLUGIN_ROOT}/scripts/flowctl, which is only set when installed as
#      the full plugin, OR falls back to .flow/bin/flowctl after `flowctl init` in your project.
#   3. Your project must have an initialized .flow/ directory with specs (flowctl init).
# RECOMMENDED install is the whole plugin via its marketplace, which bundles flowctl:
#   /plugin marketplace add gmickel/flow-next
#   /plugin install flow-next@flow-next
# Then just ask "what's blocking what?" — no slash command (phrase-triggered skill).

Comandi e prompt di esempio

  • /flow-next-depsRenderizza le dipendenze delle specifiche flow-next come fasi ready/blocked e segnala i deadlock di dipendenza

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

  • What's blocking the oauth spec from running
  • Show the execution order for these specs
  • Which specs can run in parallel right now