a builder's codex
codex · playbooks · Copywriting mastery playbook

Copywriting mastery playbook

Architectural diagram · three-layer system

The Copy Mastery System

Awareness levels (Schwartz)
Unawarestory or proclamation; never mention product
Problem-awarename the pain precisely in their language
Solution-awareindirect promise: "there's a better way"
Product-awarestrongest unique claim; address objections
Most-awaredeal, guarantee, urgency — offer is the lead
Proof stacking (Halbert)
Claimone benefit, stated directly
Specific data"Save 4 hours per week on follow-up emails"
Named examplea real customer, a real outcome
Third-party validationanalyst citation, review platform metric
One proof type is a claim. Three is evidence.
Ogilvy moves
Headline as 80% of persuasionspend 20% of writing time here alone
Questions over declarations"Who owns your missed leads?" beats a statement
Buyer as agent"Get your team to close faster" beats "Our platform closes"
Agitate before you solvepain → emotional escalation → relief
Honest CTAs"Book a demo" if it's a demo. No more, no less.

Copy principles from the direct-response tradition (Schwartz, Ogilvy, Halbert, Bencivenga) and modern conversion practice (Shleyner, Schafer, Harland, Handley). Use alongside pb_writing-craft for the craft layer and pb_messaging-matrix for the strategic layer. This playbook covers the practitioner moves.

Quick reference, the 10 rules

  1. Diagnose the polarity first. Every buyer is either moving toward pleasure or away from pain. Pick the pole and write to it. Copy that activates neither does not convert.
  2. Match the hook to awareness level. Unaware: story or question. Problem-aware: name the pain precisely. Solution-aware: hint at a better way. Product-aware: strongest unique claim. Most-aware: the offer leads.
  3. Headline carries 80% of the weight. Spend 20% of writing time there alone. The headline is often the only element the reader sees.
  4. Clarity beats cleverness, always. A headline that requires interpretation has already failed. The reader does not allocate decoding time in a scanning context.
  5. Stack proof in layers. Claim, then specific data, then named example, then third-party validation. One proof type is a claim. Three is evidence.
  6. Buyer as agent. "Get your team to close 30% faster" beats "Our platform closes deals 30% faster." Put the buyer in motion.
  7. Benefits over pride. People do not want to know how proud you are. They want to know how you will change their situation.
  8. Setup before solution. Problem, then emotional escalation, then relief. Do not skip to the product.
  9. Interleave proof. Pain claim, then solution claim, then proof. Not all pain, then all solution, then all proof.
  10. Honest CTAs. "Book a demo" if it is a demo. "Start free trial" if it is a trial. The action on click must match the button.

The awareness framework (Schwartz)

Eugene Schwartz's key insight: copy cannot create desire. It can only channel desire that already exists. The strategic job is to identify the strongest existing desire the product can connect to and write to that desire, not to the product's features.

Awareness level determines how directly you can mention the product. The further from awareness, the more indirect the opening must be.

LevelWhat the buyer already knowsLead typeHow to open
UnawareNothing. They don't know the problem exists.Story or proclamationEmotional narrative; never mention the product in the first half
Problem-awareThey know the problem, not the solution category.Problem-solutionName the pain precisely in their exact language; do not invent language
Solution-awareThey know a solution exists, not this one.Indirect promise"There's a better way" without naming the product
Product-awareThey know the product, not convinced.Direct promiseStrongest unique claim; address objections head-on
Most-awareThey know everything, just haven't acted.The offerDeal, guarantee, urgency; the offer is the lead

Diagnosing awareness level before writing is not optional. The same product needs five different openings for five different audiences. A headline written for a most-aware buyer will mean nothing to an unaware one. An unaware buyer's opening will bore a most-aware buyer who wants the price.

How to diagnose: where is the audience finding this copy? A cold ad on a social feed reaches unaware buyers. A retargeting ad reaches product-aware or most-aware buyers. A comparison page reaches product-aware buyers actively evaluating. Match the opening to the channel.


