a builder's codex
codex · playbooks · Architect content with design thinking, from page structure to prototype

Architect content with design thinking, from page structure to prototype

Treat every piece of content as a design problem. Who is the user, what are they trying to accomplish, what stands in their way, and how do you structure information so they act. Quality bar: a first-time visitor who reads only the headers can say what you do, who it is for, and what to do next, and the page changes a decision instead of just describing a product. This playbook sits between visual design and sentence-level craft, and it pulls both into one process.

The order of the work matters. Research the buyer before you design the page. Lock the copy before you style it. Test comprehension before you test conversion. Skip a stage and you end up polishing a page that was never going to land.

Insights usedDavid Ogilvy · 1983Donald Miller · 2017Anthony Pierri · 2026Eddie Shleyner · 2024

When to use

  • A landing page, homepage, or pricing page converts below where the traffic quality says it should.
  • You are writing a long-form piece (sales page, launch post, vertical play) and need a structure, not just sentences.
  • Sales says buyers "don't get it" from the page, or reps rewrite the deck because the page does not arm them.
  • You are auditing existing content for a redesign and need a checklist sharper than "make it cleaner."
  • You are preparing content that agents will read and cite, not just humans.

How to use

Annotated framework · 8 principles

Design Thinking for Content

01

Information hierarchy

Most important information first. Every section earns the right to the next. If a section can't justify its existence, it doesn't belong.

02

Progressive disclosure

Headline → subhead → body → detail. Layer complexity intentionally. The reader opts into depth; you don't force it on them in the first paragraph.

03

One job per element

Every heading, paragraph, image, and CTA has exactly one job. If an element does two jobs, split it into two elements.

04

Scannable structure

80% of readers scan first. Headers, bold, bullets, and white space carry most of the weight. The page must work for scanners before it works for readers.

05

Behavioral triggers over rational arguments

Lead with loss aversion, social proof, status quo bias. Rational justification follows — it does not lead. People decide emotionally and justify rationally.

06

Consumption over conversion

Conversion follows comprehension. Design so the reader understands and wants to continue. A page optimized for the click before the reader understands the offer converts worse.

Principles 07–08: whitespace is content · mobile-first information architecture →

01 Research the buyer before you design anything.

The first move is not a wireframe. It is finding out what the buyer actually thinks, ignores, remembers, and acts on. Content built from the team's taste reads as obvious to insiders and opaque to everyone else. Sell to the buyer's mindset, not to product features

Ogilvy framed this as a choice between two failure modes. I prefer the discipline of knowledge to the anarchy of ignorance, research before creative

"I prefer the discipline of knowledge to the anarchy of ignorance."

· David Ogilvy, Ogilvy on Advertising, 1983

Pull the raw material first: customer interviews, support tickets, win/loss notes, the exact phrases buyers use for the problem. You are not collecting features. You are collecting the buyer's situation and language. The page you design later either mirrors that language or invents its own, and the invented version is the one that fails the comprehension test in step 8.

02 Articulate the problem at three layers before you write a single benefit.

A buyer's problem is rarely one thing. Name it at three nested layers: the external problem (the tangible thing happening, "my reports take 4 hours"), the internal problem (the emotional consequence, "I feel constantly behind"), and the philosophical problem (why it is wrong this exists, "skilled people should not waste their lives on report formatting"). Articulate the buyer's problem at three layers, external, internal, and philosophical, or your message rings shallow

"articulated at three levels: an external problem that is tangible and practical, an internal problem that is the frustration or self-doubt the customer feels, and a philosophical problem that frames why it is simply wrong that this problem exists"

· Donald Miller, Building a StoryBrand, 2017

Content that hits only the external layer feels transactional. Content that hits all three feels like it understands the buyer. The three layers also map to your page sections: the external problem anchors the hero, the internal problem carries the problem section, and the philosophical problem is the thread that runs through the whole page. Do not force the philosophical layer onto a pure-utility product. For most work-life problems it is what separates a page that resonates from one that lists features.

03 Build the information hierarchy around survival relevance.

The brain conserves attention by filtering out anything that does not signal survival, broadly defined to include status, resources, security, and progress. Most important information goes first, and "most important" means "most relevant to the buyer's survival," not "most impressive to your team." The brain ignores anything that doesn't signal survival, your message has to land in survival terms in seconds

"the human brain is wired to conserve calories by ignoring information that does not help it survive and thrive, so your message must immediately communicate value in survival terms"

· Donald Miller, Building a StoryBrand, 2017

Layer the page by progressive disclosure: headline, then subhead, then body, then detail. Every section earns the right to the next. Give every element one job. A heading that also tries to be a CTA does neither well. If an element does two jobs, split it. The structure is a series of survival-relevant promises, each one buying the attention to read the next.

Use these scanning patterns as the skeleton, since most readers scan before they read:

Page typePatternWhat it means for layout
Visual-heavyZ-patternLogo top-left, trust signal top-right, hero center-left, primary CTA bottom-right of the hero.
Text-heavyF-patternFront-load each section. First 2–3 words of headings and the first sentence of paragraphs carry disproportionate weight.
Long-formHeading hierarchy as navigationThe headers alone should tell the whole story to a scanner.

Left-align body text. Center-aligned body breaks both the Z and F patterns and forces the eye to re-find the start of every line.

04 Make the hero pass the trinity and the caveman test in five seconds.

The hero is the one section that has to work alone. Lead with the trinity: the specific use case, the alternative the buyer is using today, and the result the product produces, all readable in roughly five seconds. Lead with capability, what someone actually does with the product, not an abstract benefit or a vision statement. Pierri's argument is that vision-led copy fails because it connects to neither the buyer's problem nor the alternative they are weighing, so the buyer cannot tell whether the product is for them. B2B homepages must communicate use case, alternative, and result in five seconds

Then run the comprehension gate. Could a pre-marketing observer look at the page and immediately know what you offer, how it improves their life, and what to do next. Could a caveman understand your homepage?, three questions, no marketing vocabulary

"Could a caveman look at your website and immediately know what you offer, how it will make their life better, and what they need to do to buy it?"

· Donald Miller, Building a StoryBrand, 2017

Position the brand as the guide, not the hero. The buyer is the protagonist. Your job on the page is to show empathy and authority, "I understand your problem" plus "I can help you solve it." The brand's job is to be a credible guide, empathy ("I get it") + authority ("I can help"), not to be the hero

"The guide's job is to demonstrate empathy (\"I understand your problem\") and authority (\"I have the competence to help you solve it\"), not to position itself as the hero of the story."

· Donald Miller, Building a StoryBrand, 2017

05 Write headlines for clarity, then write the body in concrete images.

A headline that asks the reader to interpret it has already failed. In a feed or a search result the reader allocates zero interpretive effort. Clarity beats cleverness, always, a headline that requires interpretation is a headline that fails

"Clarity beats cleverness, always. A headline that requires interpretation is a headline that fails."

· Eddie Shleyner, VeryGoodCopy, 2024

Inside the body, abstract claims do not survive the gap between reading and deciding. Concrete images do. "Save time" disappears from memory. "Stop spending Saturday morning rebuilding the spreadsheet" gets recalled at the moment of decision. Abstract claims disappear from memory; concrete images persist, vividness creates memorability

"Vividness creates memorability. Abstract claims disappear from memory; concrete images persist."

· Eddie Shleyner, VeryGoodCopy, 2024

This is where design thinking and copy craft meet five reinforcing fundamentals: reader-centredness, emotion as the mechanism, voice as the moat, clarity over cleverness, and subtraction. Most content fails on two or three of the five and is fine on the rest. Find the weakest one and fix it first. Copywriting craft is built on five reinforcing fundamentals

06 Use rhythm and white space to control attention, not just to decorate.

Long-form content needs one high-impact sentence per section, the line that makes the reader stop. The quiet sentences are what make that one land. When every line is loud, nothing is remembered. Once per section, one sentence should scream, and the quiet sentences are what make the scream possible

"once per section, one sentence should make the reader stop. The scream is what gets remembered. The quiet sentences are what make the scream possible."

· Dave Harland, The Copy Cabin, 2024

White space does structural work, not cosmetic work. Dense unbroken text triggers a visual-fatigue response before the reader processes a word of meaning. White space is oxygen, dense unbroken text creates cognitive load; strategic white space lets the eye rest and the reader continue

"treating white space as oxygen in her formatting"

· Ann Handley, Total Annarchy, 2024

Then cut. Conciseness is not polish. Every unnecessary word signals you value your message more than the reader's time. Conciseness is respect, every unnecessary word signals that you value your message more than the reader's time

"Conciseness is respect. Every unnecessary word signals that you value your message more than the reader's time."

· Eddie Shleyner, VeryGoodCopy, 2024

Subtraction is the default move across the whole page, not just the sentence. Strip every word, image, and section that does not earn its place before you add anything. Subtraction-first operating discipline

07 Design the behavioral architecture, including price framing and useful friction.

People do not evaluate value in isolation. They evaluate it by comparison. A page with a single price gives the buyer no way to compute whether it is fair. Reference points let them. The Relativity Principle, humans cannot evaluate prices in isolation, only by comparison

"humans cannot evaluate prices in isolation; they can only compare them"

· Dan Ariely, Predictably Irrational, 2008

The gap between $0.01 and $0.00 is larger than any other one-cent gap, because free short-circuits the cost-benefit trade-off entirely. A free entry point changes the question from "should I buy?" to "why not take it?" The Power of Free, the gap between $0.01 and $0.00 is psychologically larger than any other 1-cent gap

"The difference between 1 cent and 0 cents is psychologically enormous, not because of the penny but because \"free\" triggers a qualitatively different emotional response: zero risk, zero loss, zero cognitive load."

· Dan Ariely, Predictably Irrational, 2008

These are two threads of one discipline: pricing and conversion surfaces encode behavioral assumptions, and the architecture either fits how the buyer's brain processes prices or fights it. Pricing is a behavioral-architecture problem

Friction belongs in the design too, but with judgment. The reflex is to remove all of it. The better rule is to remove friction that does not help the user understand fit and add friction that does. Add friction when it helps users decide whether the product is for them

