sruthir28/top-down-memo
Answer-first writing using the Minto Pyramid Principle. Lead with the conclusion, then 2–4 MECE supporting arguments, then evidence under each. Use whenever you have a recommendation, finding, or assessment to communicate in writing — memos, emails to execs, Slack updates that need to land, briefing docs. Different from the Decision Memo Builder (which is a specific 1-page decision artifact); this is the general writing method.
npx skills add https://github.com/sruthir28/enterprise-ai-skills --skill top-down-memo
The McKinsey writing rule: lead with the answer. Chronological narratives ("first we did X, then Y, then Z, and concluded W") are how thinking happens, not how communication should land. Top-down inverts the order — conclusion first, then the structure that supports it, then the evidence.
This is also called BLUF (Bottom Line Up Front) in military writing and Minto Pyramid in consulting. Same idea. Different name.
The test: can the reader stop after the first paragraph and still know what you think and what you want? If yes, top-down. If they need to read to the end to find the answer, you wrote a story.
The way you *thought* about something is the opposite of how the reader needs to *hear* it.
| You (writer) | Reader |
|--------------|--------|
| Gathered data → found patterns → drew conclusion | Wants the conclusion → then patterns → then data only if they push back |
Chronological narrative is easier to write because it matches your discovery path. It's harder to read because the reader doesn't know where you're going. Reversing the order is unnatural but obviously correct.
[LEAD]
The answer.
One sentence.
│
┌──────────────┼──────────────┐
│ │ │
[ARG 1] [ARG 2] [ARG 3]
Because… Because… Because…
│ │ │
• evidence • evidence • evidence
• evidence • evidence • evidence
• evidence • evidence • evidence
The three arguments must jointly support the lead — if all three are true, the lead must be true. Cut anything that doesn't ladder up.
[LEAD — one sentence with the answer]
[OPTIONAL: 1 sentence on the ask or so-what if the lead is a finding]
ARGUMENT 1: [Headline claim that supports the lead]
• [Evidence: specific data, source]
• [Evidence: specific data, source]
• [Evidence: specific data, source]
ARGUMENT 2: [Headline claim]
• [Evidence]
• [Evidence]
• [Evidence]
ARGUMENT 3: [Headline claim]
• [Evidence]
• [Evidence]
• [Evidence]
[OPTIONAL: Risks or open questions — max 3 bullets]
[OPTIONAL: Background / context — only if reader genuinely lacks it]
LEAD: We should not acquire Vega Labs. Their tech is real but the cultural fit and price preclude a deal that creates value.
(If we want to revisit in 6 months at a 40% lower valuation and after their senior team has stabilized, the math could work — happy to set that revisit on the calendar.)
ARGUMENT 1: The price ($380M) is 2.4x what the asset is worth on a standalone basis.
ARGUMENT 2: 60% of their senior eng team is at <12-month vest cliff and is the actual asset.
ARGUMENT 3: The integration risk is concentrated in the part of our stack we cannot afford to break.
RISKS OF NOT ACQUIRING
(No background section needed — you've been in every Vega meeting since Jan.)
TL;DR: I think we should kill the Pro tier and merge everything into Team.
Three reasons:
1. Pro is <8% of revenue and 40% of pricing-page complexity (data in #pricing-experiments thread)
2. Every Pro customer we've talked to (n=14 in Q1) would happily move to Team at the same price
3. We're about to add 4 new add-ons that won't fit on a 3-tier page — collapsing now buys us room
Risk: ~30 legacy Pro accounts on a grandfathered price. Easy to migrate — I have the script.
Want to align before Friday's pricing review?
That's a top-down Slack message. Lead → reasons → risk → ask. ~120 words. The reader can stop after line 1 and still know what to do.
Take sruthir28/top-down-memo from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.