The headline (Schafer, Shleyner, Ogilvy)

The headline is found, not invented. Ogilvy's rule: read every input document, every customer interview, every G2 review, every support ticket before writing a headline. Highlight the specific facts. The best headline is usually a fact that surprises you when you first encounter it.

"Spend 20% of your total writing time on the headline alone. If a page takes five hours to write, the headline gets a full hour of that time."

— Cole Schafer

Spend 20% of total writing time on the headline alone, it carries 80% of the persuasive weight

"Every headline must function as a complete persuasive argument in itself."

— Eddie Shleyner

Every headline must function as a complete persuasive argument, in the age of infinite scroll, the headline is often the only element a reader sees

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

— Eddie Shleyner

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

In scanning contexts, the headline is often the only element the reader encounters. The headline therefore must complete the persuasive argument on its own, for the 95% who never scroll past it. Body copy amplifies an already-made case. It does not make the case.

Three headline archetypes, each maps to a different funnel stage:

Pick the archetype that fits the awareness level of the audience. Do not mix them in the same headline. Then write 10 versions and choose the sharpest one. The first version is rarely the sharpest.


The polarity principle (Schafer)

Every buying decision reduces to one axis: moving toward pleasure or moving away from pain. Copy that does not activate either pole is ignored.

"People buy for exactly one reason: to move closer to pleasure or further from pain. Everything else is noise."

— Cole Schafer

Every buying decision reduces to one polarity, moving toward pleasure or away from pain. Copy that activates neither doesn't convert.

Diagnosing the pole is a research job. Look at the interviews and the reviews. What language do buyers use? Relief language ("finally," "no more," "we can stop...") signals a pain buyer. Aspiration language ("imagine," "the kind of team that," "now we can...") signals a pleasure buyer. Write to the language you find. Do not impose a pole the buyer is not on.

Most B2B copy lives on the pain pole. That is where the urgency is. The thing the buyer is trying to escape is more emotionally loaded than the thing they are moving toward. Pleasure copy works better for growth and lifestyle products where the aspiration is tangible.

The mistake is oscillating between both poles in the same piece. Pick one and commit. A headline that mixes "escape the chaos" with "unlock new growth" is not delivering both; it is delivering neither.


Reader-centredness (Harland, Handley)

The most common B2B copy failure is company-side framing: "We are proud to announce..." / "Our award-winning team..." / "We have been delivering excellence since..." The reader does not care. The reader wants to know what you will do for them.

"People don't want to know how proud you are of your company. They want to know how you'll change their life."

— Dave Harland

People don't want to know how proud you are, they want to know how you'll change their life

The discipline is simple and consistently violated: start sentences with "you" and "your" more often than with "we" and "our." Each "we" sentence asks: is this sentence serving the reader, or serving the company? If it is serving the company, cut it or rewrite it to serve the reader.

This is not anti-feature. Features earn their place by answering "what will the buyer be able to do that they cannot do now?" State the capability, then the benefit. Skip the feature-first framing.


Proof stacking (Halbert)

Single-proof claims fail. Three-layer proof is evidence.

The Halbert sequence:

  1. Claim. One benefit, stated directly.
  2. Specific data. "Save 4 hours per week on follow-up emails." Not "save time." Specific numbers.
  3. Named example. A real customer, a real outcome. Name the company.
  4. Third-party validation. Analyst citation, review platform metric, award.

Round numbers without sources read as invented. "40% faster" from no source is a claim. "38% faster" from a named study is evidence. The specificity is what signals that someone measured it.

Proof is most persuasive when it is adjacent to the claim it supports. Not stacked into a testimonials section at the bottom of the page. Every capability claim gets its own proof point, interleaved.

"Vision pitches land harder when each pain claim is paired with its own solution claim and a concrete proof point, interleaved per beat, not three sequential acts."

— Mihika Kapoor, Figma

