dvy1987/agent-loom / .agents/skills/design-direction
design-direction
VerifiedSet a deliberate visual direction before any UI is built — the single biggest lever against generic AI output. Derives a posture from product-soul/PRD/specs, scores a curated archetype palette, then generates 2-3 GENUINELY DISTINCT directions and compares them side-by-side before committing to one. Load when the user asks to pick an aesthetic, choose a design direction, decide what a UI should feel like, explore visual options, says "what should this look like", "make it feel like [Linear/Apple/ Duolingo]", "give me design directions", "explore some looks", or when frontend-design routes here. Replaces design-archetype. Sub-skill of frontend-design.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.8 KB |
| references/archetypes/b2b-productivity.md | markdown | 3.2 KB |
| references/archetypes/brutalist-distinctive.md | markdown | 2.8 KB |
| references/archetypes/conversational-ai.md | markdown | 3.9 KB |
| references/archetypes/creative-tool.md | markdown | 3.5 KB |
| references/archetypes/dev-tool.md | markdown | 2.8 KB |
| references/archetypes/editorial.md | markdown | 2.8 KB |
| references/archetypes/enterprise-trust.md | markdown | 3.2 KB |
| references/archetypes/marketing-landing.md | markdown | 3.6 KB |
| references/archetypes/playful-consumer.md | markdown | 2.9 KB |
| references/archetypes/premium-consumer.md | markdown | 3.1 KB |
| references/archetypes/social-feed.md | markdown | 3.6 KB |
| references/archetypes/spatial-canvas.md | markdown | 3.7 KB |
| references/examples.md | markdown | 2.1 KB |
| references/exploration-method.md | markdown | 3.9 KB |
| references/selection-rubric.md | markdown | 4.1 KB |
| references/ux-context-checklist.md | markdown | 1.3 KB |
references/exploration-method.md
View on GitHub# Exploration Method — Generating Genuinely Distinct Directions
The single biggest cause of generic AI design is committing to the first idea. Models
converge on the corpus mean. The fix is to generate **2-3 deliberately different
directions and compare them before any code exists** — you choose from options instead
of accepting the average.
This file is the core of `design-direction`. The archetype catalog is the *starting
palette*; this method is how you push off-center and diverge.
---
## Rule 1 — Pick a deliberate posture, not the safe center
Before generating directions, choose a point of view on purpose. The archetype gives the
audience/job fit; the posture gives the *attitude*. State it in one sentence:
> "Confident editorial-tech — looks like a product with an opinion, not a template."
Posture axes to set explicitly (each direction can sit differently on these):
- Restraint ↔ Expression (minimal vs maximal)
- Warm ↔ Cool (paper/ink vs clinical)
- Classic ↔ Experimental (familiar patterns vs grid-breaking)
- Quiet ↔ Loud color (monochrome + 1 accent vs saturated)
- Calm ↔ Kinetic motion
Never let all three directions cluster at the center of every axis. If they do, they are
the same direction in three palettes.
---
## Rule 2 — Make the three directions actually different
Generate 2-3 directions that differ on **at least 3 of these dimensions**, not just color:
1. Typography system (e.g. editorial serif display vs geometric mono vs humanist sans)
2. Color story (e.g. warm paper + ink vs dark-first jewel vs high-key monochrome)
3. Layout signature (e.g. asymmetric editorial grid vs dense dashboard vs centered calm)
4. Motion character (e.g. near-instant vs weighted/physical vs playful spring)
5. Density (dense vs generous)
6. The "one bold move" each direction commits to (a signature element)
Anti-pattern: "Direction A: blue. Direction B: green. Direction C: purple." That is one
direction. Reject and regenerate.
---
## Rule 3 — Each direction is concrete, named, and referenced
For each direction produce:
- A **name** ("Field Notes", "Control Room", "Soft Studio") — not "Option 1"
- A one-line **"feels like X"** naming a real, current product
- Type pair (display + body, real families)
- Color story (background, ink, the ONE accent, light + dark intent)
- Layout signature (the recurring move)
- Motion character (duration + curve intent)
- The single bold move
- One-line trade-off ("most distinctive but riskiest for enterprise buyers")
Vague adjectives ("clean", "modern", "premium") are banned — they do not converge.
---
## Rule 4 — Compare side-by-side, then commit to ONE
Present the directions in a single comparison table so the choice is between concrete
options, not re-prompted one at a time. Then commit to exactly one (hybrids look
vibecoded). Carry the runner-up's best single idea as an "influence" note only.
### Who chooses
- Technical / design-capable owner → present all directions, let them pick.
- Non-technical owner (`owner_mode: non-technical`) → recommend ONE with a plain-language
rationale ("I recommend Field Notes: it reads as credible and editorial, which suits a
research audience, and it is the least likely to look like a generic template"), and
name the safe alternative. Decide; do not force a technical choice on them.
---
## Rule 5 — Ground in product reality
Pull the audience, emotional goal, brand hints, and constraints from `docs/product-soul.md`,
the PRD, and specs before inventing directions. A direction that ignores the product's job
is just decoration. If those docs are absent, ask one question (purpose + a reference
product) and proceed.
---
## Output
Write the chosen direction (plus the rejected options as an appendix) to
`.design/<feature>/DIRECTION.md`. `design-system` reads it to build the DESIGN.md and
tokens. Keep the rejected options recorded — they are the audit trail that proves
exploration happened.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |