taketomarket 2.2.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/.claude-plugin/marketplace.json +4 -4
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/README.md +34 -11
  4. package/bin/lib/campaign.cjs +12 -8
  5. package/bin/lib/codebase-scan.cjs +86 -0
  6. package/bin/lib/config.cjs +129 -0
  7. package/bin/lib/deploy.cjs +36 -0
  8. package/bin/lib/deviation.cjs +1 -1
  9. package/bin/lib/drift-log.cjs +4 -4
  10. package/bin/lib/health.cjs +32 -31
  11. package/bin/lib/install-detect.cjs +62 -0
  12. package/bin/lib/legacy-folder.cjs +100 -0
  13. package/bin/lib/playwright-check.cjs +26 -0
  14. package/bin/lib/site-location.cjs +22 -0
  15. package/bin/lib/state.cjs +3 -3
  16. package/bin/lib/svg-render.cjs +42 -0
  17. package/bin/ttm-tools.cjs +136 -4
  18. package/gates/base-gates.md +8 -8
  19. package/gates/gate-evaluation.md +8 -8
  20. package/install.js +37 -3
  21. package/package.json +10 -6
  22. package/playbooks/aeo.md +218 -114
  23. package/playbooks/affiliate.md +225 -160
  24. package/playbooks/email.md +236 -174
  25. package/playbooks/events.md +303 -213
  26. package/playbooks/landing-pages.md +305 -0
  27. package/playbooks/linkedin.md +264 -142
  28. package/playbooks/manifesto.md +322 -0
  29. package/playbooks/paid-ads.md +240 -189
  30. package/playbooks/positioning.md +340 -0
  31. package/playbooks/pr-media.md +308 -168
  32. package/playbooks/pseo.md +426 -0
  33. package/playbooks/seo.md +251 -158
  34. package/playbooks/social.md +253 -182
  35. package/playbooks/youtube.md +286 -181
  36. package/references/brand-color-theory.md +48 -0
  37. package/references/codex-image-gen-research.md +58 -0
  38. package/references/context-loading.md +6 -6
  39. package/references/humanizer-patterns.md +433 -0
  40. package/references/inline-education-blurbs.md +461 -0
  41. package/references/landing-page-anatomy.md +64 -0
  42. package/references/linkedin-post-patterns.md +174 -0
  43. package/references/logo-design-principles.md +55 -0
  44. package/references/meta-gate-evaluation.md +3 -3
  45. package/references/obra-superpowers-conventions.md +170 -0
  46. package/references/playbook-leaders.md +472 -0
  47. package/references/playwright-mcp-setup.md +164 -0
  48. package/references/positioning-check-report.md +2 -2
  49. package/references/pseo-page-anatomy.md +56 -0
  50. package/references/pseo-templates/alternative-anatomy.md +31 -0
  51. package/references/pseo-templates/alternative-content-playbook.md +32 -0
  52. package/references/pseo-templates/blog-anatomy.md +28 -0
  53. package/references/pseo-templates/blog-content-playbook.md +36 -0
  54. package/references/pseo-templates/comparison-anatomy.md +29 -0
  55. package/references/pseo-templates/comparison-content-playbook.md +35 -0
  56. package/references/pseo-templates/use-case-anatomy.md +28 -0
  57. package/references/pseo-templates/use-case-content-playbook.md +30 -0
  58. package/skills/ttm-101/SKILL.md +25 -0
  59. package/skills/ttm-aeo-check/SKILL.md +17 -12
  60. package/skills/ttm-affiliate-kit/SKILL.md +5 -0
  61. package/skills/ttm-archive/SKILL.md +5 -0
  62. package/skills/ttm-brand-refresh/SKILL.md +5 -0
  63. package/skills/ttm-brief/SKILL.md +5 -0
  64. package/skills/ttm-competitor-scan/SKILL.md +5 -0
  65. package/skills/ttm-deploy/SKILL.md +22 -0
  66. package/skills/ttm-discover/SKILL.md +17 -0
  67. package/skills/ttm-email-check/SKILL.md +17 -0
  68. package/skills/ttm-email-preflight/SKILL.md +17 -11
  69. package/skills/ttm-fix/SKILL.md +5 -0
  70. package/skills/ttm-health/SKILL.md +6 -1
  71. package/skills/ttm-humanize/SKILL.md +33 -0
  72. package/skills/ttm-icp-refresh/SKILL.md +5 -0
  73. package/skills/ttm-improve-skill/SKILL.md +18 -0
  74. package/skills/ttm-init/SKILL.md +10 -3
  75. package/skills/ttm-keyword-map/SKILL.md +17 -11
  76. package/skills/ttm-landing/SKILL.md +19 -0
  77. package/skills/ttm-learn/SKILL.md +5 -0
  78. package/skills/ttm-linkedin-post/SKILL.md +26 -0
  79. package/skills/ttm-measure/SKILL.md +5 -0
  80. package/skills/ttm-new-campaign/SKILL.md +5 -0
  81. package/skills/ttm-next/SKILL.md +5 -0
  82. package/skills/ttm-playwright-setup/SKILL.md +18 -0
  83. package/skills/ttm-positioning-check/SKILL.md +5 -0
  84. package/skills/ttm-positioning-shift/SKILL.md +5 -0
  85. package/skills/ttm-produce/SKILL.md +5 -0
  86. package/skills/ttm-pseo/SKILL.md +26 -0
  87. package/skills/ttm-repurpose/SKILL.md +5 -0
  88. package/skills/ttm-request-skill/SKILL.md +18 -0
  89. package/skills/ttm-research/SKILL.md +18 -6
  90. package/skills/ttm-resume/SKILL.md +5 -0
  91. package/skills/ttm-review/SKILL.md +5 -0
  92. package/skills/ttm-seo/SKILL.md +64 -0
  93. package/skills/ttm-seo-audit/SKILL.md +17 -12
  94. package/skills/ttm-ship/SKILL.md +5 -0
  95. package/skills/ttm-state/SKILL.md +5 -0
  96. package/skills/ttm-update/SKILL.md +152 -4
  97. package/skills/ttm-verify/SKILL.md +5 -0
  98. package/templates/agents-md.md +14 -4
  99. package/templates/campaign-research.md +6 -6
  100. package/templates/campaign-state.md +1 -1
  101. package/templates/claude-md.md +14 -4
  102. package/templates/linkedin-base-template.md +48 -0
  103. package/templates/next-step-footer.md +13 -0
  104. package/templates/production-manifest.json +4 -4
  105. package/templates/pseo/alternative-cms-schema.json +65 -0
  106. package/templates/pseo/blog-cms-schema.json +55 -0
  107. package/templates/pseo/comparison-cms-schema.json +56 -0
  108. package/templates/pseo/use-case-cms-schema.json +62 -0
  109. package/templates/reference-files/brand.md +51 -0
  110. package/templates/reference-files/product-dna.md +73 -0
  111. package/templates/site-scaffold/app/globals.css +2 -0
  112. package/templates/site-scaffold/app/layout.tsx +17 -0
  113. package/templates/site-scaffold/app/page.tsx +33 -0
  114. package/templates/site-scaffold/app/robots.ts +8 -0
  115. package/templates/site-scaffold/app/sitemap.ts +10 -0
  116. package/templates/site-scaffold/app/tokens.css +21 -0
  117. package/templates/site-scaffold/components/Comparison.tsx +14 -0
  118. package/templates/site-scaffold/components/Faq.tsx +14 -0
  119. package/templates/site-scaffold/components/Features.tsx +14 -0
  120. package/templates/site-scaffold/components/FinalCta.tsx +17 -0
  121. package/templates/site-scaffold/components/Footer.tsx +12 -0
  122. package/templates/site-scaffold/components/Hero.tsx +22 -0
  123. package/templates/site-scaffold/components/HowItWorks.tsx +14 -0
  124. package/templates/site-scaffold/components/PricingTeaser.tsx +14 -0
  125. package/templates/site-scaffold/components/Problem.tsx +14 -0
  126. package/templates/site-scaffold/components/SocialProof.tsx +14 -0
  127. package/templates/site-scaffold/components/Solution.tsx +14 -0
  128. package/templates/site-scaffold/components/Testimonials.tsx +14 -0
  129. package/templates/site-scaffold/components/UseCases.tsx +14 -0
  130. package/templates/site-scaffold/content/.gitkeep +0 -0
  131. package/templates/site-scaffold/lib/.gitkeep +0 -0
  132. package/templates/site-scaffold/next.config.mjs +10 -0
  133. package/templates/site-scaffold/package.json +25 -0
  134. package/templates/site-scaffold/postcss.config.mjs +3 -0
  135. package/templates/site-scaffold/public/llms.txt +9 -0
  136. package/templates/site-scaffold/tsconfig.json +21 -0
  137. package/templates/verification-report.md +1 -1
  138. package/workflows/channel/linkedin-post.md +178 -0
  139. package/workflows/discipline/affiliate-kit.md +65 -6
  140. package/workflows/discipline/{email-preflight.md → email-check.md} +39 -4
  141. package/workflows/discipline/repurpose.md +82 -31
  142. package/workflows/discipline/{aeo-check.md → seo/aeo.md} +13 -6
  143. package/workflows/discipline/{seo-audit.md → seo/audit.md} +13 -6
  144. package/workflows/discipline/{keyword-map.md → seo/keyword-map.md} +13 -6
  145. package/workflows/education/ttm-101.md +114 -0
  146. package/workflows/lifecycle/brief-positioning-check.md +1 -1
  147. package/workflows/lifecycle/brief.md +64 -28
  148. package/workflows/lifecycle/{research.md → discover.md} +61 -19
  149. package/workflows/lifecycle/fix.md +72 -37
  150. package/workflows/lifecycle/humanize.md +280 -0
  151. package/workflows/lifecycle/learn.md +72 -35
  152. package/workflows/lifecycle/measure.md +54 -18
  153. package/workflows/lifecycle/produce.md +88 -37
  154. package/workflows/lifecycle/review.md +71 -25
  155. package/workflows/lifecycle/ship.md +62 -18
  156. package/workflows/lifecycle/verify.md +72 -26
  157. package/workflows/reference-mgmt/brand-refresh.md +50 -13
  158. package/workflows/reference-mgmt/competitor-scan.md +51 -15
  159. package/workflows/reference-mgmt/icp-refresh.md +48 -12
  160. package/workflows/reference-mgmt/positioning-check.md +55 -20
  161. package/workflows/reference-mgmt/positioning-shift.md +53 -17
  162. package/workflows/setup/init-brand-colors.md +75 -0
  163. package/workflows/setup/init-logo.md +113 -0
  164. package/workflows/setup/init-product-dna.md +83 -0
  165. package/workflows/setup/init-questions.md +166 -30
  166. package/workflows/setup/init-validation.md +22 -0
  167. package/workflows/setup/init.md +144 -39
  168. package/workflows/setup/new-campaign.md +48 -12
  169. package/workflows/site/deploy.md +98 -0
  170. package/workflows/site/landing.md +156 -0
  171. package/workflows/site/pseo.md +96 -0
  172. package/workflows/site/quality-gates.md +88 -0
  173. package/workflows/utility/archive.md +45 -9
  174. package/workflows/utility/health.md +77 -3
  175. package/workflows/utility/improve-skill.md +233 -0
  176. package/workflows/utility/next.md +38 -2
  177. package/workflows/utility/playwright-setup.md +128 -0
  178. package/workflows/utility/request-skill.md +218 -0
  179. package/workflows/utility/resume.md +40 -3
  180. package/workflows/utility/state.md +42 -7
