1. Gather Context (AskUserQuestion)
   - Skills, interests, resources
   ↓
2. Generate Ideas (faion-research-agent mode: ideas)
   - Apply 7 Ps framework + other methods
   ↓
3. User Selection (AskUserQuestion)
   - Pick 3-5 ideas to research
   ↓
4. Pain Point Research (faion-research-agent mode: pains)
   - Reddit, forums, reviews mining
   ↓
5. Niche Evaluation (faion-research-agent mode: niche)
   - Market size, competition, barriers
   ↓
6. Present Results
   ↓
   User selects idea? → YES → Write to product_docs/idea-validation.md
                     → NO  → Loop back to step 2

Question 1: "What are your skills/experience?"
Options:
- Software development
- Design/UX
- Marketing/Sales
- Domain expertise (specific industry)

Question 2: "What motivates you?"
Options:
- Solve my own problem
- Big market opportunity
- Passion project
- Side income

Question 3: "How much time can you invest?"
Options:
- Nights & weekends (side project)
- Part-time (20h/week)
- Full-time

Task(
    subagent_type="faion-research-agent (mode: ideas)",
    prompt=f"""Generate startup ideas for:
    Skills: {skills}
    Motivation: {motivation}
    Time commitment: {time}

    Use frameworks: 7 Ps, Paul Graham, Personal Pain Points
    Generate 15-20 ideas across categories.
    """,
    description="Generate startup ideas"
)

Question: "Which ideas do you want to research deeper?"
multiSelect: true
Options:
- {idea1} - {category}
- {idea2} - {category}
- {idea3} - {category}
- {idea4} - {category}
- "None, generate different ones"

Task(
    subagent_type="faion-research-agent (mode: pains)",
    prompt=f"""Research pain points for: {idea}

    Search:
    - Reddit complaints: "problem with {keyword}" site:reddit.com
    - Forum discussions: "{keyword} frustrating" OR "{keyword} hate"
    - App store reviews: "{competitor} review" 1-star

    Find: frequency, intensity, existing solutions, gaps
    """,
    description="Research pain points"
)

Task(
    subagent_type="faion-research-agent (mode: niche)",
    prompt=f"""Evaluate niche for: {idea}

    Criteria:
    - Market size (TAM/SAM/SOM estimates)
    - Competition level (red/blue ocean)
    - Entry barriers (technical, regulatory, capital)
    - Profitability potential (unit economics)
    - Your fit (skills match)

    Score each 1-10, provide total score.
    """,
    description="Evaluate niche viability"
)

Question: "Evaluation results. What's next?"
Options:
- {idea1} (score: 42/50) - select for development
- {idea2} (score: 38/50) - select for development
- Generate new ideas
- Research other niches for {ideaX}

# Idea Validation: {idea_name}

## Summary
- **Problem:** {pain point}
- **Solution:** {proposed solution}
- **Target audience:** {who}

## Pain Point Evidence
- Source 1: {quote, link}
- Source 2: {quote, link}

## Niche Evaluation
| Criterion | Score | Notes |
|-----------|-------|-------|
| Market size | X/10 | {notes} |
| Competition | X/10 | {notes} |
| Barriers | X/10 | {notes} |
| Profitability | X/10 | {notes} |
| Fit | X/10 | {notes} |
| **Total** | **XX/50** | |

## Next Steps
- [ ] Customer interviews
- [ ] MVP definition
- [ ] Create spec.md

1. Parse project from ARGUMENTS
2. Read: constitution.md, roadmap.md
3. AskUserQuestion: modules + mode (quick/deep)
4. Run agents SEQUENTIALLY (not parallel)
5. Write executive-summary.md

AskUserQuestion(
    questions=[{
        "question": "Which modules to run?",
        "multiSelect": True,
        "options": [
            {"label": "Market Research", "description": "TAM/SAM/SOM, trends"},
            {"label": "Competitors", "description": "Features, pricing"},
            {"label": "Personas", "description": "Pain points, JTBD"},
            {"label": "Validation", "description": "Problem evidence"},
            {"label": "Pricing", "description": "Benchmarks"}
        ]
    }]
)

