Skip to content

Commit f48002b

Browse files
author
nocoder26
committed
Ship 4 new skills + lead with Uri Levine
NEW SKILLS: - /pivot — Eric Ries's 10 pivot types, evidence-driven; forces explicit kill criteria for the previous hypothesis; logs to brain/pivots.md - /story — Uri Levine's narrative arc constructor (origin → why-you → journey → vision → ask); every claim cites a brain entry - /pitch — renders /story into a 10-slide deck; refuses fabricated TAM, vanity metrics, unsupported quotes; flags weak slides honestly - /pmf-check — triangulates Sean Ellis test + retention cohort + believer density; returns Strong PMF / PMF / Pre-PMF / PMF Mirage URI LEVINE PROMINENCE: - New hero callout: "An executable version of Uri Levine's Fall in Love with the Problem" - Methodology section now leads with Uri (more space than others) - Closing "With deep respect to Uri Levine" section before License OTHER: - Brain templates: pivots.md, story.md, metrics/, pitch/ - Updated CLAUDE.md to reflect 10 skills, grouped by purpose - Tests now cover all 10 skills (134/134 passing)
1 parent 1e95276 commit f48002b

12 files changed

Lines changed: 577 additions & 23 deletions

File tree

.claude/skills/pitch/SKILL.md

Lines changed: 126 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
---
2+
name: pitch
3+
description: Render brain/story.md into a 10-slide pitch deck where every claim cites a brain entry. Refuses to fabricate TAM, vanity metrics, or unsupported quotes. Flags weak slides honestly so the founder fixes them before any VC sees the deck.
4+
---
5+
6+
# /pitch
7+
8+
Read `brain/story.md` (must exist — run `/story` first if not). Read `brain/problem.md`, `brain/believers/index.md`, `brain/interviews/`, `brain/decisions.md`, `brain/runway.md`, `brain/metrics/` (if exists).
9+
10+
If `brain/story.md` is empty: refuse. *"No story captured. Run /story first — the deck is downstream."*
11+
12+
## The deck (10 slides, YC-style)
13+
14+
Every slide cites specific brain entries. **Every. Single. Slide.**
15+
16+
### Slide 1 — Title
17+
- Project name
18+
- One-line tagline (from `brain/story.md` "vision" condensed)
19+
- Founder name + handle
20+
21+
### Slide 2 — Problem
22+
- 1-3 sentences from `brain/problem.md`
23+
- ONE verbatim quote from a believer (cite interview file)
24+
- **DO NOT** include "X% of Y have this problem" stats unless `brain/evidence/` supports it
25+
26+
### Slide 3 — Customer
27+
- Segment from `brain/believers/index.md` (top concentration)
28+
- Believer profile: pain, behavior, willingness to pay
29+
- Cite N believers identified
30+
31+
### Slide 4 — Solution
32+
- **Only** what's been validated
33+
- For each feature: which believer asked for it (cite interview file)
34+
- Unbuilt features marked "v1.5 (planned)" — don't pretend they exist
35+
36+
### Slide 5 — Traction
37+
- Real numbers from `brain/metrics/` and `brain/believers/`
38+
- Sean Ellis % if measured (from `/pmf-check`)
39+
- Retention curve if measured
40+
- **DO NOT** include vanity metrics (downloads, signups, MAU without retention)
41+
- If traction is thin: write *"Pre-traction. N believers identified, MVP launching wk Y."* — admit it openly
42+
43+
### Slide 6 — Why now
44+
- Founder fills. Claude prompt: *"What changed in the world that makes this possible/needed now? Be specific. Don't say 'AI is hot.'"*
45+
- If founder can't answer, mark slide WEAK in the assessment
46+
47+
### Slide 7 — Team
48+
- Founder fills. Highlight founder-market fit from `brain/why.md`
49+
- Co-founders: name, role, why-them
50+
51+
### Slide 8 — Business model
52+
- Pricing from `brain/decisions.md` if logged
53+
- Unit economics if `/default-alive` has been run (cite `brain/runway.md`)
54+
- If untested: mark *"Hypothesis — not yet validated."*
55+
56+
### Slide 9 — Vision
57+
- 1-3 sentences from `brain/story.md` "vision"
58+
- The changed world if this works at scale
59+
60+
### Slide 10 — Ask
61+
- From `brain/story.md` "ask"
62+
- Calibrated to `brain/runway.md`
63+
- Specific number, specific milestone
64+
65+
## Output: brain/pitch/deck.md
66+
67+
Markdown format renderable into Keynote / Pitch.com / Slidev / Marp.
68+
69+
For each slide, include a `## Citations` block listing the brain entries used.
70+
71+
```markdown
72+
# <Project name>
73+
74+
## Slide 1: Title
75+
<...>
76+
77+
### Citations
78+
- brain/story.md "vision"
79+
80+
---
81+
82+
## Slide 2: Problem
83+
<...>
84+
85+
> "<verbatim quote from believer>"
86+
> — <Name>, interview #<N>
87+
88+
### Citations
89+
- brain/problem.md (current hypothesis)
90+
- brain/interviews/00X-<name>.md
91+
92+
---
93+
[...]
94+
```
95+
96+
## Honest deck assessment (mandatory after rendering)
97+
98+
Surface weak slides explicitly. The founder needs to see the gaps before a VC does:
99+
100+
```
101+
DECK ASSESSMENT:
102+
✅ Slide 2 (Problem): strong — 3 verbatim quotes, specific segment
103+
✅ Slide 4 (Solution): strong — every feature cites a believer
104+
⚠️ Slide 5 (Traction): WEAK — only 12 believers, no retention data
105+
⚠️ Slide 6 (Why now): WEAK — founder didn't fill in, currently generic
106+
✅ Slide 8 (Business): adequate
107+
❌ Slide 9 (Vision): generic — needs work before sending
108+
109+
VCs will probe slides 5, 6, 9. Address these before any pitch meeting.
110+
```
111+
112+
## Hard refusals
113+
114+
- **Refuses** to write TAM if `brain/evidence/` doesn't support it. Will write *"TAM unknown — to be sized"* instead.
115+
- **Refuses** to write *"we are growing N% MoM"* without retention data in `brain/metrics/`.
116+
- **Refuses** to fabricate quotes. Period.
117+
- **Refuses** to write *"the market is $X billion"* without a cited source.
118+
- **Refuses** to call something a "platform" if `brain/decisions.md` doesn't show platform decisions.
119+
120+
## Why this exists
121+
122+
Most pitch decks are full of made-up numbers and unsupported claims. VCs detect this in 30 seconds. **The deck where every claim has a citation is rare and credible.**
123+
124+
Uri Levine: *"You're not pitching the deck. You're pitching the story behind the deck."*
125+
126+
This skill makes the deck a faithful render of the story — your story, your evidence, your receipts. When a VC asks *"how did you arrive at this number?"* you have the citation ready.

