npx skills add ...
npx skills add jamiemill/layers-skills --skill layers-interaction-flow
Techniques for mapping interaction structure and flow — places, affordances, edge cases, and failure paths — without committing to visual form
npx skills add jamiemill/layers-skills --skill layers-interaction-flow
Assumes /layers-intro has been loaded. This skill is a library of techniques, not a script — see "How to use these skills" there.
The interaction structure and flow layer defines how a person interacts with the product: the places they navigate, the affordances available, the content presented, and the flow between states. It sits above the conceptual model (which defines what exists) and below the surface (which defines how it looks).
A breadboard is always for a particular user in a particular situation doing a particular job. Know which job story before you start.
If the conceptual model beneath isn't stable, flows built on it often need redoing — check that first.
Breadboarding is the default; the rest serve particular situations.
| Technique | Use it when |
|---|---|
| Breadboarding (Ryan Singer / Shape Up) | Default. Text notation that forces interaction logic to be settled before visual design makes changes expensive. |
| Walk the flow as the user | Narrate: "I'm a user who [situation]. I arrive at [place], I see [content], I want to [motivation], so I [affordance]…" Walk the happy path, then every edge. The fastest way to find unmade decisions. |
| User story mapping (Jeff Patton) | Complex product, many user types, incremental planning. Activities → tasks → stories across a timeline. |
| Task analysis | Redesigning an existing flow — decompose the current task to find where friction, errors, and workarounds concentrate. |
| Service blueprinting | Flow spans channels or involves backstage operations (staff, systems, third parties). |
| Critical User Journeys | Deciding which flow to work on — the minimal path to core value (high-traffic, high-revenue, metric-critical). |
Flow diagram (graph LR) | Orientation only — flow through time reads left to right. The text breadboard stays the primary artefact; the diagram loses conditional detail. |
Settle which job story the flow serves, where the user starts, and what success looks like. If redesigning, describe the current flow first — it reveals decisions already made, many of them unintentionally. Then name the places, map affordances and destinations, and walk the flow including its edges, applying the disciplines above. Conditions — when an affordance is or isn't available — are often where the real decisions hide.
Offer the technique that fits: breadboarding for most flows, task analysis for a redesign, story mapping when there's a lot to plan. Do the next useful thing, not all of them.
Capture only the residue: the breadboard (places, affordances, destinations, content, key conditional states), a flow diagram if it aids orientation, the open decisions (gaps and unresolved edge cases), and risks that depend on unsettled lower-layer decisions.
A breadboard defines interaction logic without committing to visual form. Before moving to surface, make sure the conceptual model beneath is stable.