AGENTS = {
    "market": "faion-research-agent (mode: market)",
    "competitors": "faion-research-agent (mode: competitors)",
    "personas": "faion-research-agent (mode: personas)",
    "validation": "faion-research-agent (mode: validate)",
    "pricing": "faion-research-agent (mode: pricing)"
}

for module in selected_modules:
    Task(
        subagent_type=AGENTS[module],
        prompt=f"""
PROJECT: {project}
PRODUCT: {product_description}
MODE: {quick|deep}
OUTPUT: aidocs/sdd/{project}/product_docs/{output_file}
"""
    )

aidocs/sdd/{project}/product_docs/
├── market-research.md
├── competitive-analysis.md
├── user-personas.md
├── problem-validation.md
├── pricing-research.md
├── executive-summary.md
└── gtm-manifest/              # Optional, after research complete
    └── gtm-manifest-full.md

# Market Research: {project}

## TAM (Total Addressable Market)
- Global market size: ${X}B
- Growth rate: X% CAGR
- Source: {citation}

## SAM (Serviceable Addressable Market)
- Geographic focus: {regions}
- Segment focus: {segments}
- SAM estimate: ${X}M

## SOM (Serviceable Obtainable Market)
- Year 1 realistic target: ${X}M
- Key assumptions: {list}

## Market Trends
1. Trend 1: {description}
2. Trend 2: {description}
3. Trend 3: {description}

## Drivers & Threats
| Drivers | Threats |
|---------|---------|
| {driver1} | {threat1} |
| {driver2} | {threat2} |

# Competitive Analysis: {project}

## Competitive Landscape

| Competitor | Type | Founded | Funding | Pricing |
|------------|------|---------|---------|---------|
| {name1} | Direct | {year} | ${X}M | {pricing} |
| {name2} | Indirect | {year} | ${X}M | {pricing} |

## Feature Comparison

| Feature | Us | Comp1 | Comp2 | Comp3 |
|---------|----|----|----|----|
| {feature1} | Y | Y | N | Y |
| {feature2} | Y | N | Y | N |

## Gap Analysis
- Gap 1: {description}
- Gap 2: {description}

## Positioning Strategy
{how to differentiate}

# User Personas: {project}

## Persona 1: {name}

### Demographics
- Age: {range}
- Role: {job title}
- Income: ${range}
- Location: {regions}

### Behaviors
- {behavior1}
- {behavior2}

### Pain Points
1. {pain1}
2. {pain2}
3. {pain3}

### Goals
- {goal1}
- {goal2}

### Jobs To Be Done
- Functional: {job}
- Emotional: {job}
- Social: {job}

GATHER CONCEPT → GENERATE NAMES → USER SELECTS → CHECK DOMAINS → PRESENT RESULTS → WRITE TO CONSTITUTION
     ↑                                                               ↓
     └───────────────── Loop if user wants more ─────────────────────┘

## Project Identity
- **Name:** {name}
- **Domain:** {name}.com

# Intent detection
if intent in ["idea", "research", "market", "competitors", "naming", "personas", "pricing"]:
    invoke("faion-research-domain-skill")

Task(
    subagent_type="faion-research-agent (mode: ideas)",
    prompt="Generate ideas using 7 Ps framework"
)

Task(
    subagent_type="faion-research-agent (mode: market)",
    prompt="Research TAM/SAM/SOM for {product}"
)

Task(
    subagent_type="faion-research-agent (mode: competitors)",
    prompt="Analyze competitors for {product}"
)

Task(
    subagent_type="faion-research-agent (mode: personas)",
    prompt="Create personas using JTBD for {product}"
)

Task(
    subagent_type="faion-research-agent (mode: names)",
    prompt="Generate names for {product_description}"
)

## Pain Ideas
1. {idea} - Score: {X}/15 - Notes: {why interesting}
2. {idea} - Score: {X}/15

## Passion Ideas
1. {idea} - Score: {X}/15

## Profession Ideas
1. {idea} - Score: {X}/15
...

## Top 3 to Validate
1. {idea} from {P} - Total: {X}/15
2. {idea} from {P} - Total: {X}/15
3. {idea} from {P} - Total: {X}/15

