/messaging

name: messaging
description: >-
  Builds a product messaging library from your positioning, your website and customer evidence: a
  description, the status quo and alternatives, pain points with their knock-on consequences,
  capabilities, functional, emotional and social benefits, branded features, the cost of doing nothing,
  common objections with responses, and core messaging blocks (tagline, elevator pitch, value props,
  proof, per-audience lines). Every claim sourced. Triggers: "product messaging", "messaging library",
  "messaging framework", "value props", "capabilities and benefits", "what are our differentiators in
  words". Run after /positioning. Not for choosing the position itself (use /positioning).
version: '1.0.0'
license: MIT

Messaging

Turn the position into the words people will actually use: on the website, in sales calls, in emails and ads. The library links each pain to a capability, each capability to a benefit, and each benefit to proof, so any writer can pull a line and know it holds up.

When to use it

• Right after `/positioning` is agreed.
• Before rewriting the website, a sales deck or a launch.
• When sales, marketing and product describe the product three different ways.

Don't use it to choose the position (`/positioning`), or for a single-feature question you can answer directly.

Inputs

**Required:** the website URL and the exact product name. Confirm the name if it's ambiguous.

**Recommended:** read these first if they exist:

• `context/positioning/`, the primary input, which frames everything
• `context/icp/` for pains and voice of customer
• `context/competitors/` for the status quo and contrasts
• `context/win-loss/` for real objections
• `context/brand/` for tone of voice

Also useful: internal docs and customer quotes. If positioning is missing, say so and offer `/positioning` first.

**Paths.** Write to `context/messaging/MMYY-messaging.md`. Agency or consultant? Swap `context/` for `clients/<client>/context/` throughout.

**Tools.** Page fetching for the site; web search for reviews, testimonials and comparison pages. Exa or Firecrawl if you have them.

Steps

1. **Validate inputs** and load the upstream context. 2. **Research.** Fetch at least five core pages (home, features, pricing, customers, about) with URLs and dates. Search reviews and testimonials. Record branded feature names exactly as the company writes them. 3. **Extract the ten components, in order:** 1. **Description.** What it is, in one or two sentences, using the positioning. 2. **Status quo and alternatives.** Doing it by hand, plus at least one named alternative. 3. **Pain points.** Each with a consequence chain: the first-order problem, what it causes, what that costs the business. 4. **Capabilities.** What the product does about each pain. 5. **Functional benefits.** The outcome, each backed by a verbatim customer quote or marked "not available". 6. **Emotional and social benefits.** Two of each: how the buyer feels, and how they look to their boss and team. 7. **Features.** The branded names that deliver each capability. 8. **Cost of inaction.** What not acting costs per week or month, in numbers where you can. 9. **Objections.** 3 to 5, each with its root cause and a response that acknowledges, reframes and gives evidence. 10. **Core messaging blocks.** A tagline of 7 words or fewer, a one-sentence elevator pitch, a 3-bullet value prop, a lead proof point, and one line per audience segment. 4. **Link it up.** Every pain points to a capability, every capability to a feature and a benefit. 5. **Verify.** Check each claim against its source. Quotes are verbatim. Tag confidence `[VERIFIED]`, `[INFERRED]`, `[ESTIMATED]` or `[UNAVAILABLE]`. For a client-facing library, aim for at least 60% verified and no more than 10% estimated. 6. **Write the data gaps** and how to fill each one. 7. **Hand off** to `/funnel-strategy`, and to any copy work.

Output shape

Title it `# Product messaging library: [Product]`. Open with a TLDR and one block of open questions. Then the ten components in order, a data gaps section, and a source list with URLs and access dates.

What good looks like

• All ten components present, or marked "not available" with a reason.
• No pain point stops at the first-order problem.
• The cost of inaction has a number, not an adjective.
• The tagline and pitch match the agreed position. If they don't, flag it rather than drifting.
• A seller could answer the top three objections using only this file.

Mistakes to avoid

• Feature lists dressed up as benefits.
• Invented customer quotes or made-up metrics.
• Messaging that contradicts the positioning because a line sounded better.
• Buzzwords where a plain verb would do.
• Repeating the same caveat in every component. Say it once.

Chain

Step 9 of the suggested chain: `/company-context` → `/icp-research` → `/competitor-research` → `/win-loss` → `/expert-pov` → `/tov-guidelines` → `/brand-kit` → `/positioning` → **messaging** → `/funnel-strategy` → `/goals`.