.claude/skills/pivot/SKILL.md

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
name: pivot
3+
description: Walk through Eric Ries's 10 pivot types using brain evidence to inform direction. Forces explicit kill criteria for the previous hypothesis before allowing a pivot. Logs to brain/pivots.md with full reasoning.
4+
---
5+
6+
# /pivot
7+
8+
Read `brain/problem.md`, `brain/believers/index.md`, `brain/interviews/`, `brain/decisions.md`, `brain/pivots.md` (if exists). Run `query_evidence()` for relevant signals.
9+
10+
## When to invoke
11+
12+
Founder is considering changing direction. Triggers:
13+
- Believer density <30% after 5+ interviews
14+
- Retention curve approaching zero
15+
- Multiple "this isn't quite my problem" signals
16+
- Founder explicitly says *"I'm thinking about pivoting"*
17+
18+
## Step 1 — Surface what's actually wrong
19+
20+
Before naming a pivot type, name the failure. Read brain/ and ask:
21+
- What did the original hypothesis predict?
22+
- What did the evidence show?
23+
- Where exactly did they diverge?
24+
25+
If the founder hasn't done a `/problem` refresh recently, suggest it before pivoting. Often the "pivot" is just a refinement.
26+
27+
## Step 2 — Walk through Ries's 10 pivot types
28+
29+
For each, ask: *"Does this match what your evidence is telling you?"* Cite brain entries as you go.
30+
31+
1. **Zoom-in pivot** — A single feature becomes the whole product.
32+
*Evidence pattern: users love ONE thing, ignore the rest.*
33+
2. **Zoom-out pivot** — The whole product becomes a single feature of something larger.
34+
*Evidence pattern: users want it as part of an existing workflow, not standalone.*
35+
3. **Customer segment pivot** — Same product/problem, different customer.
36+
*Evidence: wrong people responding well to right solution.*
37+
4. **Customer need pivot** — Same customer, different problem.
38+
*Evidence: customer engaged but not on the pain you targeted.*
39+
5. **Platform pivot** — Application ↔ platform.
40+
*Evidence: developers want APIs, or customers want a turnkey app.*
41+
6. **Business architecture pivot** — B2B ↔ B2C, or high-margin/low-volume ↔ low-margin/high-volume.
42+
*Evidence: monetization model mismatch with how the segment buys.*
43+
7. **Value capture pivot** — Different monetization model.
44+
*Evidence: willingness-to-pay exists but not for the model you priced.*
45+
8. **Engine of growth pivot** — Sticky / viral / paid (Ries's three engines).
46+
*Evidence: growth working through a different mechanism than designed for.*
47+
9. **Channel pivot** — Same product, different distribution.
48+
*Evidence: customers prefer to buy/discover differently than you offer.*
49+
10. **Technology pivot** — Same customer/problem, different tech.
50+
*Evidence: you can deliver the same value cheaper/faster/better with new tech.*
51+
52+
## Step 3 — Kill criteria for the OLD hypothesis (non-negotiable)
53+
54+
Before any pivot, force the founder to write down:
55+
- What was the original hypothesis?
56+
- What evidence proved it wrong (cite specific interview / metrics)?
57+
- Why are we sure it's wrong, not just early?
58+
59+
Pivots without explicit kill criteria are noise. **Refuse to log the pivot until these are written down.**
60+
61+
## Step 4 — New hypothesis with falsification
62+
63+
The pivot is a NEW hypothesis. It needs:
64+
- Specific customer segment
65+
- Specific pain
66+
- Falsification criteria (what would prove THIS wrong)
67+
68+
Run `/problem` on the new hypothesis. **Don't auto-overwrite the old one** — preserve history. Old `problem.md` becomes part of the pivot log.
69+
70+
## Step 5 — Log to brain/pivots.md
71+
72+
Append:
73+
74+
```markdown
75+
## <date> — <pivot type>: <one-liner>
76+
77+
### Old hypothesis (killed)
78+
<copy of brain/problem.md before pivot>
79+
80+
### Kill criteria met
81+
- <specific evidence — interview ref, metric, quote>
82+
- <...>
83+
84+
### Pivot type (Ries)
85+
<one of 10>
86+
87+
### New hypothesis
88+
<see brain/problem.md as of this date>
89+
90+
### What carries over
91+
- Believers willing to follow: <names>
92+
- Evidence still relevant: <ref>
93+
94+
### What we lose
95+
- <ref>
96+
97+
### Reasoning
98+
<one paragraph — what we learned, what we believe now, what we'll watch>
99+
```
100+
101+
## Anti-pattern to call out
102+
103+
If founder wants to pivot every 2 weeks: this is thrash, not pivoting. Surface `brain/pivots.md` history. *"You've pivoted twice in 8 weeks. The problem is probably not the hypothesis — it's that you're not running long enough experiments to learn from any of them. Either let this one run another 4 weeks, or admit it's not the hypothesis you're rejecting — it's the discomfort of a hypothesis without quick wins."*
104+
105+
## Why this exists
106+
107+
Eric Ries: *"A pivot is a structured course correction designed to test a new fundamental hypothesis about the product, strategy, and engine of growth."*
108+
109+
Most founders pivot in panic. This skill makes pivots **structured, evidence-driven, and historical** — the brain remembers every old hypothesis and why it was killed. Future-you reads pivots.md and sees the trail of validated learning, not just the latest narrative.
110+
111+
Uri Levine: *"It's only a pivot if you can articulate what was wrong. Otherwise it's a fresh start, which is fine — just call it that."*

.claude/skills/pmf-check/SKILL.md

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
---
2+
name: pmf-check
3+
description: Triangulate Product-Market Fit signal from three independent sources — Sean Ellis test, retention cohorts, believer density. Returns Strong PMF / PMF / Pre-PMF / PMF Mirage. The triangulation is what's hard to fake.
4+
---
5+
6+
# /pmf-check
7+
8+
Read `brain/believers/index.md`, `brain/interviews/`, `brain/metrics/` (if exists), `brain/runway.md`. Use `believer_density()` from the brain MCP.
9+
10+
PMF is **not one number**. It's three signals that have to align. Any single signal alone is gameable. The triangulation is what's hard to fake.
11+
12+
## Three signals
13+
14+
### Signal 1 — Sean Ellis test (the survey)
15+
16+
Ask **all current users** (not cherry-picked):
17+
> *"How would you feel if you could no longer use this product?"*
18+
19+
Options:
20+
- Very disappointed
21+
- Somewhat disappointed
22+
- Not disappointed
23+
- N/A — I no longer use it
24+
25+
**Threshold: ≥40% "very disappointed" = PMF signal.**
26+
27+
If founder hasn't run this:
28+
- Generate the survey form (Google Form / Typeform / Tally — the questions, not the platform)
29+
- Tell them to send to all active users (not just believers)
30+
- Aim for 30+ responses minimum
31+
32+
If founder has results, capture in `brain/metrics/sean-ellis.md`:
33+
34+
```markdown
35+
# Sean Ellis Test
36+
37+
Captured: <date>
38+
Sample size: <N responses>
39+
Sent to: <user pool description — must be ALL users, not selected>
40+
41+
## Results
42+
- Very disappointed: X% (N=...)
43+
- Somewhat disappointed: Y% (N=...)
44+
- Not disappointed: Z% (N=...)
45+
- N/A: ...% (N=...)
46+
47+
## Verdict
48+
<PASS (≥40%) / WEAK (25-39%) / FAIL (<25%)>
49+
```
50+
51+
### Signal 2 — Retention cohort
52+
53+
Day 7, 30, 90 retention curves. **The shape matters more than the number.**
54+
55+
- **Flat at zero** → no PMF. Users churn completely.
56+
- **Curve that flattens above zero** → PMF signal. Some core group keeps using it.
57+
- **Rising curve** → exceptional, rare. (Network effects working.)
58+
59+
Calculate from product analytics. If founder doesn't have this set up:
60+
- Ask for raw data (CSV: `user_id, signup_date, last_active_date`, plus weekly active flags if available)
61+
- Compute cohort retention manually (Day 1, 7, 14, 30, 60, 90)
62+
- Output to `brain/metrics/retention-cohorts.md`
63+
64+
Verdict: **PASS** (curve flattens >0%), **WEAK** (asymptote near zero), **FAIL** (everyone gone by Day 30).
65+
66+
### Signal 3 — Believer density (from /believers)
67+
68+
Run `/believers` if not recently run. Use `believer_density()` from brain MCP.
69+
70+
- **<15%** → PMF mirage (most users are tire-kickers)
71+
- **15–30%** → weak; refine targeting
72+
- **30–50%** → healthy
73+
- **≥50%** → strong, focused niche
74+
75+
Verdict: **PASS** (≥30%), **WEAK** (15-29%), **FAIL** (<15%).
76+
77+
## Triangulation
78+
79+
Mark each signal:
80+
81+
```
82+
| Threshold | Actual | Verdict
83+
--------------|------------------|----------|--------
84+
Sean Ellis | ≥40% | __% | ____
85+
Retention | curve flattens | ____ | ____
86+
Believer dens | ≥30% | __% | ____
87+
```
88+
89+
## Final verdicts
90+
91+
- **3 of 3 PASS → STRONG PMF.** Stage 2 → 3 gate met. Time to scale. Run `/default-alive` and `/story`; raise if needed.
92+
- **2 of 3 PASS → PMF.** Real signal but specific weakness. Fix the FAIL before scaling.
93+
- **1 of 3 PASS → Pre-PMF.** Early. Keep iterating in Stage 2. Don't scale yet.
94+
- **0 PASS, or only believer density passes → PMF MIRAGE.** Most dangerous state. Feels like PMF but isn't. Vanity metric pattern. Re-target or refine hypothesis.
95+
96+
## Output: brain/metrics/pmf-check.md
97+
98+
```markdown
99+
# PMF check
100+
101+
Captured: <date>
102+
103+
## Sean Ellis
104+
<copy of brain/metrics/sean-ellis.md results>
105+
Verdict: ___
106+
107+
## Retention
108+
<cohort table>
109+
Verdict: ___
110+
111+
## Believer density
112+
<from believer_density()>
113+
Verdict: ___
114+
115+
## Triangulation
116+
<2 of 3 / 3 of 3 / etc.>
117+
**Final: <Strong PMF / PMF / Pre-PMF / PMF Mirage>**
118+
119+
## Action
120+
<one of: scale / address weakness X / iterate / re-target>
121+
```
122+
123+
## Anti-patterns to call out
124+
125+
- **"I have 1000 signups" alone is not PMF***"Users without retention is acquisition, not PMF."*
126+
- **Sean Ellis from cherry-picked users***"Must be ALL active users, not selected ones. Otherwise the bias makes it noise."*
127+
- **Founder claims PMF before this skill runs***"PMF is the triangulation, not the vibe. Run the three checks."*
128+
- **One signal screaming, two silent***"That's a vanity metric, not PMF. The triangulation is the safeguard."*
129+
130+
## Why this exists
131+
132+
- Eric Ries: *"Vanity metrics make you feel good, actionable metrics tell you the truth."*
133+
- Sean Ellis (the test's author): *"Until you hit 40%, scaling acquisition is multiplying churn."*
134+
- Uri Levine: *"Most founders think they have PMF when they have one happy customer per fifty. PMF is when most users would be heartbroken if you shut down — not when one user said something nice."*
135+
136+
This skill is the reality check before the scaling decision.
137+
138+
After `/pmf-check` returns Strong PMF: stage gate to 3 unlocks. Run `/default-alive` next to check whether you can fund the scale-up.

0 commit comments

Comments
 (0)