brainstorm

Brainstorm: $ARGUMENTS

Multi-option exploration before committing to an approach. Follows Explore > Generate > Compare > Decide loop.

Required Skills

This command operates with these domain skills loaded:

• brainstorming — multi-option exploration, trade-off analysis
• capability-discovery — detect available agents and tech stack
• specification-capture — read existing specification from journal or capture non-goals (Phase 1)

References

• references/escalation-format.md — canonical six-field structure for any Proactive-Autonomy escalation surfaced during brainstorming

Phase 1: EXPLORE

Understand the goal before generating options. Execute in parallel:

# Take the first whitespace-separated token; accept only if it is *all*
# digits. Inputs like "foo42 strategy" (greedy digit-extraction would pluck
# `42` from `foo42` and fire `gh issue view 42` on an unrelated issue) are
# rejected. Supports usage like /flow:brainstorm 42 (alternative auth strategies).
#
# Output: `###`-headed sections + KEY=value per
# `references/command-output-format.md`.
_RAW="$ARGUMENTS"  # Claude Code substitutes the bare arg token, not bash parameter-expansion
ARG1="${_RAW%% *}"
case "$ARG1" in
  ''|*[!0-9]*) ISSUE_NUM="" ;;
  *) ISSUE_NUM="$ARG1" ;;
esac

echo "### Issue Reference"
# Quote parenthesized fallback per command-output-format.md rule 2 (values
# with whitespace/parens must be double-quoted scalars).
echo "ISSUE_NUM=${ISSUE_NUM:-\"(none — exploratory brainstorm)\"}"

echo ""
echo "### Issue Context"
if [ -n "$ISSUE_NUM" ]; then
  gh issue view "$ISSUE_NUM" --json title,body,labels --jq '"TITLE=\"\(.title)\"\nLABELS=\([.labels[].name] | join(","))\nBODY_LENGTH=\(.body | length)"' 2>/dev/null
  echo ""
  echo "#### Issue body"
  gh issue view "$ISSUE_NUM" --json body --jq '.body' 2>/dev/null
else
  echo "STATE=empty"
fi

echo ""
echo "### Project State"
echo "BRANCH=$(git branch --show-current 2>/dev/null)"
echo ""
echo "#### Recent commits"
RECENT_COMMITS=$(git log --oneline -5 2>/dev/null)
if [ -z "$RECENT_COMMITS" ]; then
  echo "STATE=empty"
else
  printf '%s\n' "$RECENT_COMMITS" | sed 's/^/COMMIT=/'
fi

true