a builder's codex
codex · playbooks · Messaging matrix playbook

Messaging matrix playbook

Annotated pipeline · 20 steps in 6 stages

The Messaging Build

01

Lock the champion

Closest to the problem, not the budget holder — that's your messaging anchor

02

Run JTBD interviews

10+ customers, verbatim language captured — their words, not your paraphrase

03

Build the value matrix

Segment × value type — functional (what it does), emotional (dread avoided), social (status signal)

04

Write the message house

3 pillars max — one claim, one proof, one customer line per pillar

05

Generate 3+ angles

Test before choosing — the "best" headline is never obvious before you see alternatives

06

Write homepage, roll out to all assets

Homepage anchors the hierarchy — ads, decks, one-pagers all derive from it, never the reverse

Steps 07–20: segment reframings · objection handling · channel variants · rollout cadence →

Translate a finished positioning document into a messaging system: champion definition, value matrix, messaging house, core narrative, homepage structure, and rollout. Pulls Pierri's 7-step homepage framework, Dunford's Setup / Follow-Through pitch architecture, and Moesta's JTBD interview method for surfacing buyer language.

Run this after positioning is locked. Before any homepage rewrite, sales-deck refresh, or paid-channel push. Re-run after major ICP, product, or competitive shifts.

Inputs required

Steps

01 Lock the champion. Situation, not just job title.

The champion is the person closest to the problem with the motivation to push the decision through. Not the budget holder, who is too far removed from the daily pain to drive urgency. Not the IT buyer, who evaluates fit but does not feel the cost of doing nothing.

Define the champion in three layers:

The situation layer is the one most messaging skips. Two people with the same job title can have completely different buying situations. A sales manager at a 20-person startup who just missed a quarter has different urgency than a sales manager at a 200-person company optimizing an already-working process. Same persona, different situation, different message.

02 Mine customer interviews for the actual language.

Do not write messaging from your own vocabulary. Write it from the buyer's vocabulary. The phrases that land in headlines are almost always phrases buyers said in interviews, not phrases the product team invented.

JTBD switch interviews are the best source. They trace the timeline from trigger through decision. The trigger language ("we had a critical demo and the call quality broke on us") tells you where and how to advertise. The decision language ("we just needed something that worked without us thinking about it") tells you what the headline should say.

"JTBD interviews help you define a customer's language, what they actually mean by 'easy,' the root cause of why they switched, and how their story connects, all of which directly impact your product marketing."

— Bob Moesta, Intercom podcast

JTBD interviews surface the customer's actual language and the switch trigger

After 5 to 10 interviews, look for the phrases that appear across multiple buyers without being prompted. Those are your message candidates. Test them. If you can copy-paste a customer phrase into a headline and it sounds sharper than your current headline, that is not a coincidence.

03 Map the champion's situation. Then narrow to the exact pain.

List the functional activities the champion does day-to-day. Cross out everything the product does not address. What remains is the overlap between the buyer's situation and the product's capability. That overlap is where the message lives.

Most B2B messaging fails because it speaks to too many situations at once. "Streamline your workflow" covers everything and describes nothing. The champion's exact situation, described in behavioral terms, is a much tighter target.

Example: instead of "improve team productivity," the situation is "we have 8 reps calling the same prospect list, no way to see who talked to whom, and we lose deals because we call the same person twice in a day." That situation has a message. The first one does not.

04 Document the old way. This is what the Setup is about.

Before you can sell the new way, the buyer needs to recognize that the current way is failing them. Andy Raskin calls this the "old game to new game" narrative. April Dunford calls it the Setup.

"A live sales pitch is the best way for B2B companies to test their positioning… sales is a back-and-forth with a prospect; sales can and should be asking questions, looking for feedback, and handling objections. Marketing doesn't fully understand the sales team's needs when it comes to a narrative."

— April Dunford, "Sales-First Storytelling"

Test positioning in a live sales pitch, marketing stories are unfalsified theory until then

The Setup has three parts:

Document the Setup before writing any product messaging. If the Setup lands, the product claims follow naturally. If the Setup is weak, no feature list will compensate.

"When you survey buyers who didn't buy, 40–60% say they made no purchase decision at all."

— April Dunford, Lenny's Podcast, 2026-04-28

40–60% of B2B buyers say "no decision", your real competitor is the status quo

The most important alternative to include in the Setup is the status quo. Most deals are lost to inertia, not to named competitors. The Setup must make the cost of inaction concrete.

05 Choose the comparator. This determines the message architecture.

The comparator is the alternative the buyer is most likely to evaluate. It could be a direct competitor, a manual process, or an adjacent tool. Name it explicitly. The message hangs off the comparison.

Emily Kramer's four product types tell you which message architecture fits:

Product typeComparatorMessage job
New categoryThe old way of doing thingsExplain the category exists and why it matters
10x betterDirect competitorProve superiority on a specific, measurable dimension
New wayA manual processMake the old way feel costly and the new way feel inevitable
IncumbentPrice, feature parity, trustSignal stability and depth

The comparator also determines the Setup's length. Greenfield comparators need more explanation. Known competitors need less.

06 Build the value matrix. Per persona, not per feature.

For each champion persona, map the full chain from pain to message:

Pain / SituationProduct BenefitFeature / CapabilityMessage
What blocks themWhat the product solvesWhat powers itHow to say it in one line

The key constraint: the message column must be specific to the persona's situation. If the same message works for two different personas without editing, it is too generic for either.

Features connect to benefits through capabilities. The capability is what the user actually does. The feature is what enables it. The benefit is what changes because of it.

Most messaging jumps from feature to benefit and skips capability, leaving the buyer to make the connection themselves. Do not make them.

Example:

