Shells and archetypesFour shapes · three choices each

Business software
grows the same parts.

A queue somebody works down. A record somebody opens. A decision somebody commits to. Two sides that have to agree. Almost every operational product is some arrangement of those four, which is why they are worth getting right once.

What a template doesFills the page for you

A template hands over a finished arrangement. Take it and your product looks like every other product that took it, because the decisions were made before anyone knew what you were building.

What a shell doesNames what you must decide

A shell fixes the parts that are the same everywhere — what a queue owes its reader, what a record page may offer — and then requires three expressive choices, with a reason for each.

The fourEach with the rule that defines it

Four archetypes, and what each one owes its reader.

These are not page layouts. Each is a claim about what a screen of that kind is for, and what it is not allowed to do — which is why the same four survive across claims, billing, clinical and hiring products alike.

01How fixtures work →
Search claimsDue firstNew
Nordvik ShippingCLM-0121 · 2 days leftUrgent$20,600.00
Baltic Freight GroupCLM-0114 · 6 days leftDue soon$32,160.00
Meridian CargoCLM-0108 · 19 days leftAssessed$14,800.00

Work queue

A list somebody works down, ordered by what is burning out rather than by what arrived last. Severity orders the list, and the reason for the order is on screen.

Nordvik ShippingCLM-0121 · opened 14 AugAssessed
Assessed payable$20,600.00
Recovered
EvidenceSettle

Record page

One object, its figures traced to where they came from, and only the actions its state permits. A settled record is never offered a button it cannot honour.

128,400.00
Payout to Baltic Freight Group · MAD
Survey report attached2 files
Liability confirmed14 Aug
Second approverrequired
Cannot be reversedHoldApprove

Decision surface

Where somebody commits and carries the consequence afterwards. Gated on the evidence being present, and honest about what cannot be undone.

AssessedCargo$96,400.00Survey$8,200.00Handling$23,800.00Total$128,400.00
PaidCargo$96,400.00Survey$8,200.00Handling$22,560.00Total$127,160.00
Unreconciled$1,240.00

Reconciliation view

Two sides that have to agree, with the gap between them named rather than implied. The difference is a figure in its own right.

Four archetypes, and a product is usually three of them arranged around a domain. A fifth has not yet earned its place.
Three choicesRequired, with a reason each

The part a shell refuses to decide for you.

Constraint alone makes everything look the same, so each shell asks three questions it will not answer. The answers are where a product stops resembling everybody else’s.

01

What leads

Of everything on this screen, what does the reader see first, and why that?

A claims desk leads with the deadline. A billing view leads with the amount. Both are defensible; neither is default.

02

What it refuses to show

What is deliberately absent, and where does a reader go when they need it?

A queue that shows every field is a spreadsheet. Leaving something out is a decision, and it needs a destination.

03

Its density and rhythm

Is this read all day at speed, or opened twice a week with care?

An operator at forty rows an hour wants a different screen from an approver signing four. Same rules, different shape.

Three answers, written down where the next person can find them. A choice with no reason recorded is a choice the next redesign will quietly reverse.
Using themIn a brief · in a session · in review

How a shell gets used.

A shell is a paragraph, not a file. It is quoted in a brief, read by the agent, and checked against afterwards.

03Back to the top →
In the brief

Name the archetype, answer its three questions

Four sentences is usually enough, because everything else about that shape is already written down. That is the whole point of having archetypes.

What you write“A work queue. Leads with the filing deadline, hides the adjuster notes, read all day at speed.”
In the session

The agent reads the shell before it draws

It arrives already knowing what a queue owes its reader, so the conversation starts at your three choices instead of at the basics.

What you skipExplaining, again, that a settled record should not be offered a button it cannot honour.
In review

The audit checks the shell’s own rules

Alongside the rest of the pass. Whether severity really orders the queue, and whether anything was offered an action its state forbids.

What comes backA named rule and a screen number, rather than a feeling that something is off.
The four shells cover the shapes. What they will never cover is the domain — and the domain is why anybody opens the product in the first place.

Reckon

Ship the screen.
Not the guesswork.

Components are the easy part. What you are missing is the layer that decides what gets computed, what gets shown, and what gets refused.

Built for Claude Design · plain markdown · nothing to run