К основному содержанию
скилл CX Codex

flow-next-deps — скилл для Claude Code: граф зависимостей спеков

Скилл flow-next-deps для Claude Code показывает граф зависимостей спеков, порядок выполнения и цепочки блокировок. Помогает определить, что заблокировано и в каком порядке запускать спеки.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает flow-next-deps

Скилл строит три вида отчётов: какие спеки готовы к работе, какие заблокированы и чем, и в какие фазы их можно распределить для параллельного выполнения. Внутри — три шага: сбор данных всех спеков через flowctl show, анализ блокировок в jq и распределение по фазам. Если спека нет ни в одной фазе — это цикл зависимостей или ссылка на закрытый спек, скилл выводит такие в отдельный раздел.

Требует jq и flowctl (идёт в комплекте с плагином). Работает только для чтения: изменения зависимостей — через flowctl spec add-dep и rm-dep вручную.

Какие задачи решает

  • понять, какие спеки можно начать прямо сейчас
  • найти критический путь проекта
  • выявить циклы зависимостей или ссылки на несуществующие спеки
  • распределить спеки по фазам для параллельной работы

Примеры запросов агенту

  • Покажи граф зависимостей всех спеков
  • Какие спеки заблокированы и чем?
  • Распредели спеки по фазам выполнения

Как установить flow-next-deps

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gmickel/flow-next --skill flow-next-deps -a claude-code

3Вручную: положить файлы

~/.claude/skills/flow-next-deps/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flow-next-deps/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flow-next-deps

Как установить flow-next-deps в Claude Code?

Выполни /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next, потом npx skills add gmickel/flow-next --skill flow-next-deps -a claude-code. Путь к скиллу появится в ~/.claude/skills/flow-next-deps/SKILL.md.

Что делает flow-next-deps?

Строит граф зависимостей спеков: показывает, какие готовы к работе, какие заблокированы, распределяет по фазам выполнения и находит циклы или битые ссылки.

Что нужно для работы flow-next-deps?

Требуется jq (ставится через brew install jq) и flowctl — скрипт идёт в комплекте с плагином. Без jq скилл не запустится.

Исходный текст

SKILL.md · MIT
---
name: flow-next-deps
description: "Show spec dependency graph and execution order. Use when asking 'what's blocking what', 'execution order', 'dependency graph', 'what order should specs run', 'critical path', 'which specs can run in parallel'."
---

# Flow-Next Dependency Graph

Visualize spec dependencies, blocking chains, and execution phases.

## Preamble

flowctl is bundled with the plugin (not on PATH). Define once; subsequent blocks use `$FLOWCTL`:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

## Setup

```bash
$FLOWCTL detect --json | jq -e '.exists' >/dev/null && echo "OK: .flow/ exists" || echo "ERROR: run $FLOWCTL init"
command -v jq >/dev/null 2>&1 && echo "OK: jq installed" || echo "ERROR: brew install jq"
```

## Step 1: Gather Spec Data

Build a consolidated view of all specs with their dependencies — a single heavy per-spec loop for the whole skill. Steps 2 and 3 reuse the cached file (bash vars do not survive across tool calls, so the cache is a file at a literal agent-composed path — compose `<suffix>` once, e.g. 4 random chars, and reuse the same literal path in every later block):

```bash
# ONE gather — Steps 2 and 3 read this file; never re-run the per-spec loop
SPECS_FILE="${TMPDIR:-/tmp}/flow-deps-specs-<suffix>.json"
$FLOWCTL specs --json | jq -r '.specs[].id' | while read id; do
  $FLOWCTL show "$id" --json | jq -c '{
    id: .id,
    title: .title,
    status: .status,
    plan_review: .plan_review_status,
    deps: (.depends_on_epics // [])
  }'
done | jq -s '.' > "$SPECS_FILE"
cat "$SPECS_FILE"
```

### Done when

- `$SPECS_FILE` exists at the composed literal path and parses as a JSON array with one object per spec returned by `flowctl specs --json`.
- The per-spec `flowctl show` loop has run exactly once for this invocation. **Steps 2 and 3 read that file.** A second run of the gather loop has broken this.

## Step 2: Identify Blocking Chains

Determine which specs are ready vs blocked (pure jq, works on any shell):

