workflow

/flow:workflow — FlowWorkflow inspection and validation

Each /flow:* command has a machine-readable process contract at plugins/flow/workflows/<id>.workflow.yaml (and optionally a project-local override at .flow/workflows/<id>.workflow.yaml). This command lets you list available workflows, inspect their phase structure, validate their integrity, and render a textual graph.

The command markdown remains Claude's execution manual; this YAML is the inspectable contract that CI can validate.

Required Skills

• workflow-validation — schema + cross-reference checks (used by validate subcommand).

Pre-flight

ENABLED=$("$(__fr="${CLAUDE_PLUGIN_ROOT:-}";[ -x "$__fr/bin/cascade-resolve.sh" ]||__fr=$({ echo plugins/flow;ls -d "$HOME"/.claude/plugins/cache/synapti-marketplace/flow/*/ 2>/dev/null|sort -Vr;echo "$HOME/.claude/plugins/marketplaces/synapti-marketplace/plugins/flow"; }|while read -r __p;do [ -x "${__p%/}/bin/cascade-resolve.sh" ]&&{ echo "${__p%/}";break;};done);echo "$__fr")/bin/cascade-resolve.sh" \
  --default "false" '.flow.workflows.enabled')
if [ "$ENABLED" != "true" ]; then
  echo "flow.workflows.enabled is false — /flow:workflow is opt-in." >&2
  echo "Enable in .claude/settings.flow.local.json: { \"flow\": { \"workflows\": { \"enabled\": true } } }"
  exit 0
fi

Subcommands

/flow:workflow list

List all plugin-shipped workflows + any project-local overrides:

echo "Plugin-shipped workflows:"
for f in "$(__fr="${CLAUDE_PLUGIN_ROOT:-}";[ -x "$__fr/bin/cascade-resolve.sh" ]||__fr=$({ echo plugins/flow;ls -d "$HOME"/.claude/plugins/cache/synapti-marketplace/flow/*/ 2>/dev/null|sort -Vr;echo "$HOME/.claude/plugins/marketplaces/synapti-marketplace/plugins/flow"; }|while read -r __p;do [ -x "${__p%/}/bin/cascade-resolve.sh" ]&&{ echo "${__p%/}";break;};done);echo "$__fr")/workflows/"*.workflow.yaml; do
  ID=$(basename "$f" .workflow.yaml)
  CMD=$(python3 -c "import yaml; print(yaml.safe_load(open('$f'))['metadata']['command'])" 2>/dev/null)
  DESC=$(python3 -c "import yaml; print(yaml.safe_load(open('$f'))['metadata']['description'])" 2>/dev/null)
  printf '  %-15s %-20s %s\n' "$ID" "$CMD" "$DESC"
done

if [ -d .flow/workflows ]; then
  echo
  echo "Project-local overrides:"
  for f in .flow/workflows/*.workflow.yaml; do
    [ -f "$f" ] || continue
    ID=$(basename "$f" .workflow.yaml)
    echo "  $ID (overrides plugin default)"
  done
fi