## Question 1: Tedious but Necessary
### List
- Expense reports
- Code reviews
- Meeting scheduling
- ...

### Themes
- Administrative overhead
- Communication friction

### Top Ideas
- Automated expense categorization
- AI code review assistant

| Date | Complaint | Category | Freq | Intensity | Notes |
|------|-----------|----------|------|-----------|-------|
| 01/18 | Can't find file | Tools | Daily | 7/10 | Slack + Drive + Email |
| 01/18 | Meeting ran over | Work | Weekly | 5/10 | No time boundaries |

| Idea | Market | Competition | Barriers | Monetization | Fit | Total |
|------|--------|-------------|----------|--------------|-----|-------|
| A | 4 | 3 | 4 | 5 | 4 | 20 |
| B | 5 | 2 | 3 | 4 | 3 | 17 |
| C | 3 | 4 | 5 | 3 | 5 | 20 |

## TAM
- Global market: $XX billion
- Growth: X% CAGR
- Source: {report name}

## SAM
- Geographic focus: {regions}
- Segment focus: {segments}
- SAM = $XX million

## SOM (Year 1)
- Target customers: X
- Average revenue: $Y
- SOM = $Z million
- % of SAM: X%

## Assumptions
1. {assumption 1}
2. {assumption 2}

## Trend: {Name}

### Overview
- Stage: {Emerging | Growing | Mature | Declining}
- Growth rate: X% annually
- Market size: $X billion

### Drivers
1. {driver} - Impact: High/Medium/Low
2. {driver} - Impact: High/Medium/Low

### Threats
1. {threat} - Likelihood: High/Medium/Low
2. {threat} - Likelihood: High/Medium/Low

### Timing Assessment
- Current stage: Early Majority
- Window: 2-3 years
- Recommendation: {proceed/wait/pivot}

## Direct Competitors

| Name | Founded | Funding | Pricing | Differentiator |
|------|---------|---------|---------|----------------|
| {name} | 2020 | $10M | $99/mo | Feature X |
| {name} | 2018 | $50M | $199/mo | Enterprise |

## Indirect Competitors

| Name | How they compete | Weakness |
|------|-----------------|----------|
| {name} | {explanation} | {gap} |

## Market Position Map

## Whitespace Identified
- {gap 1}: {description}
- {gap 2}: {description}

| Feature | Us | Comp A | Comp B | Comp C | Gap? |
|---------|-------|--------|--------|--------|------|
| Core 1 | Y | Y | Y | Y | No (table stakes) |
| Core 2 | Y | Y | P | Y | No |
| Diff 1 | Y | N | N | P | Yes - Opportunity |
| Diff 2 | P | Y | Y | N | Build out |
| Nice 1 | N | N | N | N | Validate demand |

## Gap: {Feature Name}

### Evidence
- Reviews mentioning need: X
- Forum discussions: X links
- Search volume: X/month

### Why Competitors Don't Have It
- {reason}: Technical difficulty / Low priority / Not aware

### Our Advantage
- {why we can build it}

### Recommendation
- Pursue / Investigate / Skip

## Warm-up
"Thanks for joining. I'm researching [topic]. No sales pitch, just learning."

## Current State
"Walk me through how you currently [task]."
"What tools do you use?"
"How often do you do this?"

## Pain Exploration
"What's the most frustrating part?"
"Tell me about the last time it went wrong."
"What workarounds have you tried?"

## Solution Probing (show concept/prototype)
"Would something like this help?"
"What's missing?"
"Would you pay for this? How much?"

## Wrap-up
"Who else should I talk to?"
"Can I follow up in 2 weeks?"

When I [situation/trigger],
I want to [motivation/action],
So I can [expected outcome/benefit].

## Job: {Name}

### Situation/Trigger
When I {situation}...

### Functional Job
I want to {action}...

### Emotional Job
So I can feel {emotion}...

### Social Job
And be seen as {perception}...

### Current Solutions
- {solution 1}: Hired because {reason}, fired because {reason}
- {solution 2}: Hired because {reason}, fired because {reason}

### Our Opportunity
We can {do X better} by {approach}

# Persona: {Name} ({Type})

## Photo
[Stock photo representing this person]

