--- name: Startup Design slug: startup-design category: AI Engineering description: Startup Design helps turn a startup idea into a structured plan with market research, competitive analysis, strategy, brand, product, financials, and validation experiments. Use it when exploring an idea, sizing a market, or deciding whether to pursue a business concept. github: "https://github.com/ferdinandobons/startup-skill/tree/main/startup-design" stars: 836 forks: 125 install: "npx degit https://github.com/ferdinandobons/startup-skill/tree/main/startup-design ~/.claude/skills/startup-design" installs_to: ~/.claude/skills/startup-design source_path: startup-design/SKILL.md collection_size: 4 category_size: 2451 collection_url: "https://dirskills.com/collections/ferdinandobons/startup-skill" added: 2026-08-22T05:22:02.616Z last_synced: 2026-08-22T05:22:02.616Z canonical_url: "https://dirskills.com/skills/startup-design" --- # Startup Design Startup Design helps turn a startup idea into a structured plan with market research, competitive analysis, strategy, brand, product, financials, and validation experiments. Use it when exploring an idea, sizing a market, or deciding whether to pursue a business concept. **Install:** ```bash npx degit https://github.com/ferdinandobons/startup-skill/tree/main/startup-design ~/.claude/skills/startup-design ``` ## README # Startup Design A structured, multi-phase skill that takes a startup idea from raw concept to validated design. It produces a complete set of markdown documents organized by domain, with built-in progress tracking so work survives session interruptions. ## How It Works 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. ``` PRE-FLIGHT → INTAKE → BRAINSTORM → RESEARCH → [Research Gate] → CUSTOMER DISCOVERY → [Interview Gate] → STRATEGY → BRAND → PRODUCT → FINANCIAL → VALIDATION ``` ### Modes **Full Mode (default):** Execute all phases in order, including Pre-Flight and Customer Discovery. Best for thoroughly designing a startup from scratch. **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: 1. Phase 0.5 (Pre-Flight Check) — always run, takes 5 minutes 2. Phase 1 (Intake) — shortened to 1 round of questions; capture any prior customer conversations 3. Phase 2 (Brainstorm) — 3 variations instead of 5-8 4. Phase 3 (Research) — Wave 1 + Wave 2 only (skip customer voice and distribution deep-dives) 5. Phase 3.5 (Research Gate) — go/no-go checkpoint 6. Phase 3.7 (Customer Discovery) — if founder has 5+ prior conversations, document them; if not, run at least 3 interviews before proceeding 7. Phase 4 (Strategy) — Lean Canvas only 8. Skip Phase 5 (Brand) and Phase 6 (Product) 9. Phase 7 (Financial) — Revenue model only, Stage A (assumption-based), no full projections 10. Phase 8 (Validation) — Scorecard + top 3 experiments only Fast Track produces fewer files but still gives the founder a clear go/no-go signal with evidence. Note in PROGRESS.md that Fast Track mode was used, so a future session can expand to full mode if the idea passes validation. ### Language Default output language is **English**. If the user writes in another language or explicitly requests one, use that language for all outputs instead. --- > **Reference:** Read `references/output-guidelines.md` once at the start. It defines the standard file header/footer (title, date, phase, confidence, flags), cross-phase referencing format, quality examples of good vs. bad output, and how to handle mid-process pivots. ## Phase 0: Resume Check Before anything else, check if a `PROGRESS.md` file exists in the working directory (or a project subdirectory). If it does, read it and resume from the last incomplete phase. Tell the user: "I found progress from a previous session. You completed [phases]. Picking up from [next phase]." If no progress file exists, start from Phase 1. --- ## Phase 0.5: Pre-Flight Check Before investing time in the full process, run a fast sanity check — 2-3 targeted searches, 5 minutes maximum. The goal is to surface any immediately disqualifying signals so the founder knows them upfront. **Run these three checks:** **1. Dominant solution check** — Does a well-funded, widely-adopted solution to this exact problem already exist? Search: `"{problem domain} software"`, `"{problem} tool site:producthunt.com"`, `"{problem} app reviews"`. If a clear market leader with 10k+ customers exists, flag it immediately — this is not a reason to stop, but the founder needs to know the competitive reality before starting. **2. Precedent failure check** — Has a company tried this exact idea and failed publicly? Search: `"{startup idea} startup failed"`, `"{problem} startup shutdown"`, `"why {product category} failed"`. Prior failures are not disqualifying — they're learnings. But unknown prior failures are landmines. **3. Regulatory/legal instant kill** — Is there an obvious legal reason this idea cannot exist? (E.g., specific financial regulations, data privacy laws in the target geography, licensing requirements.) A quick search prevents building toward a wall. **Output:** A short message to the founder (3-5 bullet points max) with what was found. Use this format: ``` ## Pre-Flight Check ✅ No dominant incumbent found — space appears open. ⚠️ [CompanyX] tried a similar approach in 2021 and shut down in 2023. Key reason: [one sentence]. Worth understanding before proceeding. ✅ No obvious regulatory blockers identified for [target market]. → Ready to proceed to intake. The above is context, not a verdict. ``` 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. --- ## Phase 1: Intake Interview The quality of everything downstream depends on how much context you extract now. Don't rush this — a thorough intake saves hours of misdirection later. > **Reference:** Read `references/intake-questions.md` for the full question set (idea, founders, market, business, constraints), the hard questions that surface blind spots, and interviewing technique. Cover all five question areas plus the hard questions — they set the tone for the entire process and signal that this is an honest assessment, not a cheerleading session. Ask 3-5 questions at a time in a conversational flow, probe vague answers, and after 2-3 rounds summarize what you've understood and ask the user to confirm or correct. ### Output 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`). 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. --- ## Phase 2: Brainstorm Before diving into research, explore the idea space. This prevents premature convergence on the first version of the idea. ### Process 1. **Diverge** — Generate 5-8 variations of the core idea. Push boundaries: - What if the target market was completely different? - What if the business model was inverted? - What if you solved a smaller/larger version of the problem? - What adjacent problems could you solve instead? - What would the "10x version" look like vs. the "simplest possible version"? 2. **Analyze** — For each variation, note: - What's exciting about it - What's risky or hard - How it changes the competitive landscape 3. **Converge** — Present the variations to the user. Help them identify which elements resonate. The goal isn't to pick one variation — it's to enrich the original idea with insights from the exploration. 4. **Refine** — Based on the user's reactions, crystallize the refined idea. Update the brief if the idea evolved significantly. ### Output Save to `{project-name}/00-intake/brainstorm.md`. Update PROGRESS.md. --- ## Phase 2.5: Research Depth Assessment After intake (and brainstorm if applicable), assess market complexity and present the Research Depth recommendation to the user. > **Reference:** Read `references/research-scaling.md` for the complexity scoring matrix, tier definitions, wave configurations, and the user communication template. ### Process 1. Score three factors from the intake: market breadth (1-3), known competitors (1-3), geographic scope (1-3) 2. Sum the scores (range 3-9) and map to a tier: Light (3-4), Standard (5-7), Deep (8-9) 3. Present the Research Depth table to the user (see `research-scaling.md` for the exact template) 4. Wait for user response: **light**, **deep**, or **ok** to accept the recommendation 5. Record the selected tier in PROGRESS.md The selected tier determines the number of agents per wave and search rounds per agent in Phase 3. See `research-scaling.md` for exact wave configurations per tier. --- ## Phase 3: Market Research This is the most resource-intensive phase. It uses 4 sequential waves of web research, each building on the previous one's findings. ### Environment Detection Check if the `Agent` tool is available (Claude Code) or not (Claude.ai, other environments): - **Agent tool available:** Spawn subagents in parallel within each wave, as described below. This is faster (~3-5 min per wave). - **Agent tool NOT available (Claude.ai, web):** Execute the research yourself, sequentially. For each wave, follow the same agent templates from the reference files, but run the searches one at a time in the main conversation. Cover the same topics and apply the same research principles — the output quality should be identical, it just takes longer. Do NOT skip any wave or reduce search depth because of the sequential mode. ### Web Search Availability Phase 3 requires WebSearch. In Claude Code, the tool is always available — if the user hasn't pre-approved it, the system will prompt them for each search. If the user denies permission, or in environments where WebSearch doesn't exist at all, fall back to **Knowledge-Based Research Mode**: use your training data, clearly mark all findings with **[Knowledge-Based — not live data, verify independently]**, reduce confidence ratings by one level, and recommend the founder verify key claims manually. Note the mode in PROGRESS.md so future sessions know the research wasn't web-sourced. > **References** — Read the relevant file for each wave: > - `references/research-principles.md` — Cross-cutting rules (source quality, cross-referencing, quantification, handling search failures). Read this FIRST. > - `references/research-wave-1-market.md` — Agent templates for Wave 1 (market sizing, trends, regulatory) > - `references/research-wave-2-competitors.md` — Agent templates for Wave 2 (direct, indirect, GTM analysis) > - `references/research-wave-3-customers.md` — Agent templates for Wave 3 (customer voice, demand, audience) > - `references/research-wave-4-distribution.md` — Agent templates for Wave 4 (channels, geographic entry) > - `references/research-synthesis.md` — How to synthesize raw findings into final deliverables > > Read only the principles file + the wave file you're currently executing. Don't load all wave files at once. ### Research Principles - Each agent performs **5-8 web searches minimum**, drilling deeper with each round - Cross-reference every key finding across 2-3 independent sources - Rate source quality (Tier 1: analyst reports, Tier 2: tech press, Tier 3: blogs/social) - Quantify everything — "$4.2B at 12.3% CAGR" not "the market is growing" - Date all data and flag anything older than 18 months - Note contradictions between sources rather than picking one ### Research Waves Full agent briefs, search strategies, and output destinations live in the wave reference files — read the relevant file when spawning each wave: - **Wave 1: Market Landscape** (3 agents) — A1 Market Sizing & Economics, A2 Industry Trends & Timing, A3 Regulatory & Compliance *(skip A3 if no regulatory exposure)* - **Wave 2: Competitive Analysis** (3 agents) — B1 Direct Competitor Deep-Dives, B2 Indirect Competitors & Substitutes, B3 Competitor Go-to-Market - **Wave 3: Customer & Demand** (3 agents) — C1 Customer Voice & Pain Points, C2 Demand Signals & Market Validation, C3 Target Audience Profiling - **Wave 4: Distribution & Partnerships** (2 agents) — D1 Distribution Channels, D2 Geographic & Market Entry Each wave must complete before the next starts. Pass key findings forward as context (Wave 1 findings to Wave 2 agents, competitor list and GTM findings to Wave 3, and so on). Agents run in parallel within a wave, or as sequential research blocks without the Agent tool. ### Raw → Synthesized All agents save raw findings to `{project-name}/01-discovery/raw/`. After all waves complete, synthesize into 4 polished deliverables. Synthesis is reasoning, not formatting — it's where the raw research becomes a decision. Before writing anything, think hard about how the pieces fit together: which sources conflict and which to trust, what the evidence actually supports versus what the founder hopes, and what it all means for *this* specific startup. This is the highest-leverage thinking in the whole process and every downstream phase inherits its quality, so if the model supports extended thinking, this is the place to spend it. A weak synthesis produces a tidy document that restates the inputs; a strong one reaches the non-obvious conclusions a sharp analyst would draw from the same evidence. The synthesis must: - Connect dots across research areas (competitive gaps → customer pains → positioning opportunities) - Highlight contradictions and explain which data to trust - Rate confidence for each major claim (High / Medium / Low) - Extract explicit strategic implications, not just facts ### Output Files - `{project-name}/01-discovery/market-analysis.md` — Market size (TAM/SAM/SOM), growth, maturity, regulatory summary, timing assessment - `{project-name}/01-discovery/competitor-landscape.md` — Competitor profiles, **structured comparison matrix** (table with columns: Name, Product, Pricing, Target, Funding, Traction, Key Strength, Key Weakness), positioning map, platform risk, vulnerability analysis - `{project-name}/01-discovery/target-audience.md` — Persona(s), pain hierarchy, jobs-to-be-done, language map, buying behavior, channels - `{project-name}/01-discovery/industry-trends.md` — Tech trends, investment signals, behavioral shifts, regulatory trajectory, strategic implications - `{project-name}/01-discovery/confidence-dashboard.md` — Summary of data quality across all research. For each major claim, list: the claim, source tier (1/2/3), number of corroborating sources, confidence level (High/Medium/Low), and data age. This tells the founder where they're standing on solid ground vs. thin ice. Update PROGRESS.md. --- ## Phase 3.5a: Research Verification After synthesis completes and all deliverable files are written, run a verification pass to catch inconsistencies. > **Reference:** Read `references/verification-agent.md` for the full verification protocol, universal checks, and skill-specific checks. ### Process 1. Spawn agent **V1: Verification** — it reads all deliverable files in `01-discovery/` and checks for: unlabeled claims, internal contradictions, confidence rating consistency, missing data gaps, missing flags, stale data, and duplicate-source false corroboration 2. V1 also runs startup-design-specific checks: cross-phase consistency (strategy reflects market data, product reflects customer pains, financial reflects business model, validation covers identified risks) 3. V1 produces `{project-name}/01-discovery/verification-report.md` 4. **If Critical issues found:** Pause and present issues to the user. Ask: fix first, or proceed as-is? 5. **If only Warnings/Info:** Show one-line summary and continue to Research Gate In Claude.ai or when Agent tool is unavailable, run the verification checks yourself in the main conversation following the same protocol. --- ## Phase 3.5: Research Gate (Go/No-Go Checkpoint) Before investing time in Strategy through Validation, pause and present the founder with an honest assessment based on research findings. This is a decision point, not a formality. Reason it through before writing the verdict. Weigh the strongest signals against the red flags rather than averaging them into a noncommittal "it depends" — one fatal flaw can outweigh five promising signals, and one exceptional signal can justify proceeding despite rough edges. The founder is about to spend real time and money on your read of the evidence, so think hard about what the data genuinely supports. Present a brief summary: "Here's what the research found." Cover market size, competition intensity, customer demand signals, and timing. Then give a clear recommendation: - **Green light** — Data supports proceeding. Note the strongest signals. - **Yellow light** — Mixed signals. Specify what's concerning and what would need to be true for success. - **Red light** — Data argues against this approach. Suggest pivots if the research revealed adjacent opportunities. Ask the founder: "Based on this, do you want to continue to full strategy, pivot the idea, or stop here?" Respect their decision, but make sure it's an informed one. Save the gate assessment in `{project-name}/01-discovery/research-gate.md`. --- ## Phase 3.7: Customer Discovery (Interviews) 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). > **Reference:** Read `references/customer-interview.md` for the full interview protocol, question structure, notes template, and synthesis guide. ### When to run this phase 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. Because interviews interrupt the session flow, present the founder with an explicit choice: - **Run interviews now (recommended)** — pause here, conduct the interviews over the coming days, and resume from this checkpoint (PROGRESS.md preserves the state). - **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. **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. ### Process 1. **Identify who to interview** — Using the primary persona from `01-discovery/target-audience.md`, define the exact profile. 5 interviews minimum. 2. **Conduct interviews** — Follow the protocol in `references/customer-interview.md`. Aim for 25-30 minutes each, problem-focused, no product pitching. 3. **Document each interview** — Save to `{project-name}/00-intake/interviews/interview-{N}.md` using the template from the reference file. 4. **Synthesize** — After all interviews, write `{project-name}/00-intake/interview-synthesis.md` covering: problem confirmation rate, behavior signals (who paid/built workarounds), key phrases, and assumption audit. ### Interview Gate: Proceed vs. Reassess After synthesis, present a brief finding to the founder and apply this gate: **Proceed to Phase 4 if:** - 4+ of 5 interviewees confirm the core problem clearly and unprompted - At least 2 show behavior signals (paid for something, built a workaround, actively searched) - Problem language is consistent across interviews **Pause and reassess if:** - 3 or fewer of 5 confirm the problem (scale proportionally if more interviews were run) - Everyone says "interesting" but no behavior signals exist - The problem they describe doesn't match the proposed solution Present the synthesis and gate result to the founder. If the result calls for reassessment, suggest specific pivots if the interviews pointed to an adjacent problem worth solving. Let the founder decide: pivot the idea, narrow the target, or stop. Upd