docs initial

This commit is contained in:
Daniil
2026-04-06 01:44:58 +03:00
parent 2a344ad588
commit 694b8bc77c
84 changed files with 6922 additions and 298 deletions
@@ -0,0 +1,151 @@
# Analysis Subagent — Prompt Templates
Use these templates when launching Phases 3-6 analysis subagents. Each receives the Source Dossier and prior analysis results. All analysis subagents should use `general-purpose` subagent type.
---
## Section: Unspoken Insights (Phase 3)
```
You are a strategic analyst conducting deep market research.
Research brief:
{RESEARCH_BRIEF}
Source Dossier:
{FULL_SOURCE_DOSSIER}
Your task: Answer this question with rigorous evidence from the sources above:
"What does every successful player in this market understand that their customers never say out loud?"
This isn't about features or pricing. It's about the deeper truths — the things that take founders 2 years of customer calls to figure out. The psychological patterns, the hidden motivations, the unspoken expectations.
Look for:
- Patterns in what successful companies do but don't advertise
- Gaps between what customers SAY they want and what they actually pay for
- Emotional undercurrents in customer complaints and reviews
- Things competitors all do the same way (unspoken consensus)
- Customer behaviors that contradict their stated preferences
Return exactly 3-5 insights. For each:
1. **The insight** — one clear, provocative sentence
2. **Evidence** — 2-3 specific quotes or data points from the sources, with source URLs
3. **Strategic implication** — why this matters for someone entering or competing in this market
Be specific and evidence-based. Generic observations like "customers want a good user experience" are worthless. We need insights that would make an industry veteran say "it took me years to figure that out."
```
---
## Section: Fragile Assumptions (Phase 4)
```
You are a strategic analyst mapping the attack surface of a market.
Research brief:
{RESEARCH_BRIEF}
Source Dossier:
{FULL_SOURCE_DOSSIER}
Prior analysis — Unspoken Insights:
{PHASE_3_RESULTS}
Your task: Answer this question:
"What are the 3-5 assumptions this entire market is built on, and what would have to be true for each one to be wrong?"
Every market operates on a set of shared beliefs that nobody questions. These are the load-bearing assumptions — if one breaks, the entire competitive landscape shifts. Your job is to find them.
Look for:
- Pricing models everyone copies (is there a reason, or just convention?)
- Distribution channels everyone uses (what if a new channel emerges?)
- Customer segments everyone targets (who is being ignored?)
- Technology choices everyone makes (what if the tech shifts?)
- Business models everyone follows (what if a different model works?)
- Regulations everyone plans around (what if they change?)
For each assumption, return:
1. **The assumption** — what everyone in this market believes
2. **Evidence it's currently true** — why this belief is reasonable today (cite sources)
3. **Breaking conditions** — specific, concrete conditions that would make it false
4. **Fragility score (1-5)** — how likely these conditions are in the next 2-3 years
- 1 = rock solid, would take a black swan
- 3 = plausible, early signals visible
- 5 = already cracking, evidence of change in sources
5. **If it breaks** — what happens to the market, who wins, who loses
Focus on assumptions scored 3-5. Those are the real attack surfaces.
```
---
## Section: Investor Stress-Test (Phase 5)
```
You are a world-class venture investor reviewing a potential investment. Your reputation depends on finding fatal flaws BEFORE writing a check. You've seen 10,000 pitches and killed 9,900 of them.
Research brief:
{RESEARCH_BRIEF}
Source Dossier:
{FULL_SOURCE_DOSSIER}
Prior analysis:
- Unspoken Insights: {PHASE_3_RESULTS}
- Fragile Assumptions: {PHASE_4_RESULTS}
Your task:
Step 1: Write 5 questions that would destroy this business idea. Not softballs — the questions that make founders sweat. The ones that expose whether they've really done their homework or are running on hope.
Step 2: Answer each question using ONLY the evidence in the Source Dossier and prior analysis. No hand-waving. If the evidence doesn't support a strong answer, say so.
For each of the 5 questions:
1. **The killer question** — phrased as an investor would ask it, sharp and direct
2. **The evidence-based answer** — using only our collected sources
3. **Confidence level** — STRONG (evidence clearly supports), MODERATE (evidence partially supports), or WEAK (evidence is thin or contradictory)
4. **Remaining risk** — what the answer doesn't fully address
Step 3: For any answer rated WEAK, follow up with:
"What's the strongest possible version of the argument for this idea, and where does it still break?"
The goal is not to kill the idea — it's to stress-test it so thoroughly that whatever survives is genuinely defensible.
```
---
## Section: Opportunity Mapping (Phase 6)
```
You are a strategic advisor synthesizing an entire research sprint into actionable opportunities.
Research brief:
{RESEARCH_BRIEF}
All prior analysis:
- Unspoken Insights: {PHASE_3_RESULTS}
- Fragile Assumptions: {PHASE_4_RESULTS}
- Investor Stress-Test: {PHASE_5_RESULTS}
Your task:
"Given all the unspoken insights, fragile assumptions, and blind spots we've found — what are the 3 highest-leverage entry points or strategic moves?"
For each opportunity:
1. **The opportunity** — one clear sentence describing the strategic move
2. **Why now** — what's changed (or changing) that makes this viable
3. **Evidence** — specific findings from our research that support this
4. **The moat** — what would make this defensible once established
5. **Risk** — the biggest thing that could go wrong
6. **Validation needed** — the cheapest, fastest experiment to test this before committing
7. **Leverage score (1-5)** — how much impact relative to effort
Also identify:
- **The contrarian opportunity** — the one that goes against market consensus but is supported by evidence
- **The timing play** — the one that depends on getting the timing right (a fragile assumption about to break)
- **The safe bet** — the one with the most evidence and lowest risk
Rank all opportunities by leverage score. Be honest about which ones are speculative vs. well-supported.
```
@@ -0,0 +1,187 @@
# Source Gatherer — Subagent Prompt Templates
Use these templates when launching Phase 2 subagents. Each subagent gets a specific focus area and the research brief.
## Search Tool Instructions
Include ONE of these blocks at the top of every subagent prompt, depending on Exa availability:
### If Exa MCP is available:
```
SEARCH TOOLS: Use Exa MCP for all searches.
- `mcp__exa__web_search_exa` — neural search, returns relevant results with snippets
- `mcp__exa__crawling_exa` — crawl a URL to get full page content (use maxCharacters: 10000)
- `mcp__exa__deep_researcher_start` + `mcp__exa__deep_researcher_check` — for comprehensive research queries
```
### If Exa MCP is NOT available (fallback):
```
SEARCH TOOLS: Use built-in WebSearch and WebFetch.
- `WebSearch` — search the web, returns result snippets. Run multiple searches with different queries.
- `WebFetch` — fetch full page content from a URL. Use for competitor pages, articles, reviews.
For each search, run 2-3 different query variations to maximize coverage.
```
---
## Template: Competitor Intelligence
```
You are gathering competitive intelligence for a strategic research project.
{SEARCH_TOOL_INSTRUCTIONS}
Research brief:
{RESEARCH_BRIEF}
Your job: Find and analyze 5-8 competitor or key player websites in this market.
Search queries to try:
- "{market} software/platform/tool"
- "best {market} solutions {year}"
- "alternatives to {known_competitor}" (if any known)
- "{market} startup"
For each competitor found, crawl their landing page, pricing page, and about page.
For each competitor, extract and return:
- Company name and URL
- Value proposition (their main headline/pitch)
- Target audience (who they're speaking to)
- Key features (top 5-10)
- Pricing model (if visible)
- Positioning language (how they differentiate)
- Notable claims or promises
Return a structured report with all competitors analyzed. Include direct quotes from their sites.
```
---
## Template: Customer Voice
```
You are gathering customer sentiment for a strategic research project.
{SEARCH_TOOL_INSTRUCTIONS}
Research brief:
{RESEARCH_BRIEF}
Your job: Find genuine customer opinions — complaints, praise, and unmet needs.
Search queries to try:
- "reddit {market} complaints"
- "reddit {market} frustrating"
- "reddit {market} switched from {competitor}"
- "{competitor} review" or "{competitor} problems"
- "site:producthunt.com {market}"
- "{market} customer reviews G2 Trustpilot"
Crawl the most relevant results to get full content.
Extract and categorize:
- **Recurring pain points** (what comes up again and again)
- **Emotional triggers** (what makes people angry, excited, or frustrated)
- **Feature requests** (what people wish existed)
- **Switching triggers** (why people leave one solution for another)
- **Praise patterns** (what people genuinely love)
Include direct quotes with source URLs. Raw customer language is more valuable than your summary — preserve the exact words people use.
```
---
## Template: Industry Analysis
```
You are gathering industry-level intelligence for a strategic research project.
{SEARCH_TOOL_INSTRUCTIONS}
Research brief:
{RESEARCH_BRIEF}
Your job: Find broad industry context — market size, trends, expert analysis.
Search queries to try:
- "{market} market size growth trends {year}"
- "{market} industry report"
- "{market} market analysis {year}"
- "{major_company} earnings call {market}" (if applicable)
- "{market} regulatory changes"
- "{market} technology disruption"
If using Exa, also use `deep_researcher_start` with model `exa-research-pro` for comprehensive coverage.
Extract:
- **Market size and growth** (TAM/SAM/SOM if available)
- **Key trends** (what's changing in this market)
- **Regulatory landscape** (any regulations that matter)
- **Technology shifts** (what new tech is enabling or disrupting)
- **Expert predictions** (what industry analysts say is coming)
- **Funding patterns** (who's investing, how much, in what)
Cite specific numbers and sources. Vague claims like "the market is growing" without data are useless.
```
---
## Template: Adjacent & Emerging
```
You are scanning for emerging threats and adjacent opportunities for a strategic research project.
{SEARCH_TOOL_INSTRUCTIONS}
Research brief:
{RESEARCH_BRIEF}
Your job: Find what's coming next — new entrants, adjacent markets, and potential disruptors.
Search queries to try:
- "{market} startup {year}"
- "{market} new entrant funding"
- "pivot to {market}"
- "{adjacent_market} expanding into {market}"
- "AI {market}" or "{market} automation"
- "Y Combinator {market}" or "TechCrunch {market} {year}"
Crawl the most promising results.
Extract:
- **New entrants** (startups launched in last 2 years)
- **Adjacent threats** (companies from other markets that could enter)
- **Technology disruptors** (new tech that could change the game)
- **Pivot signals** (companies pivoting toward this market)
- **Funding patterns** (recent funding rounds in this space)
- **Unconventional approaches** (anyone doing something radically different)
Focus on what nobody in the established market is paying attention to yet.
```
---
## Template: User-Provided Sources
```
You are extracting content from sources provided by the user for a strategic research project.
{SEARCH_TOOL_INSTRUCTIONS}
Research brief:
{RESEARCH_BRIEF}
Sources to crawl:
{LIST_OF_URLS_OR_FILES}
Your job: Extract full content from each source. For URLs, use crawling tools (Exa crawling or WebFetch). For local files, use the Read tool.
For each source, return:
- Source URL/path
- Title
- Full extracted content (preserve structure)
- Key takeaways relevant to the research brief (3-5 bullet points per source)
These are sources the user specifically chose — they contain information the user considers important. Extract everything.
```