## Demographics
- **Age:** 32
- **Role:** Product Manager at startup
- **Income:** $120K
- **Location:** San Francisco
- **Tech savviness:** High

## Behaviors
- Works 50+ hours/week
- Uses: Slack, Notion, Figma, Jira
- Checks phone first thing in morning
- Reads newsletters over coffee

## Pain Points
1. Too many tools, context switching
2. Stakeholder alignment meetings
3. Data scattered across systems

## Goals
- Ship features faster
- Better work-life balance
- Get promoted to Director

## Quote
"I spend more time coordinating than creating."

## Jobs To Be Done
- When I [situation], I want to [action], so I can [outcome]

## Problem: {Statement}

### Hypothesis
{Who} struggles with {what} because {why}

### Evidence Collected

| Type | Source | Finding |
|------|--------|---------|
| Interview | User 1 | "I spend 3 hours/week on this" |
| Interview | User 2 | "Would pay $50/month" |
| Forum | Reddit | 50 upvotes on complaint post |
| Review | G2 | "Missing feature X" (repeated 10x) |
| Search | Google | "solve X problem" - 5K/month |

### Assessment

| Criterion | Score | Evidence |
|-----------|-------|----------|
| Frequency | Weekly | Interviews |
| Intensity | 8/10 | Interviews |
| WTP | Yes | 4/5 would pay |
| Search | Medium | 5K/month |
| Competition | Yes | 3 competitors |

### Decision
**PROCEED** - Strong problem-solution fit

"{keyword} frustrating" site:reddit.com
"{competitor} alternative" site:reddit.com
"{product} review" 1-star
"I wish {tool} could"
"hate using {tool}"
"looking for {solution}"

## Topic: {Area}

### Sources Searched
- Reddit: r/x, r/y, r/z
- App Store: {app1}, {app2}
- Forums: {forum1}

### Pain Points Identified

| Theme | Frequency | Sample Quote | Intensity |
|-------|-----------|--------------|-----------|
| Slow sync | 23 mentions | "Takes forever to sync" | High |
| Missing feature X | 15 mentions | "Why doesn't it have X?" | Medium |
| Expensive | 12 mentions | "Not worth $99/month" | High |

### Key Insights
1. {insight 1}
2. {insight 2}

### Opportunity
{What solution addresses top pain points}

## Niche: {Name}

| Criterion | Score | Weight | Weighted | Justification |
|-----------|-------|--------|----------|---------------|
| Market Size | 7 | 25% | 1.75 | $80M SAM |
| Competition | 6 | 20% | 1.20 | 5 competitors |
| Barriers | 8 | 20% | 1.60 | Technical only |
| Profitability | 7 | 20% | 1.40 | SaaS margins |
| Your Fit | 9 | 15% | 1.35 | 10 yrs experience |
| **Total** | | | **7.30** | |

### Decision
**PROCEED WITH CAUTION** - Good opportunity, watch competition

### Risk Mitigation
- {risk 1}: {mitigation}
- {risk 2}: {mitigation}

## Industry: {Name}

### Current Red Ocean Factors
| Factor | Industry Level | Customer Value |
|--------|---------------|----------------|
| Price | High | Medium |
| Features | Many | Low (unused) |
| Support | 24/7 | Low (rarely needed) |

### Four Actions

#### Eliminate
- {factor}: Why? {reason}

#### Reduce
- {factor}: From {X} to {Y}

#### Raise
- {factor}: From {X} to {Y}

#### Create
- {new factor}: {description}

### New Value Curve
[Strategy canvas visualization]

### Blue Ocean Opportunity
{Description of uncontested space}

┌─────────────────────────┐
│     Customer Jobs       │
│  (tasks, problems)      │
├─────────────────────────┤
│     Pains               │
│  (obstacles, risks)     │
├─────────────────────────┤
│     Gains               │
│  (desired outcomes)     │
└─────────────────────────┘

┌─────────────────────────┐
│  Products & Services    │
│  (what we offer)        │
├─────────────────────────┤
│     Pain Relievers      │
│  (how we reduce pains)  │
├─────────────────────────┤
│     Gain Creators       │
│  (how we create gains)  │
└─────────────────────────┘

