| name | venture-analyst |
| description | Startup and SaaS idea validation. Researches market evidence, maps competitors, scores viability, and generates concrete validation experiments. Zero API keys required. |
Venture Analyst
Research a startup or SaaS idea and determine if it's worth building. No fluff - real evidence from real sources, structured reasoning, and a committed decision.
What this does
Six phases, each producing structured output:
- Problem Discovery - Find evidence the problem actually exists (Reddit, HN, GitHub issues, trends)
- Competitor Intelligence - Map the landscape, find gaps, extract pricing signals
- Validation Experiments - Generate 3 prioritized experiments to test demand before building
- Verdict - Bull/Bear/Judge debate with Confidence Engine and scored recommendation
- Decision Intelligence - Contradiction detection, founder trap check, reality check, distribution plan, time-to-first-dollar
- Execution & Moat - 30-day roadmap, moat scoring, PMF simulation, market timing
How to use
Describe your idea. Include:
- What it does (one sentence)
- Who it's for (target customer)
- What problem it solves
Optional: budget for experiments, market type (B2C/B2B), known competitors, founder background.
Phase 1 - Problem Discovery
Goal: Find evidence the problem is real and people talk about it unprompted.
Use scripts/sources.py to collect evidence:
from scripts.sources import search_hn, search_hn_comments, search_reddit, search_github_issues, get_trends, calculate_evidence_score
hn_stories = search_hn(query, limit=20)
hn_comments = search_hn_comments(query, min_points=3, limit=30)
reddit_posts = search_reddit(query, limit=25, timeframe="year")
gh_issues = search_github_issues(query, limit=20)
trend_data = get_trends(keyword)
Evidence Quality (not just quantity):
Evaluate source mix and signal strength, not just raw counts.
| Source | Quality signal | Weight |
|---|
| HN Ask/Show with 50+ points | People actively seeking solutions | High |
| Reddit complaints with 100+ upvotes | Widespread frustration | High |
| GitHub issues with many reactions | Developers hitting the same wall | High |
| HN/Reddit mentions of spending money | Willingness to pay | Very high |
| Rising trend | Growing problem | High |
| Trend flat | Established problem | Medium |
| Trend declining | Dying problem | Negative |
| Generic blog posts | Low signal noise | Low |
Evidence Quality grades:
- A - Multiple high-quality sources, direct pain quotes, spending signals
- B - Good source mix, clear pain but limited spending signals
- C - Some signal but concentrated in one source
- D - Thin signal, only indirect evidence
- F - Essentially no evidence
Synthesize findings:
Strongest pain signals (prioritize):
- People actively spending money on imperfect solutions
- Recurring complaints with no satisfying answer
- "Is there a tool that does X?" posts with many upvotes
- GitHub issues with many reactions, still open
Red flags:
- Zero discussion anywhere (even if search terms varied)
- Problem exists but everyone's workaround is "good enough"
- Only a few power users care, no broad market
- Discussion peaked years ago (dying category)
Output format:
## Problem Evidence
Evidence Score: [0-100]
Evidence Quality: [A/B/C/D/F]
Source breakdown:
- HN: [n] discussions, strongest: "[quote]"
- Reddit: [n] posts, strongest: "[quote]"
- GitHub: [n] issues, strongest reaction count: [n]
- Trend: [rising/stable/declining], avg interest: [n]
Quality notes:
- [what makes this evidence strong]
- [what's missing]
Phase 2 - Competitor Intelligence
Goal: Map who's already solving this. Find pricing, positioning gaps, weak points.
from scripts.scraper import scrape_competitor
from scripts.sources import search_github_repos, search_web
repos = search_github_repos(f"{idea} tool", limit=8)
web_results = search_web(f"{idea} software alternatives", limit=8)
for url in competitor_urls:
data = scrape_competitor(url)
Competitive map:
| Name | Pricing | Target | Weakness | Stars/Users |
|------|---------|--------|----------|-------------|
Gaps to identify:
- Price ceiling: tier missing between free and enterprise?
- Audience gap: power users vs beginners vs enterprise underserved?
- Feature gap: what do reviews complain about repeatedly?
- Distribution gap: channel nobody is using?
Opportunity Score vs Startup Score:
These are two different things. Conflating them is a common mistake.
- Opportunity Score = how good is the market? (demand, size, willingness to pay)
- Startup Score = how viable is this as a startup? (scalability, defensibility, execution path)
A market can be huge (high opportunity) but impossible to win as a bootstrapped startup (low startup score). Example: "A better Stripe" - huge opportunity, near-zero startup score for most founders.
Score both separately in the competitor output section.
Phase 3 - Validation Experiments
Goal: Before writing code, find out if people will actually pay.
from scripts.experiments import generate_experiments, format_experiment_output
experiments = generate_experiments(
idea=idea,
target_customer=target,
market_type="b2b",
competition_level="medium",
budget="zero",
)
print(format_experiment_output(experiments, idea))
Present experiments in priority order. Cheapest + highest-signal first.
Mom Test enforcement - when helping design interviews or outreach:
- See
references/mom-test.md for good vs bad questions
- Flag any future-hypothetical question ("would you use X?")
- Replace with past-behavior questions ("how do you currently handle X?")
Time-To-First-Dollar estimate:
For each experiment path, estimate realistic time to first revenue:
| Market type | Typical range | What accelerates it |
|---|
| B2C consumer SaaS | 30-90 days | Viral loop, strong landing page CTR |
| B2B SMB | 30-60 days | Warm outreach, concierge MVP |
| B2B mid-market | 60-180 days | Champion inside company, ROI clear |
| B2B enterprise | 6-18 months | Do not start here without traction |
| Developer tool (paid) | 14-45 days | Show HN, Product Hunt, X/Twitter post |
| Marketplace | 90-180+ days | Cold start problem, both sides |
| Content-led SaaS | 60-120 days | SEO takes time, need existing audience |
This is not the time to build - it's the time from starting experiments to first paying customer.
Phase 4 - Verdict
Goal: Simulate a debate between Bull, Bear, and Judge. Reach a committed conclusion.
Confidence Engine
The confidence score must explain itself. Not "Confidence: High" alone. Show the reasoning.
Confidence: [0-100]
High confidence because:
+ [n] Reddit mentions across [n] subreddits
+ [n] GitHub issues with [n]+ reactions
+ [n] competitors validated with real pricing
+ Rising trend over [period]
+ [specific spending signal found]
Confidence reduced because:
- [specific gap, e.g. weak monetization signals]
- [e.g. no willingness-to-pay evidence found]
- [e.g. fragmented ICP - different pain in different segments]
- [e.g. limited search volume data]
This matters because users need to see the reasoning is transparent, not magic.
Bull case (write this first)
- Strongest evidence for building it
- Market timing arguments
- Why this team / why now
- Best-case scenario with numbers
Bear case (steelman the opposition)
- Strongest evidence AGAINST building it
- Why existing solutions might be good enough
- Market risks, timing risks, competition risks
- Why it might fail even if the problem is real
Judge verdict
Apply these criteria:
| Signal | Weight |
|---|
| Evidence score > 60 | +2 |
| Evidence quality A or B | +1 |
| Trend = rising | +1 |
| Competitors have clear weakness | +1 |
| No dominant player (>50% market) | +1 |
| B2B with willingness-to-pay signals | +1 |
| Price ceiling exists | +1 |
| Evidence score < 30 | -3 |
| Evidence quality D or F | -2 |
| Trend = declining | -2 |
| 1+ competitor with >100k users + free tier | -2 |
| Problem is niche (<10k potential users) | -1 |
| Founder trap detected (high priority) | -2 |
| Reality check failed | -2 |
Verdict:
Recommendation: BUILD / VALIDATE FIRST / AVOID
Confidence: [0-100]
Score: [+N or -N]
Judge's reasoning:
[2-3 sentences. Direct. No hedging. Reference the specific evidence that tipped the scale.]
Phase 5 - Decision Intelligence
Run this after the Verdict. It does not change the verdict score - it adds context that makes the decision actionable.
Contradiction Detector
Look for contradictions between sources. The most valuable insight is often in the gap between what people say and what the market shows.
Common contradiction patterns:
Pain high, market growing:
Reddit: strong complaints about current solutions
Competitors: growing, raising funding
Interpretation: users hate existing tools but still pay.
This is an improvement opportunity, not a replacement play.
Consider: better UX, better pricing, better ICP focus.
Pain high, no competitors:
Evidence of real pain.
Zero viable competitors found.
Two interpretations:
1. Blue ocean - opportunity exists
2. Graveyard - others tried and died
Check: search for failed startups in this space. If multiple failed,
investigate why before treating this as opportunity.
Trend rising, community silent:
Google Trends shows growing interest.
Reddit/HN have minimal discussion.
Possible: problem is new, community hasn't formed yet (early).
Risk: trend is noise, not genuine demand.
Competition dense, pain still high:
Multiple established competitors.
Pain signals still strong and recent.
Interpretation: nobody has actually solved it.
Look for the structural reason: price, UX, missing feature, wrong ICP.
When a contradiction is found, output:
Contradiction detected: [name]
[source A] shows: [signal]
[source B] shows: [signal]
Most likely interpretation: [explanation]
What to verify: [specific experiment or question that resolves this]
Founder Trap Detector
Check references/founder-traps.md for full criteria.
Evaluate the evidence against each trap pattern. Flag any trap where 3+ signals match.
Output when trap found:
Founder Trap: [trap name]
Evidence: [which signals matched]
Risk level: [high/medium]
Does not invalidate the opportunity, but changes the execution approach.
Reality Check
This is not about the market - it's about whether this founder can execute this idea.
Gather context:
- What is the founder's background? (from idea description if mentioned)
- What does the idea require to work? (regulatory, infrastructure, capital, technical depth)
Questions to answer:
- Does this require compliance, licensing, or regulatory approval?
- Does this require partnerships before it can function? (e.g. bank partners, data licenses)
- Does this require enterprise sales from day one?
- Does this require a team of 10+ to build the MVP?
- Is the technical complexity beyond a solo founder?
If 2+ of these are true:
Reality check: Execution path is high-risk for early-stage founders
Requires: [list what it requires]
This does not mean the opportunity is bad.
It means: do not start building until these constraints are addressed.
Alternative paths:
- [reduced scope version that avoids the constraint]
- [validate the demand first, then find the right co-founder/partner]
Distribution Plan
Based on the research, recommend 3 specific acquisition channels.
Use references/traction.md for channel criteria. Apply to this specific market:
Top channels for this idea:
1. [channel] - because [specific evidence from research]
Test: [how to run a cheap test in 2 weeks]
2. [channel] - because [specific evidence]
Test: [how to test]
3. [channel] - because [specific evidence]
Test: [how to test]
Avoid:
- SEO - [reason, e.g. "competitive market, 6+ months to rank"]
- Paid social - [reason, e.g. "B2B ICP hard to target on Meta"]
Do not recommend generic channels. Base it on where the pain evidence was actually found.
Example: if most Reddit signal came from r/smallbusiness, recommend Reddit community strategy specifically.
Time-To-First-Dollar
Based on the market type, competition, and experiment plan:
Time-To-First-Dollar estimate: [X-Y weeks/months]
Path:
Week 1-2: [specific action, e.g. "cold outreach to 50 Reddit users who posted about problem"]
Week 3-4: [specific action]
Week 5-8: [specific action]
Target: first paying customer by [date estimate]
What would accelerate this: [specific factor]
What would delay this: [specific risk]
Assumption Map
Every startup decision rests on assumptions. Most founders know the surface ones. The dangerous ones are buried.
Identify the 3 critical assumptions this startup cannot survive without. For each:
- What the startup is betting on being true
- Confidence level based on actual evidence collected (not gut feel)
- What would validate or invalidate it
Critical Assumption A1:
[The core belief about the problem/customer]
Confidence: [0-100]
Based on: [evidence or lack of it]
Validates if: [specific observable outcome]
Kills startup if: [falsified by X]
Critical Assumption A2:
[Usually the monetization or switching assumption]
Confidence: [0-100]
Based on: [evidence or lack of it]
Validates if: [specific observable outcome]
Kills startup if: [falsified by X]
Critical Assumption A3:
[Usually the distribution or growth assumption]
Confidence: [0-100]
Based on: [evidence or lack of it]
Validates if: [specific observable outcome]
Kills startup if: [falsified by X]
Rank them: most dangerous assumption first (lowest confidence that is also most critical to survival).
This is not a list of things to do. It is a map of what the founder believes vs what the evidence supports.
Phase 6 - Execution & Moat
Goal: Answer "should you dedicate the next 2 years of your life to this?" - not just "is it a good idea?"
This phase converts the analysis into action and answers the defensibility question.
Execution Roadmap
Use references/execution-roadmap.md for the full framework. Output a week-by-week plan tailored to the verdict:
If BUILD:
- Week 1: find 5 people with the problem (specific communities from the research)
- Week 2: deliver value manually before building
- Week 3: charge for it
- Week 4: find customer 2-3 and a referral
Key rule: no code until someone commits to paying. The roadmap builds toward a transaction, not a product.
If VALIDATE FIRST:
- Define the one critical unknown in one sentence
- Run the cheapest test that could falsify it (2 weeks max)
- Define pass/fail threshold before starting
- Week 4: commit to BUILD or pivot/stop based on data
If AVOID:
- 2-week pivot investigation using the most interesting signal from the research
- Or clean stop criteria with specific trigger conditions for revisiting
Always include:
Do NOT build yet: [specific features to avoid and why]
Reassess if: [specific trigger that means the plan is failing]
Kill Criteria
Most founders know when to start. Almost none know when to stop.
Generate kill criteria calibrated to the specific idea and market type. These are not generic - they come from the evidence and experiment plan.
Kill Criteria for [idea]:
If after [days] from starting:
Experiments:
- Fewer than [n] real customer interviews completed
- Fewer than [n] people willing to schedule a call
- Zero payment intent (pre-order, deposit, contract signed)
Signals:
- [specific negative signal tied to the idea]
- [specific negative signal]
-> Stop. Do not pivot yet. First answer: was the problem real or did we imagine it?
Pivot trigger (instead of stop):
If the problem gets validated but [specific conversion/monetization step] fails -> pivot to [specific narrower scope or different monetization]
Thresholds must be concrete numbers, not vague goals. "Not enough traction" is not a kill criterion. "Zero paying customers after 21 days of direct outreach" is.
Pivot Engine
Run this when verdict = AVOID or when Kill Criteria are hit.
Based on the signals collected in Phases 1-2, identify 2-3 realistic pivot directions. Pivots must be grounded in actual evidence - not invented alternatives.
Pivot types to consider (from references/lean-startup.md):
- Segment pivot - same problem, different customer (who else has this pain?)
- Problem pivot - same customer, different problem (what else do they complain about?)
- Channel pivot - same product, different distribution (where are buyers actually found?)
- Scope pivot - same idea, 80% smaller (which one feature has the most evidence?)
Output format:
Pivot Option 1: [type]
From: [current idea]
To: [specific pivot]
Evidence: [signal from research that supports this direction]
Risk: [what could still be wrong]
Pivot Option 2: [type]
From: [current idea]
To: [specific pivot]
Evidence: [signal from research that supports this direction]
Risk: [what could still be wrong]
Recommended pivot: [1 or 2] - because [one sentence reason]
Do not generate pivots if no supporting evidence exists. If the research found nothing reusable, state: "No evidence-backed pivot found. Consider a different problem space entirely."
Moat Intelligence
Score all 5 moat types using references/moat-patterns.md. For each:
Distribution moat: [1-10] - [one-line reason]
Data moat: [1-10] - [one-line reason]
Community moat: [1-10] - [one-line reason]
Switching cost: [1-10] - [one-line reason]
Execution moat: [1-10] - [one-line reason]
Overall Moat Score: [weighted average of top 2]
Most realistic moat: [type]
How to build it: [specific action, not generic advice]
Do not score high without evidence. "We will accumulate data" is not a data moat - it is a plan. Score what exists or can realistically exist in 6 months.
PMF Simulation
Generate 3 ICP personas based on the evidence found in Phases 1-2. Each persona is grounded in actual signals from the research, not invented.
Persona A: [job title / situation]
- Current workflow for the problem: [specific, from research]
- What they hate about current solution: [from Reddit/HN quotes]
- What they pay today: [from competitor pricing research]
- What they would never pay for: [inferred from pain signals]
- Adoption trigger: [what would make them switch]
- Adoption blocker: [what would stop them even if interested]
Then simulate a 4-week adoption arc for each persona:
Week 1: discovers product (channel: [specific channel from distribution plan])
Week 2: [tries free / books demo / reads docs]
Week 3: [converts / churns / stalls - and why]
Week 4: [retained / referred / cancelled]
From the 3 simulations, identify the PMF friction points:
Main adoption blockers:
- [blocker 1]: affects [n/3] personas
- [blocker 2]: affects [n/3] personas
Easiest persona to convert: [A/B/C] - because [reason]
Start here.
Market Timing
Based on data already collected (trend, GitHub, competition):
Market timing: [Too Early / Good Window / Late / Saturated]
Signals:
+ [positive timing signal]
+ [positive timing signal]
- [negative timing signal]
Window estimate: [closes in X months / open for X years / unclear]
Timing verdict:
[One sentence. Is this the right moment? Why?]
Timing patterns to detect:
- Too early: trend rising but community not formed, infrastructure missing, no paying competitors yet
- Good window: trend rising, 2-5 established players with clear weaknesses, market education done by competitors
- Late entry: dominant player has >50% share and a free tier, market consolidating
- Saturated: 10+ funded competitors, VC money flooding in, CAC rising, differentiation collapsing
Enhancement detection
Run at session start to unlock better sources:
from scripts.enhance_detect import detect_level, ensure_searxng, best_search
env = detect_level()
if env["docker"] and not env["searxng"]:
ensure_searxng()
results = best_search(query, env, limit=10)
Level 1 (always works): HN + Reddit + GitHub + ddgs + trendspyg
Level 2 (auto, no keys): + SearXNG via Docker (if Docker installed)
Level 3 (optional keys): + Exa, Tavily, GitHub authenticated, VeyraScrape MCP
Never ask the user to set up API keys. Auto-detect and use what's available.
Evidence Score interpretation
From calculate_evidence_score() in sources.py:
| Score | Meaning |
|---|
| 0-20 | Weak - barely any signal. Rethink or pivot problem framing |
| 21-40 | Thin - some signal but not convincing |
| 41-60 | Moderate - proceed to competitor research |
| 61-80 | Strong - real problem, real people care |
| 81-100 | Very strong - validated pain, move to experiments immediately |
Methodology references
references/lean-startup.md - validated learning, MVP types, pivot signalsreferences/customer-dev.md - Steve Blank's 4 steps, problem interview structurereferences/mom-test.md - good vs bad interview questionsreferences/blue-ocean.md - Value Curve, ERRC Grid, finding uncontested spacereferences/traction.md - 19 acquisition channels, Bullseye frameworkreferences/founder-traps.md - 8 trap patterns with evidence criteriareferences/moat-patterns.md - 5 moat types with scoring criteria 1-10references/execution-roadmap.md - 30-day BUILD/VALIDATE/AVOID roadmap framework
Output principles
- Lead with evidence, not opinions
- Quote real sources (HN post, Reddit thread, GitHub issue) with specifics
- Separate fact from inference - never present interpretation as data
- Show the Confidence Engine reasoning - never just state "High confidence"
- Run the contradiction check - the most valuable insight is often in the gaps
- Check for founder traps before finalizing verdict
- Verdict must commit - no "it depends" without specifics and a path forward
- Distinguish Opportunity Score from Startup Score
- Phase 6 is not optional - the roadmap is what makes the analysis useful
- Moat scoring must be honest - score what exists, not what is planned
- Tag every factual claim:
[EVIDENCE] (backed by collected data), [INFERENCE] (logical conclusion from data), or [SPECULATION] (no direct data, informed guess). Never mix them silently. This applies to the Bull case, Bear case, moat scoring, PMF simulation, and market timing sections.
