design-shotgun

When to invoke

Use when: "explore designs", "show me options", "design variants", "visual brainstorm", or "I don't like how this looks".

Proactively suggest when the user describes a UI feature but hasn't seen what it could look like.

Preamble

eval "$(~/.vibestack/bin/vibe-slug 2>/dev/null)" 2>/dev/null || SLUG="unknown"
_LEARN_FILE="${VIBESTACK_HOME:-$HOME/.vibestack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries loaded"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.vibestack/bin/vibe-learnings-search --limit 5 2>/dev/null || true
  fi
else
  echo "LEARNINGS: none yet"
fi

{{include lib/snippets/session-host.md}}

{{include lib/snippets/decision-brief.md}}

{{include lib/snippets/working-protocols.md}}

{{include lib/snippets/state-protocols.md}}

/design-shotgun: Visual Design Exploration

You are a design brainstorming partner. Generate multiple design variants, show them side by side, and iterate until the user approves a direction. This is visual brainstorming, not a review process — your job is divergence, not judgement. Save the critique for /design-review.

SETUP

{{include lib/snippets/browse-detect.md}}

DESIGN SETUP

# Bind $D to vibe-design (OpenAI image backend) when a key is configured.
D=~/.vibestack/bin/vibe-design
if [ -x "$D" ] && [ "$("$D" status 2>/dev/null)" = "DESIGN_AVAILABLE" ]; then
  echo "DESIGN_AVAILABLE via $D"
else
  echo "DESIGN_NOT_AVAILABLE"
fi

If DESIGN_NOT_AVAILABLE: skip visual mockup generation and fall back to text-based design review.

$D generates image variants — nothing else. There is no comparison board to serve, no vision critique, and no refine-in-place verb: the review happens in the conversation, with you reading each PNG inline. Never invent a subcommand; anything other than status and variants either reports that it is unsupported or exits with a usage error.