Decision Cards

Make interface decisions you can defend in any design review.

27 more cards are on the way. Get each one in your inbox as it unlocks.

Or install the deck for your AI tools

Design Decisions · Q1 2027

Learn to make these calls on your own.

These cards are the first of many. The course teaches the reasoning behind each one, with practice rounds and teardowns of real products.

Get new cards as they’re released, and early-bird pricing at launch.

Coming next

Navigation

Suggestions or Results

Does the person already know what they’re looking for?

Use Suggestions when

The catalog is huge and unknown to the person searching, like a marketplace. Helping them phrase the query narrows a space they can’t see.

Signs it fits

  • Open, unbounded catalog
  • People don’t know item names
  • Exploratory browsing
  • Wording changes results a lot

Use Results when

People look for something they’ve seen before: a file, a customer, a ticket. The best suggestion is the item itself, opened with Enter.

Signs it fits

  • Known-item retrieval
  • Finite content the team owns
  • Items have memorable names
  • Repeat users who want speed

The numbers

Finite, named content: switch from suggestions to real results after 2–3 typed characters. Open catalogs where people can’t know item names: keep query suggestions. Empty field: recent items, not results.

Say this in review

People search here for files they’ve already seen, so the fastest answer is the file itself, opened with Enter, not a guess at their question.

When it flips

The exception

Before anyone types, there’s nothing to match. Show recent items and saved searches instead of results.

See it work

Make the call

Card 6 of 15

A CRM’s global search. Users type the names of customers they work with every day. Suggestions or results?

Navigation
The rule

Once the query means something, show the thing, not a guess at the question.

From the lesson “Search: results, not suggestions”

ClickTap the card to turn it over

Install the deck

Bring every card into your AI tools, so they review screens and flows the way the cards do.

Agents can also read llms.txt, or any card as markdown by adding .md to its link.