debug

Debug: $ARGUMENTS

Structured debugging with root cause analysis. Follows Explore > Plan > Code > Verify loop.

Required Skills

This command operates with these domain skills loaded:

• debugging-patterns — root cause methodology, hypothesis testing
• change-classification — change context awareness

Phase 1: EXPLORE

Gather all evidence before theorizing. Execute in parallel:

# Output: `###`-headed sections + KEY=value per
# `references/command-output-format.md`.

echo "### Recent History"
# Capture into a var so an empty result emits an explicit STATE=empty
# sentinel rather than a silent heading.
RECENT_LOG=$(git log --oneline -10 2>/dev/null)
if [ -z "$RECENT_LOG" ]; then
  echo "STATE=empty"
else
  printf '%s\n' "$RECENT_LOG" | sed 's/^/COMMIT=/'
fi

echo ""
echo "### Recent Diff (last 3 commits)"
RECENT_DIFF=$(git diff HEAD~3..HEAD --stat 2>/dev/null)
if [ -z "$RECENT_DIFF" ]; then
  echo "STATE=empty"
else
  # Prefix raw stat lines with DIFF_STAT= per command-output-format.md.
  printf '%s\n' "$RECENT_DIFF" | sed 's/^/DIFF_STAT=/'
fi

echo ""
echo "### Current State"
echo "BRANCH=$(git branch --show-current 2>/dev/null)"
UNCOMMITTED_COUNT=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
echo "UNCOMMITTED_COUNT=$UNCOMMITTED_COUNT"
[ "$UNCOMMITTED_COUNT" != "0" ] && git status --short 2>/dev/null | head -20 | sed 's/^/UNCOMMITTED_LINE=/'

true

FlowRun (v3 runtime)

/flow:debug is a long-running workflow, so it gets a durable FlowRun. The companion FlowGoal is created later (after hypothesis confirmation), so the run forward-references its id. Runs are gated by flow.runtime.enabled (default true); v2 projects that opted out see FLOW_RUN_STATE=skip and the wiring is a no-op.

# FLOW_RUN_BLOCK_BEGIN
CASCADE="$(__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"
if [ ! -x "$CASCADE" ]; then
  echo "FLOW_RUN_STATE=blocked"
  echo "FLOW_RUN_ERROR=cascade-resolve.sh missing or non-executable at $CASCADE"
  true; exit 0
fi
RUNTIME_ENABLED=$("$CASCADE" --default "true" '.flow.runtime.enabled' 2>/dev/null)
if [ "$RUNTIME_ENABLED" != "true" ]; then
  echo "FLOW_RUN_STATE=skip"
  echo "FLOW_RUN_REASON=flow.runtime.enabled is not true (v2 mode)"
else
  RUN_ID="$(date -u +%Y-%m-%dT%H%M%SZ)-debug"
  # The goal id must match the FlowGoal metadata.id pattern
  # ^[a-z0-9][a-z0-9-]{0,63}$ — no uppercase, so it cannot reuse the ISO run
  # timestamp (which carries T/Z). Use a hyphen-only lowercase stamp.
  GOAL_TS="$(date -u +%Y-%m-%d-%H%M%S)"
  echo "FLOW_RUN_STATE=create"
  echo "RUN_ID=$RUN_ID"
  echo "WORKFLOW=debug"
  echo "INITIAL_PHASE=preflight"
  echo "GOAL_LINK=debug-${GOAL_TS}"
fi
# FLOW_RUN_BLOCK_END
true