```bash
# Reuse the Step 1 gather — same literal path, NO re-fetch (one heavy loop total)
SPECS_FILE="${TMPDIR:-/tmp}/flow-deps-specs-<suffix>.json"

# Compute blocking status
jq -r '
  # Build status lookup
  (map({(.id): .status}) | add // {}) as $status |

  # Check each non-done spec
  .[] | select(.status != "done") |
  .id as $id | .title as $title |

  # Find deps that are not done
  ([.deps[] | select($status[.] != "done")] | join(", ")) as $blocked_by |

  if ($blocked_by | length) == 0 then
    "READY: \($id) - \($title)"
  else
    "BLOCKED: \($id) - \($title) (by: \($blocked_by))"
  end
' "$SPECS_FILE"
```

### Done when

- Every non-`done` spec in `$SPECS_FILE` emitted exactly one `READY:` or `BLOCKED:` line, and each `BLOCKED:` line names the specific deps holding it.
- The jq ran against the cached file, not a fresh `flowctl show` sweep.

## Step 3: Compute Execution Phases

Group specs into parallel execution phases:

```bash
# Reuse the Step 1 gather — same literal path, NO re-fetch (one heavy loop total)
SPECS_FILE="${TMPDIR:-/tmp}/flow-deps-specs-<suffix>.json"

# Phase assignment algorithm (run in jq for reliability)
jq '
  # Build status lookup
  (map({(.id): .status}) | add // {}) as $status |

  # Filter to non-done specs
  [.[] | select(.status != "done")] as $open |

  # Assign phases iteratively
  reduce range(10) as $phase (
    {assigned: [], result: [], open: $open};

    .assigned as $assigned |
    .open as $remaining |

    # Find specs not yet assigned whose deps are all done or in earlier phases
    ([.open[] | select(
      ([.id] | inside($assigned) | not) and
      ((.deps // []) | all(. as $d | $status[$d] == "done" or ($assigned | index($d))))
    )] | map(.id)) as $ready |

    if ($ready | length) > 0 then
      .result += [{phase: ($phase + 1), specs: [.open[] | select(.id | IN($ready[]))]}] |
      .assigned += $ready
    else . end
  ) |
  # Emit the phases AND the residue: any open spec never assigned is UNRESOLVABLE — a
  # dependency cycle (A→B→A), a dep on a missing/closed spec, or a chain deeper than 10.
  # Dropping it silently is the one way /deps gives a WRONG answer (the graph it exists to
  # expose hides the deadlock). Surface it, with the offending deps for diagnosis.
  .assigned as $asg |
  { phases: .result,
    deadlocked: [ $open[] | select(.id as $i | ($asg | index($i)) | not)
                  | { id, status,
                      unresolved_deps: [ (.deps // [])[] | select(. as $d | ($asg | index($d)) or ($status[$d] == "done") | not) ] } ] }
' "$SPECS_FILE"
```

### Done when

- The jq result carries both `.phases` and `.deadlocked`, and every open spec appears in exactly one of them.
- **The report is rendered from `.phases` and `.deadlocked`.** Phases narrated from a reading of the spec titles have broken this.

## Output Format

Present results as:

```markdown
## Spec Dependency Graph

### Status Overview

| Spec | Title | Status | Dependencies | Blocked By |
|------|-------|--------|--------------|------------|
| **fn-1-add-auth** | Add Authentication | **READY** | - | - |
| fn-2-add-oauth | Add OAuth Login | blocked | fn-1-add-auth | fn-1-add-auth |
| fn-3-user-profile | User Profile Page | blocked | fn-1-add-auth, fn-2-add-oauth | fn-2-add-oauth |

### Execution Phases

Render from the jq result's `.phases`:

| Phase | Specs | Can Start |
|-------|-------|-----------|
| **1** | fn-1-add-auth | **NOW** |
| 2 | fn-2-add-oauth | After Phase 1 |
| 3 | fn-3-user-profile | After Phase 2 |

### ⚠️ Deadlocked / Unresolvable

**This section renders exactly when `.deadlocked` is non-empty** — and when it does, it is the
most important part of the report. Each entry is an open spec that could not be placed in
any phase: a dependency **cycle**, a dep on a **missing/closed** spec, or a chain deeper
than 10. These are invisible to `ready`/`flow --auto` (they just never become ready) — this is the
one place the graph surfaces them.

| Spec | Status | Unresolved deps | Likely cause |
|------|--------|-----------------|--------------|
| fn-7-x | blocked | fn-9-y | fn-9-y not found / closed, or a cycle fn-7↔fn-9 |

For each, state the likely cause: if two deadlocked specs list each other → **cycle** (fix
with `flowctl spec rm-dep`); if an unresolved dep isn't among the open specs → **missing or
closed dependency**. **Every entry of `.deadlocked` reaches the report.** A report that lists phases while silently dropping an open spec has broken this.

### Critical Path

fn-1-add-auth → fn-2-add-oauth → fn-3-user-profile (3 phases)
```

