Case Studies

A Verdigris case study is the proof artifact for a single customer engagement. It carries one anchor metric, one named operator’s voice, and one closing invitation for the reader to replicate the work in their own facility. The Notion Sales Collateral Cheat Sheet lists four published case studies (Rectifier, Cooling Tower, Fortune 50 Telecom CapEx, Fortune 50 Telecom LL97) — all pre-cell, eligible for refresh under this spec.

This cell is single-genre. Unlike slides (4 genres), one-pagers (2 genres), or whitepapers (3 genres), case studies have one rhetorical structure that consistently lands across audiences. Fragmenting into multiple genres would underspecify each variant; the single-genre framing keeps the discipline tight.

The case study is dual-target

Every case study renders to two targets, both required:

  1. Web canonicalverdigris.co/resources/case-studies/{slug}. The version a prospect lands on from search, from the website nav, or from a sales link. Interactive elements (live charts, embedded video) live here.
  2. PDF mirror — committed alongside examples/{slug}.html, distributed via Drive (/Verdigris/Collateral/case-study/{slug}/), attached to outbound emails. Static rendering of the same content.

The web is canonical for content; the PDF is canonical for distribution as an attachment. The PDF mirror MAY drop interactive elements but MUST NOT add or modify content claims. The composition.persuade-case-study.web-pdf-parity rule enforces this — divergence between the two is a real failure mode (a case study with one anchor metric on the web and a different one in the PDF erodes credibility on first comparison).

Required structure (single genre)

Case studies have six required sections, in this order:

  1. Header — eyebrow + headline + deck + byline (customer name, segment, engagement window)
  2. Executive summary — one paragraph in a teal-rule callout box; the entire case in 4-6 sentences. A reader who reads ONLY the executive summary should grasp the engagement, the outcome, and the relevance.
  3. Problem — what the customer needed to solve, in their language and at their scale. Specific to this customer; never generic (“data-center reliability is hard”).
  4. Approach — what Verdigris did in this engagement. Specific actions, specific decisions, specific instrumentation. Avoids “best practices” framing — a case study is one execution, not a methodology lecture.
  5. Outcome — section anchored by the single bolded anchor metric. Surrounding prose carries secondary observations; secondary observations are NEVER bolded as competing metrics.
  6. Quote — named operator voice; required attribution including organization (or explicit redaction).
  7. Replicate — closing CTA inviting the reader to do this in their own facility. Dark-banded, action-oriented (mirrors the one-pager CTA strip pattern).

(Quote technically sits inside or after Outcome; the six “required sections” frame is Executive summary, Problem, Approach, Outcome, Quote, Replicate per the rule block.)

Decision framework: where to land in the bounds

Boundary Floor (small) Default Ceiling (large)
Executive summary length (4-6 sentences) 4 sentences when the engagement reduces cleanly to problem + approach + outcome + invitation, and the customer is named (the named-customer signal does work the prose otherwise has to do). 5 sentences for a typical case study: problem, scale, approach, outcome with anchor metric, replication invitation. 6 sentences when the customer is redacted (the redaction removes one trust signal that prose now has to recover) or the engagement spans a regulatory + operational outcome that needs both surfaced. Above 6 the executive summary stops being scannable and the rest of the case study becomes redundant.
Anchor metric (1, fixed) One bolded outcome metric per case study. Floor and ceiling are the same — this is the load-bearing rule. Two competing bolded metrics dilute the proof. Pick the number that defines the engagement; let the others support in surrounding prose. See the section below for the full discipline.    

If you cannot reduce the engagement to one bolded anchor and a 4-6 sentence summary, the artifact may need to be a brief or a short whitepaper rather than a case study. Case studies that try to cover two engagements at once consistently land as marketing rather than evidence.

The anchor metric

One bolded outcome metric per case study. This is the load-bearing rule.

A case study that presents two competing bolded metrics (“$1.3M-$3M recovered AND 21 days advance warning AND 800+ rectifiers monitored”) dilutes the proof — the reader scanning the page sees three numbers competing for attention and the win loses its definition. Pick the one number that defines the engagement; let the others support in surrounding prose.