PainBenefitCapabilityMessage
Calls go to voicemail after hoursNo missed revenue opportunitiesAI agent answers and qualifies every call"Every inbound call gets answered, even at 2am, and the summary is in your CRM by morning"

07 Write the overall positioning paragraph. One-liner, then expand.

Unique Belief + Value Provided + Who Cares. The one-liner is the test. If it requires more than one sentence to be understood, the positioning is not yet sharp.

Then expand to two to three sentences for the paragraph version used in sales decks and email signatures. The expansion adds context but does not dilute the core claim.

Run the four-question test against the one-liner:

  1. What is it? (category)
  2. Who is it for? (champion)
  3. What does it replace? (comparator)
  4. Why is it better? (differentiator)

"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

08 Map the capability layer. This is where copy hangs.

For each feature you plan to highlight, define what the user does. The capability bridges feature to benefit. Copy hangs off capabilities, not features.

Wrong: "Our AI summarizes meetings." (feature)

Right: "Review the full call in 90 seconds and see which objections came up." (capability)

Better: "Know exactly where every deal stood before you walk into the next call." (capability + emotional frame)

The capability layer also tells you what to demo. Not the feature. What the user does with the feature. Show the user doing something, not the interface existing.

09 Build the messaging house. Exactly three pillars.

         [Overall value proposition — one sentence]
    /                    |                    \
[Pillar 1]         [Pillar 2]         [Pillar 3]
    |                    |                    |
[Feature, proof]   [Feature, proof]   [Feature, proof]

Three pillars. No more. If you have four or five value themes, choose the three that matter most to the champion. The others can live in dedicated landing pages or persona-specific content.

Each pillar needs:

The messaging house is the internal architecture. It is not customer-facing copy. Sales uses it to stay consistent. Marketing uses it to brief content. Copy hangs off it but is not identical to it.

10 Write the core narrative. One paragraph, then adapt per channel.

One paragraph: problem, stakes, solution, outcome. This is the seed. Every channel adaptation starts here and adjusts length, tone, and evidence to fit the context. The paragraph version is for email signatures, about pages, and investor updates. The one-liner is for ads and cold outreach. The three-pillar version is for the homepage.

The company story is the strategy. When sales decks, the homepage, and product release notes start diverging from each other, positioning is drifting.

"The company story is the company strategy."

— Andy Raskin, citing Amplitude, Clearbit, Auvik cases

Run a monthly narrative-drift audit across decks, homepage, and release notes

Set a monthly audit: compare the sales deck, the homepage hero, and the most recent release notes. Do they share the same problem framing and the same differentiator claim? When they diverge, fix before the next campaign launches.

11 Generate 3 or more angles. Evaluate before choosing.

The core narrative has one setup. The angle is how you enter the conversation. Different anchors work for different personas and different awareness levels.

Common anchor types:

For each angle, map: anchor type, persona it targets, emotional driver it activates. Evaluate against your ICP before choosing. Do not choose based on what sounds best internally. Choose based on what your champion cares about most.

12 Structure the homepage. Problem-led, not solution-led.

The homepage structure follows Pierri's buyer-journey logic:

SectionJobWhat to include
HeroAnswer all 4 positioning questions in 5 secondsH1 (main value), H2 (supporting), CTA
Social proofBuild immediate trustLogo bar, metric-backed quotes
Problem sectionEstablish the cost of inactionChampion's situation in their language
Solution by personaShow the product as the answerPersona-specific value props + embedded quotes
Capability sections (x3)Prove each messaging pillarFeature shown as user action, not product feature
DifferentiationWhy you vs. the alternative they currently useBefore / After, Us vs. them, old way vs. new way
TrustHandle the remaining objectionsSecurity, integrations, compliance, customer count
Closing CTAReinforce the heroSame message, different wording

Each pain claim should be followed immediately by its solution and a proof point. Not pain for three sections, then solution for three sections, then proof. 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, Lenny's Podcast

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

13 Embed social proof per persona section.

Proof is most effective adjacent to the claim it supports. Not segregated to a testimonials page. Not grouped into a testimonial section at the bottom.

For each capability section: specific metric + named person + named company. "Teams close 30% faster" is weaker than "Acme's 12-person team went from 40 dials per rep per day to 120 in the first week." Specificity is what makes proof credible. Generic proof is just a claim.

If industry or vertical matters to your champion, add panels. Pain + solution + proof per vertical. A real estate team and a dental practice have different objections and different success metrics. The homepage's job is to signal that you understand that.

14 Build the rollout tracker. Phase by business impact.

Every page needs to be updated, but not all at once. Score each page by traffic × conversion rate impact × strategic importance. Update highest-impact pages first.

Build a tracker with four columns: page, current messaging score (1 to 3), new messaging version status, owner + ETA. Review weekly until rollout is complete. This is not a waterfall. Update pages as they are ready, not in a batch.

15 Test in live pitches. Messaging is theory until it survives a real buyer.

Before declaring the messaging done, run it through three to five live discovery calls. Sit alongside a rep or listen to the recording. Watch for:

Those moments are where the messaging broke. Fix them. Then test again.

The sales team will detect messaging failures months before any dashboard does. Build the rep-input loop early: a weekly objection log, a competitive Slack channel, call-shadowing twice a month. Without that loop, messaging drift accumulates silently.

Quality gates

Common failure modes

Outputs

  1. Champion profile (company type, persona, JTBD situation).
  2. Value matrix per persona (pain, benefit, capability, message).
  3. Messaging house (3 pillars with feature-level evidence).
  4. Core narrative (one paragraph, seed for all channels).
  5. Angle comparison sheet (3+ options evaluated against ICP).
  6. Homepage wireframe with copy for each section.
  7. Before / After frames for differentiation section.
  8. Rollout tracker (page, score, status, owner).
Open the interactive view →