**This skill is read-only inspection.** Edge changes are reported as commands for the
operator to run — `flowctl spec add-dep <spec> <dep>` / `rm-dep <spec> <dep>`. A run that
executes either command itself, or edits a spec file, has broken this.

## Quick One-Liner

For a fast dependency check:

```bash
$FLOWCTL specs --json | jq -r '.specs[] | select(.status != "done") | "\(.id): \(.title) [\(.status)]"'
```

## When to Use

- "What's the execution order for specs?"
- "What's blocking progress?"
- "Show me the dependency graph"
- "What's the critical path?"
- "Which specs can run in parallel?"
- "What should I work on next?"

© Gordon Mickel · MIT · gmickel/flow-next

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
ghost-scan-deps ghostsecurity Скилл ghost-scan-deps запускает аудит зависимостей проекта по файлам блокировок, находит уязвимости с CVE и готовит отчёт с оценкой риска и шагами по исправлению. CX Codex +1 4 700установок rust-deps-visualizer actionbook Скилл rust-deps-visualizer для Claude Code — рисует дерево зависимостей Rust-проекта символами ASCII по данным Cargo.toml. Показывает, что тянет каждый крейт. CX Codex +1 3 400установок automation-flow-generate forcedotcom Скилл automation-flow-generate создаёт Salesforce Flow и возвращает XML метаданных. Запускайте его, когда нужно описать автоматизацию на экранах, по событию записи или по расписанию. CX Codex +1 6 600установок diagnose-flow Microsoft Скилл diagnose-flow для Claude Code анализирует упавший запуск Power Automate: строит граф выполнения, находит причину сбоя и предлагает исправление определения. CX Codex +1 ★ 1 167звёзд репо kotlin-concurrency-and-flow chrisbanes Скилл kotlin-concurrency-and-flow для ревью и написания Kotlin-кода с корутинами: разбирает владение scope, отмену, StateFlow, SharedFlow и Channel. CX Codex +1 1 500установок deps tartinerlabs Скилл deps закрывает дыры в цепочке поставок зависимостей: закрепляет версии, ставит карантин на свежие релизы, подключает Renovate и проверку зависимостей. CX Codex +1 305установок

Из того же набора70

Весь набор →
security-scout Субагент security-scout проверяет настройки безопасности репозитория GitHub, защиту веток, CODEOWNERS и автообновление зависимостей перед запуском агентов. CX Codex ★ 730звёзд репо flow-next-tracker-sync Скилл flow-next-tracker-sync проецирует спеку flow-next в задачу Linear, GitHub, GitLab или Jira и сверяет тело, статус и комментарии. Спека остаётся источником правды. CX Codex +1 ★ 730звёзд репо claude-md-scout Субагент claude-md-scout оценивает содержательность файлов CLAUDE.md и AGENTS.md по шкале из восьми пунктов, проверяя наличие реальных команд и проектных правил перед стартом работы. CX Codex ★ 730звёзд репо flow-gap-analyst Субагент flow-gap-analyst разбирает краткое описание функции и находит пробелы, неоднозначности и пограничные случаи. Он помогает собрать вопросы, на которые нужно ответить до начала разработки. CX Codex ★ 730звёзд репо flow-next-plan-review Скилл flow-next-plan-review для Claude Code направляет проверку спецификаций и планов через выбранный бэкенд и запускает цикл исправлений и повторного ревью. Проверяет Flow-документы. CX Codex +1 ★ 730звёзд репо flow-next-impl-review Запускает ревью реализации в стиле Джона Кармака через указанный бэкенд — claude, codex, copilot, cursor или человека. Вызывается командой /flow-next:impl-review. CX Codex +1 ★ 730звёзд репо flow-next-work Скилл flow-next-work исполняет задачи и спецификации Flow-Next по шагам: готовит ветку Git, ведёт трекинг через flowctl, запускает тесты и фиксирует коммиты. CX Codex +1 ★ 730звёзд репо flow-next-spec-completion-review Скилл flow-next-spec-completion-review сверяет готовую спеку с её требованиями: закрывают ли все задачи вместе то, что было задумано. Пригодится перед тем, как считать работу по спеке законченной. CX Codex +1 ★ 730звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой