You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: resolve inconsistencies in validation-first flow
Follow-up to #2: align phase counts (8 numbered phases + pre-flight +
customer discovery), fix Phase 0.5 saving files before the project
directory exists, close the 3/5 interview gate threshold gap, align
Fast Track interview minimums (5 full / 3 fast) between SKILL.md and
customer-interview.md, restore the 'Field definitions' header in
output-guidelines.md, and make the interview gate explicitly deferrable
with stated consequences (Stage A financials, dashboard note, playbook
experiment #1) so the one-afternoon flow stays intact.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: startup-design/SKILL.md
+12-7Lines changed: 12 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,15 +9,15 @@ A structured, multi-phase skill that takes a startup idea from raw concept to va
9
9
10
10
## How It Works
11
11
12
-
The process has 9 phases executed sequentially (plus a Pre-Flight Check). Each phase produces output files and updates the progress tracker. If a session is interrupted, resume from the last completed checkpoint.
12
+
The process has 8 numbered phases executed sequentially, plus a Pre-Flight Check (Phase 0.5) and a Customer Discovery gate (Phase 3.7). Each phase produces output files and updates the progress tracker. If a session is interrupted, resume from the last completed checkpoint.
**Full Mode (default):** Execute all 8 phases in order. Best for thoroughly designing a startup from scratch.
20
+
**Full Mode (default):** Execute all phases in order, including Pre-Flight and Customer Discovery. Best for thoroughly designing a startup from scratch.
21
21
22
22
**Fast Track Mode:** When the user says they want a "quick validation," "rapid assessment," or similar, or when time/budget is clearly limited, run a compressed version:
@@ -74,7 +74,7 @@ Before investing time in the full process, run a fast sanity check — 2-3 targe
74
74
→ Ready to proceed to intake. The above is context, not a verdict.
75
75
```
76
76
77
-
Keep it brief. This is a heads-up, not a full analysis. Save findings to `{project-name}/00-intake/preflight.md`and update PROGRESS.md.
77
+
Keep it brief. This is a heads-up, not a full analysis. The project directory and PROGRESS.md don't exist yet at this point — present the findings in the conversation, then save them to `{project-name}/00-intake/preflight.md`during the Phase 1 output step, once the project directory is created.
78
78
79
79
---
80
80
@@ -138,7 +138,7 @@ Don't skip these — they set the tone for the entire process and signal that th
138
138
139
139
Save the consolidated intake to `{project-name}/00-intake/brief.md` with all captured information organized clearly. The project name should be derived from the startup idea (kebab-case, e.g., `pet-health-tracker`).
140
140
141
-
Create `PROGRESS.md` at the project root with: project name, start date, language, a checklist of all 8 phases (mark Phase 1 complete), and a Notes section for session state.
141
+
Create `PROGRESS.md` at the project root with: project name, start date, language, a checklist of all phases including Pre-Flight (0.5) and Customer Discovery (3.7) — mark Pre-Flight and Phase 1 complete — and a Notes section for session state. Also save the Pre-Flight findings from Phase 0.5 to `00-intake/preflight.md` now that the directory exists.
142
142
143
143
---
144
144
@@ -309,15 +309,20 @@ Ask the founder: "Based on this, do you want to continue to full strategy, pivot
309
309
310
310
## Phase 3.7: Customer Discovery (Interviews)
311
311
312
-
Research tells you what the market looks like from the outside. Customer interviews tell you what the problem feels like from the inside. **Do not skip this phase** — it is the single highest-signal validation step in the entire process and takes only 1-2 weeks in practice.
312
+
Research tells you what the market looks like from the outside. Customer interviews tell you what the problem feels like from the inside. This is the single highest-signal validation step in the entire process — and the only one that requires real calendar time (typically 1-2 weeks).
313
313
314
314
> **Reference:** Read `references/customer-interview.md` for the full interview protocol, question structure, notes template, and synthesis guide.
315
315
316
316
### When to run this phase
317
317
318
318
Run this phase after the Research Gate green- or yellow-lights the idea. If the gate returned a red light and the founder chose to stop, skip this phase.
319
319
320
-
**Exception — Fast Track Mode:** If the founder reported 5+ prior customer conversations in intake, document those conversations using the interview template and proceed. Flag all claims as `[Founder-reported]`. If fewer than 5 conversations happened, recommend running the full protocol.
320
+
Because interviews interrupt the session flow, present the founder with an explicit choice:
321
+
322
+
-**Run interviews now (recommended)** — pause here, conduct the interviews over the coming days, and resume from this checkpoint (PROGRESS.md preserves the state).
323
+
-**Defer and continue** — proceed to Strategy on research data alone. State the consequences plainly: financial projections stay Stage A (assumption-based), the Final Assessment Dashboard will show "Customer Interviews: 0 conducted · deferred", and interviews become the #1 experiment in the Phase 8 validation playbook. A strategy built without customer contact is a hypothesis, not a validated direction — say this honestly, then respect the founder's decision without nagging.
324
+
325
+
**Exception — Fast Track Mode:** If the founder reported 5+ prior customer conversations in intake, document those conversations using the interview template and proceed. Flag all claims as `[Founder-reported]`. If fewer than 5 conversations happened, recommend running fresh interviews — minimum 5 in Full Mode, minimum 3 in Fast Track.
321
326
322
327
### Process
323
328
@@ -336,7 +341,7 @@ After synthesis, present a brief finding to the founder and apply this gate:
336
341
- Problem language is consistent across interviews
337
342
338
343
**Pause and reassess if:**
339
-
-Fewer than 3 confirm the problem
344
+
-3 or fewer of 5 confirm the problem (scale proportionally if more interviews were run)
340
345
- Everyone says "interesting" but no behavior signals exist
341
346
- The problem they describe doesn't match the proposed solution
Copy file name to clipboardExpand all lines: startup-design/references/customer-interview.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -141,7 +141,7 @@ Save each interview summary to `{project-name}/00-intake/interviews/interview-{N
141
141
After 5+ interviews, look for patterns in `{project-name}/00-intake/interview-synthesis.md`:
142
142
143
143
**Problem validation:**
144
-
- Do at least 3/5 interviewees describe the same core problem unprompted?
144
+
- Do at least 4 of 5 interviewees describe the same core problem unprompted? (the Interview Gate threshold)
145
145
- Do they use similar language to describe it?
146
146
- Is the pain acute (happens often, costs time/money/stress) or mild (annoying but ignorable)?
147
147
@@ -154,7 +154,7 @@ After 5+ interviews, look for patterns in `{project-name}/00-intake/interview-sy
154
154
Update the assumptions tracker in `06-validation/assumptions-tracker.md`. For each assumption the intake generated, note: **Confirmed**, **Contradicted**, or **Unclear**.
155
155
156
156
**Red flags from interviews:**
157
-
-Fewer than 3/5 confirm the problem exists → the problem may be invented, not discovered
157
+
-3 or fewer of 5 confirm the problem exists → the problem may be invented, not discovered
158
158
- Nobody has paid for anything related → willingness-to-pay is unproven
159
159
- All interviewees say "I'd use it" but nobody has ever tried to solve it → low urgency
160
160
- The problem they describe is different from the one you designed for → pivot needed
@@ -169,7 +169,7 @@ Update the assumptions tracker in `06-validation/assumptions-tracker.md`. For ea
169
169
- The problem language is consistent across interviews (sign that it's a real, shared pain)
170
170
171
171
**Pause and reassess if:**
172
-
-Fewer than 3 confirm the problem
172
+
-3 or fewer of 5 confirm the problem
173
173
- Everyone says "interesting" but nobody has ever tried to solve it
174
174
- The problem they describe doesn't match your proposed solution
175
175
@@ -186,4 +186,4 @@ If the founder has already spoken to 5+ potential customers before starting this
186
186
3. Flag that interviews are founder-reported, not independently conducted: add `[Founder-reported — verify independently]` to any claims derived from this.
187
187
4. Skip the interview structure above and proceed to Phase 4.
188
188
189
-
If the founder has spoken to fewer than 5 people, treat it as 0 and recommend running the interviews.
189
+
If the founder has spoken to fewer than 5 people, recommend running fresh interviews — minimum 5 in Full Mode, minimum 3 in Fast Track. Document any prior conversations as `[Founder-reported]` context anyway.
Copy file name to clipboardExpand all lines: startup-design/references/output-guidelines.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,7 +98,9 @@ Pull each value from the actual phase outputs. Do not invent or approximate. If
98
98
═══════════════════════════════════════════════
99
99
```
100
100
101
-
-**Customer Interviews**: Number of interviews conducted in Phase 3.7 and problem confirmation rate (e.g., "5 conducted · confirmed by 4/5"). If Fast Track with founder-reported conversations, note "[Founder-reported]".
101
+
**Field definitions:**
102
+
103
+
-**Customer Interviews**: Number of interviews conducted in Phase 3.7 and problem confirmation rate (e.g., "5 conducted · confirmed by 4/5"). If Fast Track with founder-reported conversations, note "[Founder-reported]". If the founder deferred interviews, write "0 conducted · deferred".
102
104
-**Financial Stage**: A = Assumption-Based (no real traction data), B = Evidence-Based (projections anchored to interview signals or real traction data).
103
105
-**Idea**: The specific variation selected after brainstorming, not the original raw input.
104
106
-**Founder Fit**: From Phase 1 intake assessment. Strong = clear unfair advantage. Moderate = some relevant background. Weak = no domain edge.
0 commit comments