Sb Explore

---
name: sb-explore
description: "Iterate on a new or redesigned component in a sandboxed Explore story outside src/components/ (+ Figma), checked against a graduation gate. Use for 'prototype this', 'try a v2', 'explore from Figma', or net-new UI not ready to ship."
compatibility: "Requires bash; a running Storybook (Node.js) to view the sandboxed Explore story."
allowed-tools: Bash Read Glob Grep Write Edit
license: MIT
metadata:
  author: strongeron
  version: '2.4.0'
  bundle: storybook-workbench
  vendor:
    scripts: []
    wrappers: false
    references: [labs-workflow.md, figma-to-storybook.md]
---

# sb-explore — sandboxed iteration (Build mode: Explore)

The component is new or being redesigned. It lives **outside `src/components/`** so production
code can't depend on it. **Load `references/labs-workflow.md` before scaffolding.**
If the user pasted a Figma URL, ALSO load `references/figma-to-storybook.md`. Do NOT
load `composition-patterns.md` (that's Compare → `sb-wrappers`).

> **Naming:** **`Explore`** is the canonical term used throughout this skill (titles, disk paths, tags).
> `references/labs-workflow.md` predates the rename and says **`Labs`** / `src/stories/labs/` — read it as
> the same track (Explore = Labs). Author with `Explore`; treat `Labs` only as a legacy alias you may meet
> in an existing repo.

## Before scaffolding (ask yourself)

- **Iterating on a shipping component, or net-new?** Determines Path A vs Path B at Ship time.
- **Figma URL pasted?** If yes — set `parameters.design = { type: 'figma', url }` immediately and
  iterate against the frame (see figma-to-storybook.md).
- **API stable enough to graduate?** See the 4 criteria in labs-workflow.md. If not — stay in Explore.

## Scaffold

- **Disk path** — honor the recorded `storiesLocation` (`.storybook/audit/status.md`): when stories are
  **isolated** (the audit/client default), scaffold the experiment under `.storybook/explore/<topic>/` —
  don't scatter into a `src/` you don't own. Only use `src/explore/<topic>/` when the user opted into
  **co-located** for a project they own. Vite excludes either from the production bundle.
- **Title** — `Explore/<topic>/<name>` — last in `storySort.order`, bottom of sidebar.
- **Tags** — `['explore', '!autodocs', '!test']`. Optional: `'motion'`, `'figma-sync'`, `'v2-preview'`.

## Graduation gate (Explore → Component)

Four criteria in labs-workflow.md: stable API · ≥3 callsites planned · designer-reviewed ·
tokens not magic numbers. When all met → trigger **`sb-ship`** (it preserves the experiment,
never `git mv`). Until then, keep iterating here.

## Next

Iterate; when the gate is met, hand off to `sb-ship`. Append progress to `.storybook/audit/status.md`
so an interrupted session resumes cleanly (CONTEXT.md resume protocol).