## Customer Segment: {Name}

### Customer Profile

#### Jobs
- Functional: {job}
- Emotional: {job}
- Social: {job}

#### Pains (ranked by intensity)
1. {pain} - 9/10
2. {pain} - 8/10
3. {pain} - 6/10

#### Gains (ranked by relevance)
1. {gain} - Essential
2. {gain} - Expected
3. {gain} - Desired

### Value Map

#### Products & Services
- {product/feature}
- {product/feature}

#### Pain Relievers
- {pain 1} → {how we relieve it}
- {pain 2} → {how we relieve it}

#### Gain Creators
- {gain 1} → {how we create it}
- {gain 2} → {how we create it}

### FIT Assessment
- Pain coverage: 2/3 top pains addressed
- Gain coverage: 2/3 top gains enabled
- **FIT Score: 80%**

## Project: {Description}

### Brand Attributes
- {attribute 1}
- {attribute 2}
- {attribute 3}

### Keywords
- Product: {words}
- Benefits: {words}
- Emotions: {words}

### Name Candidates

| Name | Strategy | .com | Meaning |
|------|----------|------|---------|
| {name} | Descriptive | Y/N | {why} |
| {name} | Invented | Y/N | {why} |
| {name} | Compound | Y/N | {why} |

### Top 3 Recommendations
1. {name}: {reasoning}
2. {name}: {reasoning}
3. {name}: {reasoning}

## Name: {name}

### Domain Availability

| Domain | Status | Price | Notes |
|--------|--------|-------|-------|
| {name}.com | Available | $12/yr | Register now |
| {name}.io | Taken | - | Active site |
| {name}.co | Premium | $2,500 | Parked |

### Social Handles

| Platform | Handle | Status |
|----------|--------|--------|
| Twitter | @{name} | Available |
| GitHub | {name} | Taken |
| LinkedIn | /company/{name} | Available |

### Trademark Check
- USPTO: No conflicts found
- Note: Not legal advice, consult attorney

### Recommendation
**Register {name}.com and @{name} immediately**

### Alternatives if Unavailable
1. get{name}.com
2. {name}app.com
3. {name}.io

## Product: {Name}

### Competitor Pricing

| Competitor | Model | Price Range | Notes |
|------------|-------|-------------|-------|
| {name} | Subscription | $X-Y/mo | |
| {name} | Freemium | Free-$X | |

### Value Analysis
- Cost of problem: $X/month
- Time saved: X hours/month
- Value captured: 10-20% of savings

### Recommended Model
**Tiered Subscription**

### Pricing Tiers

| Tier | Price | Features | Target |
|------|-------|----------|--------|
| Free | $0 | {features} | Try before buy |
| Pro | $19/mo | {features} | Individuals |
| Team | $49/mo | {features} | Small teams |
| Enterprise | Custom | {features} | Large orgs |

### Justification
- Freemium drives awareness
- Pro captures 80% of revenue
- Enterprise for large accounts

1. Warm-up (5 min)
   - Build rapport
   - Set expectations
   ↓
2. Context (10 min)
   - Their role, background
   - Current situation
   ↓
3. Deep dive (20 min)
   - Pain exploration
   - Past behavior
   - Emotional triggers
   ↓
4. Concept test (10 min)
   - Show solution
   - Get reaction
   ↓
5. Wrap-up (5 min)
   - Willingness to pay
   - Referrals

## Interview: {Type}

### Preparation
- Hypothesis to test: {hypothesis}
- Key questions: 5 max
- Recording setup: {yes/no}

### Script

#### Warm-up
"Thanks for joining. I'm researching [topic]. No right/wrong answers, just honest feedback."

#### Context
"Tell me about your role."
"Walk me through a typical day."

#### Deep Dive
"Tell me about the last time you [problem]."
"What happened? What did you do?"
"How did that make you feel?"
"What would you change?"

#### Concept Test
[Show prototype/concept]
"What do you think this is?"
"Would this help? How?"
"What's missing?"

#### Wrap-up
"Would you pay for this? How much?"
"Who else should I talk to?"

### Notes Template

| Question | Answer | Insight |
|----------|--------|---------|
| {question} | {verbatim} | {interpretation} |