"Cut friction when it doesn't add to a user's experience of why the product is for them. Add friction when it helps users understand whether the product is for them."

· Amole Naik, Lenny's Podcast, 2026-04-27

Qualifying friction at the front filters in the right users and lifts activation per signup even when total signups fall. Quality and the right friction are growth levers, not the cost of growth. Quality and friction-as-feature are growth levers, not constraints

08 Prototype in low fidelity, then test comprehension before conversion.

Wireframe in boxes and headlines first, no visual design. The structure has to hold before the styling makes it pretty. Then run a 5-second test: show the page for five seconds and ask what the product does, who it is for, and what to do next. B2B homepages must communicate use case, alternative, and result in five seconds

Comprehension tests come before conversion tests. If a stranger cannot tell you what the page is about, no amount of button-color testing will fix it, because the problem is upstream of the button. Run the comprehension test on people outside your team. Insiders pass because they already know the answer.

For long-form work, the prototype is the draft, and the draft runs in three passes. Pass one sets the polarity and the headline. Pass two injects the voice. Pass three integrates and cuts whatever entertains but does not persuade. Writing all three at once produces clever lines with no persuasive force, or persuasive lines with no voice. Three sequential passes, pole + headline first, voice second, integration third, single-pass writing collapses persuasion and personality into mush

"Pass 1 identifies the pain/pleasure polarity and crafts the headline. Pass 2 injects the brand's distinctive voice and personality. Pass 3 integrates, ensuring pain clarity and personality are in harmony, cutting anything that entertains but does not persuade."

· Cole Schafer, Sticky Notes, 2024

09 Interleave pain, solution, and proof. Judge the result by what it sells.

When you have a working artifact, pair each pain claim with its own solution and a concrete proof point, rather than stacking all the pains, then all the solutions, then all the proof. Sequential structure asks the reader to hold abstract claims in memory too long, and by the time the proof arrives the pain has faded. Pitch a vision as pain → solution → proof, interleaved per beat, not three sequential acts

"Words will only get you so far... Figma practices what it preaches in terms of the future being visual communication."

· Mihika Kapoor, Lenny's Podcast, 2026-04-28

Then judge the page by the only test that matters. Not whether the team finds it creative. Whether it sells. Advertising is selling, not art, when I write an advert I don't want you to find it 'creative'; I want you to find it so interesting you buy the product

"When I write an advertisement, I don't want you to tell me that you find it 'creative'. I want you to find it so interesting that you _buy the product_."

· David Ogilvy, Ogilvy on Advertising, 1983

10 Make the page legible to agents, not just humans.

Agents now read pages in different patterns than people. They fetch in one or two requests, they get truncated by context windows, and analytics built for humans do not see them at all. The platform-level moves are concrete and stackable: access control, discovery via llms.txt, explicit capability statements, an answer-first TL;DR near the top, token discipline so a single page does not blow the context window, and a UX bridge like a copy-as-markdown button. Agent-first content has six platform layers, access, discovery, capability, format, token, UX bridge

Treat this as a top-of-funnel, docs, and comparison-page concern, not a brand-page concern. On a page built for human emotional response, agent-optimisation can flatten the experience. The deeper rule across AI-era content work: rank your motions by compounding effect and put human judgment where verification is the gate, not where volume is cheap. Strip what does not compound: AI abundance makes judgment the scarce resource

Check your work

  • The page is built from buyer research, not the team's taste. You can name the source for the language in the hero.
  • The problem is articulated at three layers, and the page does not force the philosophical layer onto a pure-utility product.
  • The hero answers use case, alternative, and result in roughly five seconds, and passes the caveman comprehension test.
  • The brand reads as the guide, not the hero: empathy plus authority, both present.
  • Every headline is clear at a glance. None require interpretation.
  • Every abstract claim has a concrete image the reader can see.
  • There is one scream sentence per section, and the quiet sentences earn it.
  • White space is structural. Paragraphs are short, and the page works on a phone.
  • Pricing and conversion surfaces give the buyer reference points, and any friction added is qualifying friction, not bureaucratic friction.
  • Comprehension was tested with strangers before any conversion test.
  • High-intent informational pages carry an answer-first TL;DR and are legible to agents.

What goes wrong

What you get

  1. Buyer research brief: the problem in the buyer's own language, sourced from interviews, tickets, and win/loss notes.
  2. Three-layer problem statement: external, internal, and philosophical, mapped to page sections.
  3. Information hierarchy: a section-by-section outline ordered by survival relevance, with one job per element.
  4. Hero block: use case, alternative, and result, passing the five-second and caveman tests, with the brand framed as guide.
  5. Body copy: clear headlines, concrete images, one scream per section, white space and conciseness applied.
  6. Behavioral architecture: price framing with reference points and qualifying friction designed into the flow.
  7. Low-fidelity wireframe and a three-pass draft for any long-form piece.
  8. Comprehension-test results from strangers, run before any conversion test.
  9. Agent-legibility pass for high-intent informational pages: answer-first TL;DR, capability statements, copy-as-markdown.