goal

/flow:goal — FlowGoal lifecycle management

Project-local replacement for the session-only Claude Code /goal built-in. Flow cannot invoke /goal from plugin code — instead this command writes durable .flow/goals/<id>.goal.yaml artifacts that the Stop hook (flow-goal-stop.sh), evaluator, and /flow:status all read.

Required Skills

Invoke these skills as part of the subcommand workflows below:

• goal-contract-capture — every create subcommand
• goal-evaluator — every evaluate subcommand
• goal-lifecycle — every state-transition subcommand (pause, resume, clear, after evaluate)
• goal-evidence-ledger — when evaluator captures new evidence sidecars

Pre-flight

Before any subcommand:

# Resolve flow.goals.enabled (default true)
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 "true" '.flow.goals.enabled')
if [ "$ENABLED" != "true" ]; then
  echo "flow.goals.enabled is false — /flow:goal is disabled in this project's settings cascade." >&2
  exit 0
fi

# Resolve stopHookEnforcement (warn | block | evaluator-loop)
STOP_MODE=$("$(__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 "warn" '.flow.goals.stopHookEnforcement // empty')

mkdir -p .flow/goals

Subcommands

/flow:goal — default (no arguments)

Equivalent to /flow:goal status. Shows the active goal for the current branch/PR.