Examples of legitimate single anchors (illustrative; numbers should be re-verified against the canonical EVD atom set in the consuming repo before any production case study ships):

Per-instance qualifiers (“per facility”, “per rack”, “per circuit”) are silent metric multipliers and require explicit context. A $3M per facility anchor without stating fleet size N silently multiplies the canonical claim by an unknown N. See LEARNINGS.md for the per-instance qualifier discipline (Z2O-1310 in the consuming verdigris repo).

Template vs. produced

Case studies are the highest-stakes surface for the rendering-layer-never-invents-facts principle: a fabricated quote, a guessed customer name, or a plausible-sounding metric ships as evidence and erodes trust on first comparison. The template-vs-produced contract is concrete here.

Slot Template stage Produced stage
Customer name (header byline) <span class="vd-template">[FIELD: customer name OR redaction, e.g. "Fortune 50 Telecom"]</span> Fortune 50 Telecom
Anchor metric <span class="vd-template">[FIELD: single bolded outcome, source-cited, e.g. "$1.3M-$3M"]</span> with caption <span class="vd-template">[FIELD: scope window, e.g. "CapEx deferral over a 3-year horizon"]</span> $1.3M-$3M with caption CapEx deferral over a 3-year horizon
Quote "<span class="vd-template">[FIELD: verbatim quote, e.g. "Verdigris flagged the failure 14 days before our maintenance window."]</span>" — <span class="vd-template">[FIELD: name OR role, e.g. "VP of Operations"]</span>, <span class="vd-template">[FIELD: organization OR explicit redaction]</span> "Verdigris flagged the failure 14 days before our maintenance window." — VP of Operations, Fortune 50 Telecom

The template stage is what an agent generates from the spec; the produced stage is what a human (or evidence-grounded agent) fills in. Never ship the produced stage without source evidence for every filled placeholder — quotes require a recorded interview or written attribution; anchor metrics require an EVD canonical claim ID; customer names require co-marketing approval (or explicit redaction). A case study with a plausible-sounding placeholder still in production form is the failure mode the dual-target parity rule cannot catch — only the hand-off note can.

Quote attribution

Every customer quote requires:

  1. Named individual OR explicit role label. “Mark Chu, VP of Operations” or “VP of Operations, Fortune 50 Telecom”. Never “the customer told us.”
  2. Organization name OR explicit redaction. “Fortune 50 Telecom” / “Hyperscale colocation customer” / “named operator” all acceptable when the customer has not granted public attribution.

A quote attributed only to the company (“Per Acme Corp”) without a human voice fails the trust register: the case study reads as marketing rather than evidence. Quotes attributed to “anonymous customer” are similarly weak — the redaction is fine, the absence of a role label is not.

Voice recipe

Uses the existing case_study recipe in voice/recipes.yaml:

The recipe was audited 2026-05-02 against the new Mark Chung and Jon Chu profile YAMLs and held up — neither founder voice belongs as primary in a case study because the customer is the protagonist, not Verdigris.

Voice at a glance

A producer reading this cell should be able to answer “what voice mix am I writing in?” without leaving the page. Pulled directly from the case_study recipe and the linked profile YAMLs.

Seren — primary (Profile: voice/team/seren-coskun.yaml). The customer’s voice is the primary voice in a case study; Seren’s people-intelligence translation makes the customer voice land authentically rather than as scrubbed marketing speak. She names what is positive before what is missing and frames opinions as perspectives, which is how a real operator describes a vendor’s work.

“From my perspective”

Carries: executive summary, problem, outcome prose around the anchor metric, quote framing. The body register throughout.

Mike — supporting (Profile: voice/team/mike-mahedy.yaml). Field credibility and competitor-comparison context. Mike knows what the customer was comparing Verdigris against because he was at the same conferences, looking at the same vendor product pages.

“Interesting that it doesn’t talk about…”

Carries: approach section, the technical specifics that establish “we did this work, not just described it.”

Jimit — accent (Profile: voice/team/jimit-shah.yaml). Market-trend connection — why this win matters beyond one customer. Jimit’s outside-in voice connects the customer outcome to the broader category shift, which makes the case study feel strategic rather than anecdotal.

“Hot new update from Semianalysis…”

