1---
 2tagline: "Think before you build. Produce a design brief through discovery, not guesswork."
 3---
 4
 5## When to use it
 6
 7`/shape` is where a feature starts. Before anyone writes code, before anyone argues about the hero treatment, before anyone picks a font. Use it to force a discovery conversation about purpose, users, content, and constraints, then capture the answers as a design brief the implementation skills can lean on.
 8
 9Reach for it whenever a feature is about to start, a ticket is vague, or you catch yourself writing JSX to figure out what the product should be.
10
11## How it works
12
13Most AI-generated UIs fail not because of bad code, but because of skipped thinking. The model jumps to "here is a card grid" without asking "what is the user trying to accomplish". `/shape` inverts that order.
14
15The skill runs a structured discovery interview in conversation. It will not write code during this phase. The questions cover:
16
17- **Purpose and context**: what the feature is for, who uses it, what state of mind they are in
18- **Content and data**: what is displayed, realistic ranges, edge cases, what is dynamic
19- **Design goals**: the single most important thing, the intended feeling, reference examples
20- **Constraints**: technical, content, accessibility, localization
21
22You answer naturally. The skill asks follow-ups, not a form. At the end it produces a design brief: a structured artifact you can hand to `/impeccable` or any other implementation skill.
23
24Note: if you want the full flow -- discovery interview, then straight into building -- use `/impeccable craft` instead. It runs `/shape` internally, then continues into implementation with visual iteration. `/shape` standalone is for when you want just the brief, so you can take it to whatever implementation approach you prefer.
25
26## Try it
27
28```
29/shape a daily digest email preferences page
30```
31
32Expect a 5 to 10 question conversation. The skill asks things like "who is the person opening this, and are they already committed or still curious" and "what happens when the user has unsubscribed from everything, do we hide the feature or show something". You answer, and a brief materializes.
33
34From there you can hand the brief to `/impeccable`, `/polish`, or any other skill. Or just use it as a reference while you build by hand.
35
36## Pitfalls
37
38- **Skipping it because it feels slow.** The interview is maybe 5 minutes. The rewrites you avoid are measured in hours.
39- **Treating the brief as a spec.** It is a compass, not a checklist. It captures intent, not UI.
40- **Answering with "standard" or "normal".** Specificity is the whole point. If a user is "rushed, on mobile, between meetings", say so. That changes everything downstream.