Pitch a vision as pain → solution → proof, interleaved per beat, not three sequential acts


The believability gap (Bencivenga)

Buyer skepticism is the default state. Every claim you make lands against a prior belief that marketing inflates. Bencivenga's contribution: the believability gap is measurable and closable.

Close it with:

The believability gap is wider for outrageous promises. The bigger the claim, the more proof you need. The worst combination: a large claim with no source. The best: a specific claim with a named company, a named outcome, and a number.


Voice (Handley)

In a market saturated with AI-generated prose, the only defensible advantage is a distinctive voice.

"The only defensible advantage is a distinctive, authentic voice that sounds like it could only come from one source."

— Ann Handley

In an AI-flooded content market, voice is the only defensible advantage, distinct, authentic, sounds like one source

Voice is not a style guide. It is a function of a specific person's perspective, word habits, and lived experience. It cannot be replicated without that person's continued involvement.

Voice degrades when it is delegated to a content team following a guide. The guide can describe the voice. It cannot produce it.

For brand copy, the founder voice is the highest-signal version. It contains a specific point of view that competitors cannot authentically claim, because it emerges from a specific company's history and the founder's specific experiences.

The practical discipline: write the first draft without editing. Get the voice on the page before the correctness edit starts. Voice usually lives in the drafts, not the final. When you edit aggressively for correctness before capturing voice, you get polished but empty prose.


VoC-mined headlines (Wiebe)

Customer language surfaces in reviews, support tickets, sales calls, and onboarding chats. The phrases that convert in headlines are almost always phrases buyers used first, not phrases the marketing team invented.

The method: collect 50 to 100 customer phrases before writing a single headline. Look for phrases that appear across multiple buyers unprompted. Those are the headline candidates. The phrases with the most repetition are the phrases the market uses to describe its own problem. Use them verbatim.

Run a 5-second test: show the page to 5 people for 5 seconds, then ask what the product does. If they cannot answer, rewrite the hero. The test is not about opinion. It is about comprehension. If a first-time visitor cannot tell what the product does in 5 seconds, the positioning is not on the page.


Section-level operating rules

Hero. Communicate use case, alternative, and result in 5 seconds.

"B2B homepages should lead with the trinity of the specific use case, the alternative the buyer is currently using, and the result the product produces, communicable in roughly five seconds."

— Anthony Pierri, FletchPMM

B2B homepages must communicate use case, alternative, and result in five seconds

Lead with capabilities, what someone does with the product, not aspirational outcomes. "Build pipeline" describes an aspiration. "Call 300 leads per day without manual dialing" describes a capability. The capability is what converts.

Feature sections. Three-W formula. What it is. Why the benefit matters. So what the outcome is. One job per section. If a feature section is doing two jobs, split it.

Social proof. Specific metric + named person + named company. Interleave after every 2nd or 3rd benefit claim. Do not segregate to a testimonials section only. Proof adjacent to the claim it supports is more credible than proof segregated.

CTAs. Repeat throughout the page. Honest verbs. Match what happens on click. "Book a demo" if it is a demo. "See the product" if it is a video. The reader who clicks and finds something different than expected does not convert.


Common failure modes


Quality gates

Before publishing any copy, verify:


Outputs

  1. Awareness-level diagnosis for each channel and audience.
  2. Polarity decision: pain or pleasure, with supporting evidence from buyer language.
  3. 10 headline variations per section before final selection.
  4. Value matrix: pain, capability, benefit, and message per persona (see pb_messaging-matrix).
  5. Hero copy: H1, H2, and CTA that pass the 5-second test.
  6. Proof stack per capability claim: specific data point, named example, third-party source.
  7. Section copy: feature sections in Three-W format (What, Why, So what).
  8. Voice draft: first pass written without correctness edits, voice captured before polish.
  9. CTA audit: honest verb matched to the actual action on click.
  10. Full 5-second test results with rewrite if comprehension failed.
Open the interactive view →