Flow Next Deps

Rendert flow-next Spezifikationsabhängigkeiten als bereit/blockierte Phasen und kennzeichnet Abhängigkeits-Deadlocks

von gmickel · gmickel/flow-next

Funktioniert mit Setup ★ 9.2/10

Flow Next Deps — Rendert flow-next Spezifikationsabhängigkeiten als bereit/blockierte Phasen und kennzeichnet Abhängigkeits-Deadlocks

Was es kann

Ein flow-next Plugin-Skill, der Spezifikations-Metadaten über das gebündelte flowctl CLI liest und einen Abhängigkeitsgraphen berechnet: welche Specs bereit vs. blockiert sind, parallele Ausführungsphasen, den kritischen Pfad und unlösbare Deadlocks (Zyklen oder fehlende Abhängigkeiten). Wird ausgelöst bei Phrasierungen wie "was blockiert was", "in welcher Reihenfolge sollen Specs laufen", "kritischer Pfad" oder "welche Specs können parallel laufen". Read-only-Inspektion; Bearbeitungen werden an flowctl spec add-dep/rm-dep delegiert.

Testbericht

Das Repo geklont und die exakte Pipeline des Skills gegen seine eigenen .flow/-Daten unter Verwendung des gebündelten flowctl (Python 3.13) und jq ausgeführt. Gather gab 142 Specs zurück (128 erledigt, 14 offen); Schritte 2/3 erzeugten 13 Phase-1 READY Specs, fn-143 in Phase 2 blockiert durch fn-142, und einen leeren Deadlock-Satz. Die Baseline (naive offene Spec + Roh-Abhängigkeitsliste) implizierte 4 blockierte Specs (fn-73/132/135/138 zeigen deps=[fn-139/122/141]); der Skill löste diese drei Abhängigkeiten korrekt als erledigt auf und platzierte alle vier in Phase 1 READY, sodass die Erledigt-Auflösung die Antwort für 4 von 14 Specs änderte. Das Urteil ist Setup, nicht Pass, da der Skill ein Plugin-Sub-Skill ist: ein einfaches Kopieren von SKILL.md ist ohne das flowctl-Binary und ein initialisiertes .flow/-Projekt nutzlos. Alle 3 referenzierten Dateien gaben HTTP 200 zurück; keine Sicherheitslücken im read-only jq/flowctl-Inhalt.

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

Installation

# 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).

Befehle & Beispiel-Prompts

  • /flow-next-depsRendert flow-next Spezifikationsabhängigkeiten als bereit/blockierte Phasen und kennzeichnet Abhängigkeits-Deadlocks

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

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