Carries: the closing prose around Replicate that gestures past this one engagement. Used sparingly.

Citation discipline

Inherits citation conventions from categories/whitepapers/cover.md:

Charts and figures use the .vd-figure pattern from cover.css (figure + caption with label + credit line). Uncredited proprietary charts fail the trust register — every chart cites its data source.

Confidentiality

Case studies default to PUBLIC tier. Customer-redacted variants (“Fortune 50 Telecom” / “Hyperscale colocation customer”) are still PUBLIC — the redaction is content discipline, not a confidentiality tier. A case study that needs to be CUSTOMER-CONFIDENTIAL is probably a brief or an internal team retrospective, not a case study.

Spacing and typography

All values from tokens/spacing/print.json (frame primitives) and build/print/case-study.css. Case studies use the same paper-page frame as whitepaper inside-pages: 0.95-1.0in margins, Inter 11pt body, 1.6 line-height, 6.6in max content width.

Slot Font Size Weight Color
Eyebrow Lato 9pt 700 --vd-muted (uppercase, 0.16em letterspacing)
Headline Lato 30pt 700 --vd-ink, one accent in teal
Deck Inter 13pt 400 --vd-muted
Section eyebrow Lato 9pt 700 --vd-muted (with --vd-teal section number)
Section title (h2) Lato 18pt 700 --vd-ink
Body Inter 11pt 400 --vd-ink
Executive summary body Inter 12pt 400 --vd-ink (in teal-rule callout)
Anchor metric Lato 56pt 700 --vd-teal
Quote Lato 17pt 400 --vd-ink
Quote attribution Inter 10.5pt 400 --vd-muted (name in 600/--vd-ink)
Replicate CTA headline Lato 18pt 700 rgba(255,255,255,0.96) on dark band
Page footer Inter 9pt 400 --vd-muted

Why fixed point sizes (not ranges)

Print artifacts assume a constant reading distance — roughly 18 inches for a printed case study held at a desk or pulled out of a folder. Fixed point sizes lock the visual hierarchy at that distance: every printed copy and every downloaded PDF renders identically, including the 56pt anchor metric that has to land the same way for every reader. The slide cells use ranges (32-44pt headlines, 18-22pt deck) because projection distance varies — a boardroom monitor at 8 feet versus an auditorium screen at 30 feet calls for different sizes, calibrated per venue. Don’t borrow the slide-cell range pattern back into case studies; the read-distance assumption is fixed, and the dual-target web/PDF parity rule depends on the typography scale staying constant across both renderings.

Reference exemplars

Existing case study Anchor metric Status
Rectifier 14+ days advance warning on rectifier-class faults Pre-cell; first refresh target
Cooling Tower Specific KW/CO2 reduction (TBD on refresh) Pre-cell; second refresh target
Fortune 50 Telecom — CapEx $1.3M-$3M deferred over 3 years Pre-cell; canonical for redacted-customer pattern
Fortune 50 Telecom — LL97 19% HVAC energy reduction, zero LL97 penalties Pre-cell; canonical for compliance-outcome pattern

The first refresh under this cell should be Rectifier — its anchor metric is specific, its customer is willing to be named in some channels, and its problem-approach-outcome arc is the cleanest of the four for testing the spec.

What this cell does NOT cover

Why this guide exists

Verdigris has four published case studies and at least two more in flight. The published four don’t share a structural template — anchor-metric placement varies, quote attribution varies, executive-summary discipline varies. Codifying the single genre and the dual-target render makes refresh and net-new case studies a template-fill, not a blank-page redesign.

The single anchor metric rule resolves a specific pre-existing tension: the homepage and platform pages already have a “per-facility / per-rack” qualifier risk that PR #281 surfaced (see Z2O-1310). Case studies are the highest-risk surface for that failure mode because the bolded outcome is what the reader takes away. Forcing the single-anchor discipline at the rule level catches the multiplier risk before it ships.

The web/PDF parity rule reflects how case studies actually circulate: a prospect lands on the web canonical, downloads the PDF for forwarding, and the two artifacts diverge over time as edits land in one but not the other. Codifying parity as a rule (not just a process) makes divergence visible in evaluator runs.

See also