sb-inventory

sb-inventory — ground truth, not trust

Vibe-coded apps ship ~30% slop. This skill replaces "trust the AGENTS.md / CLAUDE.md / DESIGN.md" with "see what's actually imported." Read CONTEXT.md for the real/vendor/dead/kind vocabulary. (The dominant design system here comes from code signals, never from a doc. If a DESIGN.md brief is present, sb-health cross-checks its claimed colors against the code — it drifts/lies the same way an AGENTS.md does.)

Run it

SKILL=${CLAUDE_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}
CORE=${CLAUDE_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}
"$SKILL/scripts/inventory-project.sh"   # writes .storybook/project-inventory.json (atomic)

The script is the ground truth — do NOT recompute by hand. Read the JSON and cite its fields. For the known detector gotchas (what the discovery scripts get right vs. wrong across validation runs), load references/field-learnings.md only when a count looks surprising (a 0, an outlier, a suspected false orphan). Do NOT load it for a clean first-pass inventory whose numbers look right — the JSON fields stand on their own.

Report (read these fields, in this order)

1. Stack — libraries (react/vite/tailwind v4|v3/shadcn/radix/baseui/r3f).
2. Dominant design system — designSystem.dominant (one of tailwind-v4/shadcn/dtcg/css-vars/ none) + mixed flag. If mixed → tell the user the project is in transition; suggest sb-health.
3. The user's own components — components.realCount / deadCount are domain components only. Cite components.real[] (most-imported first) as the priority list for stories.
4. Vendor — components.vendorCount + byKind.vendor = shadcn components/ui/ primitives. Call these out separately: "you also have N installed shadcn primitives — not your code, not slop, don't write stories for them first."
5. Modules / support / scaffold — moduleCount (byKind.module = types/helpers/hooks/utils/ lib/api — non-component source), supportCount (byKind.scaffold|support = test/factory/mock + SB init tutorial). All excluded from the headline AND the real[] most-imported list, so that list is your prod components, not a types.ts that's imported everywhere. Mention if non-zero.
6. Tokens — used vs orphan. Stories — orphanStories (stories importing a component that no longer exists) AND components.storyCoverage — own components written vs. needed: {real, storyFiles, withColocatedStory, withStory, needsCount, needsStory[]}. Read coverage from withColocatedStory (own components with their own <name>.stories.*) and storyFiles (distinct story files that exist) — those are the hard counts. withStory is a loose upper bound: it also counts a component as covered when any story merely imports it (e.g. a dialog story importing a form to mock it), so it over-reports — treat withColocatedStory ≤ real_coverage ≤ withStory. needsStory[] is the "stories needed" worklist (the inverse of orphanStories); refresh-usage.sh keeps it current so sb-stories can work down needsStory[].