Skip to content

experience-design

Walkable design method from outcome to realization — journey, screens, aesthetic, craft, review.


Type journey-mapping first — describe the user, the outcome, and where the current experience breaks down.

journey-mapping
journey docs/design/journeys/onboarding.md
Stage 1 Aware finds product, expectations vague
Stage 2 First-session blank state, no direction, high drop-off
Stage 3 Value first export, relief, converts

On any session return, type experience-status to see where the thread is.

experience-status
Design thread — docs/design
Journey maps (journeys/): 1 found
onboarding.md — Onboarding
Screen flows (screens/): 0 found
Steel-thread check:
Journey map: ✓ exists
Screen flow: ✗ missing — run user-flow
Briefs: ✗ missing — run user-flow
What to run next: user-flow

Say thisWhat happens
experience-statusOrient — where the design thread is, what’s next
journey-mappingMap the user’s outcome: stages, emotions, pains, opportunities
content-designSet surface intent — what this screen says and for whom
copy-directionName the per-surface copy goals for a marketing or acquisition surface
tone-of-voiceSet the brand-level copy register — cross-surface voice personality
user-flowBuild the screen inventory — transitions and per-screen state briefs
creative-directionAnchor the aesthetic — grounded in persona and precedent
design-systemDerive the token taxonomy from the aesthetic direction
information-architectureStructure a screen — hierarchy, reading flow, wayfinding
interaction-designDesign the behavioral layer — states, feedback, animation
design-reviewAuthoring-time critique — quality floor + coherence
experience-reviewerIndependent cold review — forked context, read-only

Genre-direct alternatives to information-architecture for known surface types: analytical-design, conversion-design, documentation-design, informational-design, marketplace-design, workspace-design.


journey-mapping [paste the user's outcome and context]
journey docs/design/journeys/onboarding.md
Stage 1 Aware finds product, expectations vague
Stage 2 First-session blank state, no direction, high drop-off
Stage 3 Value first export, relief, converts
user-flow [link to docs/design/journeys/onboarding.md]
screens docs/design/screen-flows/onboarding.md
/onboarding/welcome → /onboarding/connect → /onboarding/done
States per screen: default · loading · error · success · empty
experience-reviewer [link to docs/design/screen-flows/onboarding.md]
Blocker Welcome screen: empty state not designed
Concern Connect screen: error text has no recovery action
Nit "Get started" → "Connect your first account" (five-second scan)

The reviewer runs forked — no authoring context. You act on its findings, then merge.


Connective thread — from outcome to screen inventory: journey-mappingcontent-designtone-of-voice (optional, brand register) → copy-direction (acquisition surfaces) → user-flowservice-blueprint / process-mapping

Craft sequence — from structure to behavior: design-principlescreative-directiondesign-systeminformation-architecture / genre-direct skill → interaction-design

Review — quality floor, aesthetic fit, cross-brief coherence: design-review (authoring-time) → experience-reviewer (independent cold review)

Every skill ships portable method, not your stack: no UI-framework code, no values tables, no fixed token set, no pixel comps.


Upstream — product-strategy: When ux-strategy.md and content-strategy.md exist, journey-mapping and content-design read them as strategic anchors. Absent means the skills degrade gracefully.

Downstream — product-engineering: Pass user-flow’s per-screen state matrix to ux-writing to write copy keyed to every screen × state cell.


How it works: DESIGN.md — philosophy, method architecture, invariants, and decision log.
Go deeper: the experience-design guides.