@@ -0,0 +1,305 @@
1
+ ---
2
+ discipline: landing-pages
3
+ asset_types: [homepage, feature-page, use-case-page, comparison-page]
4
+ version: "1.0"
5
+ ---
6
+
7
+ # Landing Pages Playbook
8
+
9
+ This playbook extends the base playbook contract (`base.md`) with landing-page-specific production guidance, discipline gates, and format rules. It treats messaging as a hierarchy — Clarity, then Relevance, then Value, then Differentiation — and refuses to optimize a layer until the layer above it works. Operational page structure (section order, schema, CTAs) lives in `references/landing-page-anatomy.md`; this playbook is about what every page must *say*, in what order, before any of that matters.
10
+
11
+ > Buttons and colors do not move conversion. Messaging and the order of messaging do. If the headline fails, every downstream tweak is rounding error.
12
+
13
+ ---
14
+
15
+ ## Production Guidance
16
+
17
+ ### The Four-Layer Messaging Hierarchy
18
+
19
+ Every landing page is a state machine running through four questions a visitor asks in order. Skip a layer and the next layer cannot land.
20
+
21
+ 1. **Clarity — "Do I know what this is?"** Lead with the category in plain language a 12-year-old understands. Not "AI-native workflow orchestration"; "scheduling software for dental offices." The category name is the floor — until the visitor can label what they are looking at, no amount of value copy registers. If a 5-second test (show the page for 5 seconds, then hide it; ask the viewer to describe what the product does) fails, the page fails. Nothing else matters yet.
22
+ 2. **Relevance — "Is this for me?"** Once they know what it is, they ask if it applies to them. Name the ICP role, the use case, and the pain in the visitor's own vocabulary. "For Series A SaaS founders running outbound email" beats "for businesses of all sizes." Relevance is mined from audience research — Wynter-style message tests, customer-interview transcripts, sales-call recordings — not invented at the whiteboard.
23
+ 3. **Value — "Do I want it?"** Now, and only now, tease the promised land. State outcomes, not features. "Close your books in 2 days instead of 10" beats "automated reconciliation engine." Paint the after-state in the visitor's life. Features are evidence for the outcome, not substitutes for it.
24
+ 4. **Differentiation — "Why this versus alternatives?"** Last layer. Until clarity, relevance, and value land, comparison copy is wasted. The alternative being beaten must be named — a competitor, "spreadsheets," "doing it manually," "the way your team does it today." A differentiator without a named alternative is a brag, not a contrast.
25
+
26
+ The hierarchy is strict. A page that nails differentiation but fails clarity is a worse-performing page than one that nails clarity and ignores differentiation. Fix from the top down, always.
27
+
28
+ ### Audience Research Comes First
29
+
30
+ You cannot write the four layers from inside your own head. The vocabulary in every layer must come from the audience itself. Before drafting hero copy, do at least one of:
31
+
32
+ - **5-second test** — show the current page (or a draft) for 5 seconds to 5+ ICP-matching viewers; ask "what does this product do, and who is it for?" If fewer than 4 out of 5 answer correctly, the Clarity layer has failed.
33
+ - **Likert-scale message test** — score each of the four layers on a 1–5 scale with target audience members (Wynter, customer panels, or your own waitlist). Fix the lowest-scoring layer first; do not move on until that layer scores 4+.
34
+ - **Customer-language mining** — pull verbatim phrases from sales-call transcripts, support tickets, onboarding chats, and review sites. The hero subhead and the relevance line should reuse those phrases nearly verbatim. If the copy sounds like marketing, it is your vocabulary, not theirs.
35
+
36
+ Message-market fit precedes product-market fit in marketing. If the message does not resonate, no amount of traffic helps.
37
+
38
+ ### Specificity Over Cleverness
39
+
40
+ Clever-but-vague always loses to boring-but-specific. "Welcome to the future of work" tests worse than "Payroll software for restaurants with 5–50 employees." A page sounds smart when the writer is performing for peers; a page converts when the writer is answering the visitor's questions in the order the visitor asks them.
41
+
42
+ Concrete tells of clever-over-clear:
43
+ - Headlines that could belong to any product in the category (swap your logo for a competitor's and the page still reads — that is a failure).
44
+ - Metaphors and wordplay in the H1 ("Unleash your inner ___").
45
+ - Category language invented by the company ("the [adjective] [adjective] platform").
46
+ - "AI-powered" or "next-generation" used as a substitute for what the thing actually does.
47
+
48
+ ### Above-the-Fold Must Carry All Four Layers
49
+
50
+ The hero is not "the headline." The hero is the answer to all four questions before the visitor scrolls. A complete hero contains:
51
+
52
+ - **H1** — Clarity + Value. Names the category and states the outcome.
53
+ - **Subhead** — Relevance. Names the ICP role, use case, or pain.
54
+ - **Primary CTA** — action verb that fits the value layer.
55
+ - **Differentiator line or visual proof** — names the alternative and the contrast, often in the subhead's second clause or as a strapline above the H1.
56
+ - **Social proof** — logo strip, customer count, or named-customer quote — corroborates that the four layers above are not a claim but a delivered reality.
57
+
58
+ If any layer is missing above the fold, the page fails the hierarchy regardless of what comes below.
59
+
60
+ ### Page-Type Specifics
61
+
62
+ - **Homepage** — must complete all four layers above the fold; downstream sections add evidence and depth but cannot rescue a broken hero.
63
+ - **Feature page** — clarity layer is anchored on the *feature's job*, not the company's category. Relevance narrows to the workflow the feature solves. Differentiation contrasts the feature against the closest in-category alternative, not the whole product.
64
+ - **Use-case page** — relevance and value layers carry disproportionate weight. The headline names the use case explicitly ("Onboarding email automation for SaaS trials"). Differentiation is against the way teams currently solve the use case, often a workaround, not a competitor.
65
+ - **Comparison page** — differentiation is the entire page, but it only earns the right to exist after clarity and value are established elsewhere. A comparison page in isolation, without a hero that establishes what you are, is a brag-list.
66
+
67
+ ### Test the Messaging, Not the Buttons
68
+
69
+ A/B tests on button color, CTA copy permutations, hero image swaps, and font choices produce rounding-error lifts. Real lift comes from testing the hierarchy itself — different H1 framings, different ICP callouts, different value statements, different named alternatives. Test the layer that is currently scoring lowest in audience research; ignore the rest.
70
+
71
+ ### The Pricing Page Is a Landing Page Too
72
+
73
+ In B2B SaaS, the pricing page is the highest-leverage CRO target — more visitors arrive ready-to-buy than on any other page — and most companies sabotage it by hiding numbers behind "contact sales." Show pricing wherever it is structurally possible. The Four-Layer Hierarchy applies: visitors arriving on a pricing page have already passed Clarity and Relevance; they are evaluating Value and Differentiation. Optimize that page for those two layers, not for a category-explainer rehash.
74
+
75
+ ---
76
+
77
+ ## Discipline Gates
78
+
79
+ ### DISC-LANDING-PAGES-01: 5-Second Clarity Test -- Tier 1
80
+
81
+ **Checks:** Visitor can name the product category and core function from above-the-fold content alone
82
+ **Against:** Hero H1 + subhead + any above-the-fold visual
83
+
84
+ #### Evaluation Criteria
85
+
86
+ 1. **Category nameability**
87
+ - PASS: Reading only the H1 and subhead, a fresh reader could name the product category in plain language within 5 seconds (e.g., "scheduling software for dentists", "B2B payroll tool", "developer-focused logging service")
88
+ - WARN: The category is implied but requires reading a downstream section or interpreting a metaphor to identify
89
+ - FAIL: The hero uses category-novelty language ("AI-native ___ platform", "the future of ___", "next-generation ___") without a plain-language category anchor; a fresh reader cannot say what the product is
90
+
91
+ 2. **Plain-language floor**
92
+ - PASS: H1 contains zero invented category terms; vocabulary is drawn from how the ICP already describes the problem
93
+ - WARN: H1 mixes a plain-language clue with one piece of invented or aspirational language
94
+ - FAIL: H1 is built around invented category terms, abstract metaphors, or undefined adjective stacks
95
+
96
+ ### DISC-LANDING-PAGES-02: Relevance Signal in Hero -- Tier 1
97
+
98
+ **Checks:** The ICP role, use case, or pain is named above the fold so a visitor can self-identify
99
+ **Against:** Hero H1, subhead, and any eyebrow/strapline element
100
+
101
+ #### Evaluation Criteria
102
+
103
+ 1. **ICP / use-case naming**
104
+ - PASS: Above-the-fold copy explicitly names the ICP role ("for revenue ops leaders"), the use case ("for outbound email"), or the pain ("when your reports break every Monday") in the visitor's own vocabulary
105
+ - WARN: A relevance signal is present but generic ("for modern teams", "for growing businesses"); a visitor cannot tell whether they are the target
106
+ - FAIL: No relevance signal above the fold — the page reads as if written for "everyone" or "businesses"
107
+
108
+ 2. **Audience-vocabulary check**
109
+ - PASS: At least one phrase in the hero is verifiably pulled from customer interviews, sales calls, support tickets, or audience message tests
110
+ - WARN: The relevance phrasing is plausible but the writer cannot point to a source for it
111
+ - FAIL: The relevance phrasing is marketing-internal vocabulary the audience would not use about themselves
112
+
113
+ ### DISC-LANDING-PAGES-03: Value Stated as Outcome -- Tier 1
114
+
115
+ **Checks:** The benefit is expressed as an after-state outcome, not a feature list
116
+ **Against:** Hero H1 + subhead
117
+
118
+ #### Evaluation Criteria
119
+
120
+ 1. **Outcome vs feature framing**
121
+ - PASS: The value claim is an outcome a visitor can picture happening to them ("close books in 2 days", "ship landing pages in an afternoon", "stop losing leads to slow follow-up")
122
+ - WARN: The value claim is a capability that strongly implies an outcome but does not state it ("automated reconciliation", "AI-generated pages")
123
+ - FAIL: The hero lists features, technology categories, or product attributes with no outcome stated
124
+
125
+ 2. **Specificity of outcome**
126
+ - PASS: The outcome contains a number, a named time horizon, a named workflow, or a contrast against a current state
127
+ - WARN: The outcome is real but vague ("faster", "easier", "better"); no quantification or contrast
128
+ - FAIL: The outcome is empty ("transform your workflow", "unlock your potential", "do more with less")
129
+
130
+ ### DISC-LANDING-PAGES-04: Differentiation With a Named Alternative -- Tier 1
131
+
132
+ **Checks:** Differentiation copy names what is being beaten — a competitor, a workaround, or the status quo
133
+ **Against:** Hero subhead, eyebrow, or differentiator strapline; comparison section if present
134
+
135
+ #### Evaluation Criteria
136
+
137
+ 1. **Named alternative present**
138
+ - PASS: The page names the alternative explicitly — a competitor by name, a category of workaround ("spreadsheets", "manual reconciliation", "stitching together 5 tools"), or the visitor's current process
139
+ - WARN: Differentiation is implied via contrast language ("unlike legacy tools", "the only ___ that ___") without naming what "legacy" or "the rest" actually are
140
+ - FAIL: The page asserts uniqueness ("first", "only", "leading") with no named alternative and no contrast point
141
+
142
+ 2. **Differentiation respects the hierarchy**
143
+ - PASS: Differentiation copy appears only after clarity, relevance, and value land; visitors do not encounter "why us" claims before they know what the thing is
144
+ - WARN: Differentiation is mixed into the H1 in a way that crowds out clarity (e.g., the H1 is "The only ___ that ___" with no plain category name)
145
+ - FAIL: The hero leads with differentiation while clarity is still unresolved (category unnamed or ICP unnamed)
146
+
147
+ ### DISC-LANDING-PAGES-05: Above-the-Fold Carries All Four Layers -- Tier 1
148
+
149
+ **Checks:** Hero answers Clarity, Relevance, Value, and Differentiation before scroll
150
+ **Against:** Above-the-fold content (H1 + subhead + CTA + strapline + visible social proof)
151
+
152
+ #### Evaluation Criteria
153
+
154
+ 1. **Layer coverage**
155
+ - PASS: All four layers are addressed in above-the-fold copy — each layer answerable by pointing to a specific phrase or element
156
+ - WARN: Three of four layers are present; one layer is implied but not stated
157
+ - FAIL: Two or more layers are missing above the fold
158
+
159
+ 2. **Layer order on the page**
160
+ - PASS: Layers are arranged so a top-to-bottom read flows Clarity → Relevance → Value → Differentiation (or interleaves them within a single line in a way that preserves that resolution order)
161
+ - WARN: All layers present but the visual hierarchy buries Clarity beneath Differentiation or Value
162
+ - FAIL: The first thing the eye lands on is Differentiation or aspirational copy, with Clarity buried below the fold
163
+
164
+ ### DISC-LANDING-PAGES-06: Audience Research Provenance -- Tier 2
165
+
166
+ **Checks:** Hero copy is traceable to audience research, not authored from the writer's head
167
+ **Against:** Asset metadata / campaign notes for research sources
168
+
169
+ #### Evaluation Criteria
170
+
171
+ 1. **Research source named**
172
+ - PASS: The asset metadata references at least one audience research artifact (customer-interview transcript, sales-call recording, support-ticket sample, 5-second test result, Likert-scale message test, or review-site mining doc) used to inform the hero
173
+ - WARN: General "we talked to customers" attribution without a specific artifact
174
+ - FAIL: No audience research is referenced; copy is internal-vocabulary throughout
175
+
176
+ 2. **Layer-level scoring (if available)**
177
+ - PASS: Each of the four layers has a stated score or qualitative read from audience testing, and the lowest-scoring layer has been revised in this draft
178
+ - WARN: Layer scores exist but the lowest layer has not been addressed
179
+ - FAIL: No layer-level read on the page; the hierarchy has not been audience-tested at all
180
+
181
+ ---
182
+
183
+ ## Base Gate Overrides
184
+
185
+ None -- all base gates keep default tiers.
186
+
187
+ ---
188
+
189
+ ## Format Rules
190
+
191
+ - **H1 length:** 9 words or fewer. Longer H1s blur Clarity. If the H1 needs more than 9 words to land, split into an eyebrow/strapline + a shorter H1.
192
+ - **Subhead length:** 25 words or fewer. The subhead carries Relevance and (often) Value; longer than 25 words means the hierarchy is being explained instead of stated.
193
+ - **Primary CTA copy:** 4 words or fewer. Action verb first ("Start free trial", "Get a demo", "See pricing"). No "Click here" or "Submit." No marketing-speak ("Begin your journey").
194
+ - **Above-the-fold word count:** 150 words or fewer total across H1, subhead, CTA, eyebrow, strapline, and any visible body copy. More than 150 words means the page is explaining itself instead of orienting the visitor.
195
+ - **One H1 per page:** Multiple H1s confuse semantic hierarchy and dilute the Clarity layer.
196
+ - **Category named in plain language:** The product's category must appear, in plain language, somewhere in the H1 or subhead. No invented category names without a plain-language anchor.
197
+ - **Named alternative for differentiation:** Any "unlike", "instead of", "vs.", or "the only" phrasing must be paired with a specific named alternative in the same sentence or adjacent line.
198
+ - **Social proof visible above the fold:** Logo strip, customer count, named-customer quote, funded-by line, or specific number (e.g., "Used by 4,300 sales teams").
199
+
200
+ Operational page structure (section order beyond the hero, CTAs, schema markup, page-speed targets) is delegated to `references/landing-page-anatomy.md`.
201
+
202
+ ---
203
+
204
+ ## Examples
205
+
206
+ ### Good: Hero That Lands All Four Layers
207
+
208
+ ```
209
+ Eyebrow: For B2B sales teams running outbound on LinkedIn
210
+ H1: Stop losing 40% of replies to slow follow-up
211
+ Subhead: Auto-drafts personalized replies in your voice within 30 seconds of a
212
+ prospect responding — instead of waiting for your SDR to get to it next morning.
213
+ CTA: Start free trial
214
+ Proof: Used by 1,200 outbound teams · Trusted by Ramp, Notion, Linear
215
+ ```
216
+
217
+ Why it lands:
218
+ - **Clarity** — "auto-drafts personalized replies" names the category in plain language.
219
+ - **Relevance** — "B2B sales teams running outbound on LinkedIn" names the ICP and use case.
220
+ - **Value** — "Stop losing 40% of replies" is an outcome with a number and a current-state contrast.
221
+ - **Differentiation** — "within 30 seconds … instead of waiting for your SDR to get to it next morning" names the alternative (the human workflow) and the contrast.
222
+
223
+ ### Good: Use-Case Page Hero
224
+
225
+ ```
226
+ H1: Onboarding emails that adapt to what trial users actually do
227
+ Subhead: Behavior-triggered drip sequences for B2B SaaS trials — replacing the
228
+ generic Day 1 / Day 3 / Day 7 calendar drip that ignores user intent.
229
+ CTA: See it work
230
+ ```
231
+
232
+ Why it lands: category (behavior-triggered drip), ICP (B2B SaaS trials), outcome (emails that adapt to what users do), named alternative (calendar drip).
233
+
234
+ ### Bad: "Welcome to Our Platform"
235
+
236
+ ```
237
+ H1: Welcome to FlowCraft
238
+ Subhead: The AI-powered platform built for modern teams who want to do more with less.
239
+ CTA: Get Started
240
+ ```
241
+
242
+ Why it fails the hierarchy:
243
+ - **Clarity** — "FlowCraft" is a brand name, not a category. "AI-powered platform" is invented language. A 5-second viewer cannot say what the product does. **Fails DISC-LANDING-PAGES-01.**
244
+ - **Relevance** — "modern teams" identifies no one. Every visitor opts out by default. **Fails DISC-LANDING-PAGES-02.**
245
+ - **Value** — "do more with less" is the canonical empty outcome. **Fails DISC-LANDING-PAGES-03.**
246
+ - **Differentiation** — none. No alternative named. **Fails DISC-LANDING-PAGES-04.**
247
+
248
+ ### Bad: Differentiation-First Hero
249
+
250
+ ```
251
+ H1: The only platform you'll ever need.
252
+ Subhead: Built different. Powered by AI. Trusted by leaders.
253
+ ```
254
+
255
+ Why it fails: differentiation claims with no named alternative ("only", "different"), invented category language, no ICP, no outcome. Differentiation arrives before clarity exists, which inverts the hierarchy. **Fails DISC-LANDING-PAGES-04 and DISC-LANDING-PAGES-05.**
256
+
257
+ ---
258
+
259
+ ## Anti-Patterns
260
+
261
+ 1. **Clever-over-clear headlines.** Wordplay, metaphors, and aspirational language in the H1 ("Unleash your potential", "Welcome to the future of ___"). Clever costs Clarity, and Clarity is the floor.
262
+
263
+ 2. **Invented category language without a plain-language anchor.** "The AI-native workflow orchestration platform" with no follow-up sentence saying what it actually does. If your category is not yet a category your ICP would Google, you have not earned the right to lead with it.
264
+
265
+ 3. **No named alternative.** "Unlike legacy tools" with no named legacy tool. "The only ___" with no contrast point. Differentiation without a named opponent reads as a brag and tests as filler.
266
+
267
+ 4. **Hero is just a feature list.** Bullet points of capabilities under the H1 instead of an outcome. Features belong as evidence below the fold, after Value has been stated.
268
+
269
+ 5. **Differentiation before Clarity.** Pages that lead with "the only" or "vs." comparisons before the visitor knows what the product is. The hierarchy is strict — Differentiation is the fourth layer, not the first.
270
+
271
+ 6. **"For everyone."** Hero copy that does not name an ICP role, use case, or pain. The visitor's first job is to opt in or opt out; a hero that takes no stand makes every visitor opt out by default.
272
+
273
+ 7. **A/B testing buttons while the headline fails.** Color, copy permutations, and CTA microtweaks produce rounding-error lifts. If the hero fails on Clarity or Relevance, no button test matters.
274
+
275
+ 8. **Hidden pricing on a B2C / SMB / PLG product.** "Contact sales" gating on a product where the buyer expects to self-serve is a hierarchy violation at the page level — visitors cannot evaluate Value or Differentiation without numbers, and bounce.
276
+
277
+ 9. **Writing copy from inside the company.** Authoring the hero from the founder's vocabulary instead of the customer's. Always traceable: the page sounds smart and tests flat.
278
+
279
+ 10. **Stuffing all four layers into a single sentence.** The hierarchy is meant to be stated, not crammed. Six-clause H1s that try to do Clarity + Relevance + Value + Differentiation in one breath read as a wall and test worse than a clean H1 + subhead split.
280
+
281
+ ---
282
+
283
+ ## Metrics
284
+
285
+ Track these indicators for every landing page after shipping. Layer-level scores are the leading indicator; the engagement metrics below are the lagging confirmation.
286
+
287
+ - **5-second test pass rate** — Show the page for 5 seconds to 5+ ICP-matching viewers, hide it, ask "what does this do and who is it for?" Target: 4 of 5 correct. This is the Clarity layer's direct measurement.
288
+ - **Layer-level Likert scores (Wynter-style)** — Score each of the four layers on a 1–5 scale with target audience members. Target: 4+ on all four. Re-test after every hero revision; fix the lowest-scoring layer first.
289
+ - **Bounce rate (hero-driven)** — Visitors who land and leave without scrolling. High bounce on cold traffic to a landing page is almost always a Clarity or Relevance failure, not a "the page is too long" problem.
290
+ - **Scroll depth** — Median scroll percent and the fall-off curve. A cliff between hero and second section indicates the hero failed to set up the rest of the page. A cliff at the comparison section indicates Differentiation copy is not earning trust.
291
+ - **Hero-to-CTA click-through rate** — Visitors who click the primary CTA without scrolling past the hero. The cleanest measure of whether the hero alone is doing its job.
292
+ - **CTA conversion rate per traffic source** — Segment conversion by source (paid, organic, email, social). Wide variance signals message-source mismatch — the hero may land for one audience and miss another, which is a Relevance failure.
293
+ - **Page-level message-market fit (40% rule analog)** — Of visitors who reach the CTA, what percent say they "would be very disappointed" if the product disappeared. Borrowed from PMF; applied per landing-page audience segment.
294
+
295
+ ---
296
+
297
+ ## Sources
298
+
299
+ - [Wynter — The Messaging Hierarchy](https://wynter.com/post/messaging-hierarchy) — The four-layer model (Clarity → Relevance → Value → Differentiation) in its canonical form, with Likert-scale measurement methodology.
300
+ - [Sequel.io — Peep Laja CMO Series](https://sequel.io/cmo-series/peep-laja/) — Interview covering message-market fit, why testing messaging beats testing design, and the pricing page as the highest-leverage CRO target.
301
+ - [Peep Laja — "Messaging is like onions" (LinkedIn)](https://me.linkedin.com/posts/peeplaja_messaging-is-like-onions-it-has-layers-activity-6995731316755320832-d_Lz) — The hierarchy framed as layered onions; clarity is the outermost and unskippable.
302
+ - [Wynter](https://wynter.com/) — B2B message-testing platform Laja founded; methodology and audience-panel testing patterns referenced in DISC-LANDING-PAGES-06.
303
+ - [CXL Institute](https://cxl.com/) — Conversion training program Laja founded; broader CRO research grounding for "test the messaging, not the design."
304
+
305
+ For operational page structure (section order beyond the hero, schema markup, CTAs, page-speed targets, AEO/SEO signals), see `references/landing-page-anatomy.md`. That reference is the *what goes where* companion to this playbook's *what must be said in what order*.