Flow Next Deps

Rend les dépendances de spécification flow-next en phases prêtes/bloquées et signale les interblocages de dépendances.

par gmickel · gmickel/flow-next

Fonctionne avec configuration ★ 9.2/10

Flow Next Deps — Rend les dépendances de spécification flow-next en phases prêtes/bloquées et signale les interblocages de dépendances.

Ce que fait

Une compétence de plugin flow-next qui lit les métadonnées de spécification via le CLI flowctl intégré et calcule un graphe de dépendances : quelles spécifications sont prêtes ou bloquées, les phases d'exécution parallèles, le chemin critique et les interblocages insolubles (cycles ou dépendances manquantes). Se déclenche sur des phrases comme "qu'est-ce qui bloque quoi", "dans quel ordre les spécifications doivent-elles s'exécuter", "chemin critique" ou "quelles spécifications peuvent s'exécuter en parallèle". Inspection en lecture seule ; les modifications sont déléguées à flowctl spec add-dep/rm-dep.

Rapport de test

Le dépôt a été cloné et le pipeline exact de la compétence a été exécuté sur ses propres données .flow/ en utilisant flowctl (Python 3.13) et jq. Gather a renvoyé 142 spécifications (128 terminées, 14 ouvertes) ; les étapes 2/3 ont produit 13 spécifications Phase-1 READY, fn-143 en Phase 2 bloquée par fn-142, et un ensemble d'interblocages vide. La base (liste naïve de spécifications ouvertes + dépendances brutes) impliquait 4 spécifications bloquées (fn-73/132/135/138 montrent deps=[fn-139/122/141]) ; la compétence a correctement résolu ces trois dépendances comme terminées et a placé les quatre en Phase 1 READY, de sorte que la résolution des tâches a changé la réponse pour 4 des 14 spécifications. Le verdict est setup, non pass, car la compétence est une sous-compétence de plugin : un simple cp de SKILL.md est mort sans le binaire flowctl et un projet .flow/ initialisé. Les 3 fichiers référencés ont renvoyé HTTP 200 ; aucune faille de sécurité dans le corps jq/flowctl en lecture seule.

Testé le: 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).

Commandes et exemples de prompts

  • /flow-next-depsRend les dépendances de spécification flow-next en phases prêtes/bloquées et signale les interblocages de dépendances.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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