watch

/flow:watch — generate watch-mode trigger + loop prompt

Watch mode is flow's project-local replacement for "long-running monitoring of CI / PR / issue state." Plugins cannot invoke /loop directly, so this command does two things:

1. Creates a FlowTrigger YAML at .flow/triggers/<id>.trigger.yaml from a plugin-shipped template
2. Generates a loop-prompt file at .claude/flow-loop-<id>.md that the user invokes with /loop @.claude/flow-loop-<id>.md

The user manually starts the loop. Flow does NOT invoke /loop from plugin code.

Required Skills

• trigger-policy — validates the generated trigger conforms to safety policy.

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.triggers.enabled')
if [ "$ENABLED" != "true" ]; then
  echo "flow.triggers.enabled is false — /flow:watch is opt-in."
  exit 0
fi

mkdir -p .flow/triggers .claude

Subcommands

/flow:watch pr <N>

Create a PR-watch trigger that monitors PR #N's CI + review state.

1. Read template plugins/flow/triggers/templates/pr-watch.trigger.yaml.
2. Substitute ${PR} → N, ${REPO} → from gh repo view, ${BRANCH} → from PR metadata, ${NOW} → current ISO timestamp.
3. Write to .flow/triggers/pr-<N>-watch.trigger.yaml.
4. Invoke Skill(trigger-policy) in validate mode. Abort on violation.
5. Generate .claude/flow-loop-pr-<N>.md with the watch-mode prompt.
6. Print the manual invocation instructions.

/flow:watch ci

Create a CI-failure trigger that fires on CI status changes for the current branch.

/flow:watch issue <N>

Create an issue-watch trigger that monitors issue #N for status changes.