Entry point:
/faion-net— invoke this skill for automatic routing to the appropriate domain.
Research Domain Skill
Communication: User's language. Docs: English.
Purpose
Orchestrate all research and discovery activities for product/startup development. Coordinates 2 specialized sub-skills for comprehensive research coverage.
Context Discovery
Auto-Investigation
Check for existing research and product context:
| Signal | How to Check | What It Tells Us |
|---|---|---|
.aidocs/product_docs/ | Glob("**/.aidocs/product_docs/*") | Product docs exist |
market-research.md | Glob("**/market-research.md") | Market research done |
competitive-analysis.md | Glob("**/competitive-analysis.md") | Competitors analyzed |
user-personas.md | Glob("**/user-personas.md") | Personas defined |
constitution.md | Glob("**/.aidocs/constitution.md") | Product defined |
| Landing page | Glob("**/pages/index.*") | Positioning visible |
Read existing assets:
- Check landing page for current positioning/messaging
- Read constitution.md for product context
- Check any existing research docs
Discovery Questions
Use AskUserQuestion to understand research needs.
Q1: Research Stage
question: "What stage of research are you in?"
header: "Stage"
multiSelect: false
options:
- label: "Exploring ideas (no specific direction)"
description: "Generate and evaluate new ideas"
- label: "Have an idea, need validation"
description: "Test if idea is worth pursuing"
- label: "Committed, need market intelligence"
description: "Understand market, competitors, pricing"
- label: "Building, need user insights"
description: "Understand users for better product"
Routing:
- "Exploring ideas" →
Skill(faion-market-researcher)→ idea-generation - "Need validation" →
Skill(faion-user-researcher)→ problem-validation - "Market intelligence" →
Skill(faion-market-researcher)→ competitors, TAM, pricing - "User insights" →
Skill(faion-user-researcher)→ personas, JTBD, pain points
Q2: Research Focus (if market intelligence)
question: "What do you need to understand?"
header: "Focus"
multiSelect: true
options:
- label: "Market size (TAM/SAM/SOM)"
description: "How big is the opportunity?"
- label: "Competitors & alternatives"
description: "Who else solves this problem?"
- label: "Pricing benchmarks"
description: "What do customers pay for similar?"
- label: "Industry trends"
description: "Where is the market heading?"
Routing:
- "Market size" → tam-sam-som-analysis
- "Competitors" → competitor-analysis
- "Pricing" → pricing-research
- "Trends" → trend-analysis
Q3: User Research Type (if user insights)
question: "What user insights do you need?"
header: "Insights"
multiSelect: true
options:
- label: "Who are my users? (personas)"
description: "User profiles and segments"
- label: "What problems do they have?"
description: "Pain points and frustrations"
- label: "What are they trying to achieve?"
description: "Jobs-to-be-done, goals"
- label: "Would they pay for a solution?"
description: "Willingness to pay, value perception"
Routing:
- "Personas" → persona-building
- "Problems" → pain-point-research
- "Achieve" → jobs-to-be-done
- "Pay" → value-proposition + pricing-research
Q4: Evidence Standards
question: "What would convince you the research is solid?"
header: "Evidence"
multiSelect: false
options:
- label: "Quick directional insights"
description: "Enough to make a decision, move fast"
- label: "Backed by data sources"
description: "Links to research, reports, data"
- label: "Primary research (interviews/surveys)"
description: "Talk to real users/customers"
Context impact:
- "Quick" → Web search, secondary research, fast output
- "Backed by data" → Include sources, citations, methodology
- "Primary research" → Interview guides, survey design, synthesis
Architecture
faion-researcher (orchestrator)
├── faion-market-researcher (22 methodologies)
│ ├── Market sizing (TAM/SAM/SOM)
│ ├── Competitor analysis
│ ├── Pricing research
│ ├── Trend analysis
│ ├── Niche evaluation
│ ├── Business model planning
│ └── Idea generation
└── faion-user-researcher (21 methodologies)
├── Persona building
├── User interviews
├── Pain point research
├── Jobs-to-be-done
├── Problem validation
├── Value proposition design
└── Survey design
Total: 43 methodologies across 2 sub-skills
Quick Decision Tree
| If you need... | Route to Sub-Skill |
|---|---|
| Market Intelligence | |
| Market size (TAM/SAM/SOM) | faion-market-researcher |
| Competitors & gaps | faion-market-researcher |
| Pricing benchmarks | faion-market-researcher |
| Market trends | faion-market-researcher |
| Niche evaluation | faion-market-researcher |
| Business models | faion-market-researcher |
| Generate ideas | faion-market-researcher |
| User Understanding | |
| User profiles | faion-user-researcher |
| Pain points | faion-user-researcher |
| User motivations (JTBD) | faion-user-researcher |
| Value proposition | faion-user-researcher |
| Interview questions | faion-user-researcher |
| Problem validation | faion-user-researcher |
| Survey design | faion-user-researcher |
| Full Research | |
| Complete product research | Both (sequential) |
Sub-Skills (2)
faion-market-researcher
Focus: Market & business intelligence
| Capability | Methodologies |
|---|---|
| Market Analysis | TAM/SAM/SOM, market sizing, trends |
| Competitive Intel | Competitor analysis, competitive intelligence |
| Business Planning | Models, niche eval, risk, distribution |
| Pricing | Research, benchmarking |
| Ideas | Generation, frameworks |
Files: 22 | Location: faion-market-researcher/
faion-user-researcher
Focus: User research & validation
| Capability | Methodologies |
|---|---|
| Personas | Building, segmentation, AI-assisted |
| Interviews | Methods, analysis, at-scale |
| Pain Points | Research, validation |
| JTBD | Framework, motivations |
| Validation | Methods, problem-solution fit |
| Value Prop | Design, canvas |
Files: 21 | Location: faion-user-researcher/
Agents (2)
| Agent | Model | Purpose | Modes |
|---|---|---|---|
| faion-research-agent | opus | Research orchestrator | ideas, market, competitors, pains, personas, validate, niche, pricing, names |
| faion-domain-checker-agent | sonnet | Domain availability verification | - |
Details: agent-invocation.md
Research Modes (9)
| Mode | Output | Sub-Skill Used |
|---|---|---|
| ideas | idea-candidates.md | market-researcher |
| market | market-research.md | market-researcher |
| competitors | competitive-analysis.md | market-researcher |
| pricing | pricing-research.md | market-researcher |
| niche | niche-evaluation.md | market-researcher |
| personas | user-personas.md | user-researcher |
| pains | pain-points.md | user-researcher |
| validate | problem-validation.md | user-researcher |
| names | name-candidates.md | market-researcher |
Core Workflows
1. Idea Discovery
Context → Generate Ideas → Select → Pain Research → Niche Eval → Results
Sub-skills: market-researcher (ideas, niche) + user-researcher (pains)
2. Product Research
Parse Project → Read Docs → Select Modules → Sequential Execution → Summary
Sub-skills: market-researcher (market, competitors, pricing) + user-researcher (personas, validate)
3. Project Naming
Gather Concept → Generate Names → Select → Check Domains → Results
Sub-skill: market-researcher (naming)
Details: workflows.md
Quick Reference
| Topic | File | Description |
|---|---|---|
| Navigation | CLAUDE.md | Entry point, when to use |
| Agents | agent-invocation.md | Agent syntax, modes |
| Workflows | workflows.md | Research workflows |
| Frameworks | frameworks.md | 7 Ps, JTBD, TAM/SAM/SOM |
| Methodologies | methodologies-index.md | Full index |
Output Files
All outputs go to .aidocs/product_docs/:
| Module | Output File | Sub-Skill |
|---|---|---|
| Idea Discovery | idea-validation.md | market-researcher |
| Market Research | market-research.md | market-researcher |
| Competitors | competitive-analysis.md | market-researcher |
| Pricing | pricing-research.md | market-researcher |
| Niche | niche-evaluation.md | market-researcher |
| Personas | user-personas.md | user-researcher |
| Pain Points | pain-points.md | user-researcher |
| Validation | problem-validation.md | user-researcher |
| Summary | executive-summary.md | Both |
Integration
Entry Point
Invoked via /faion-net when intent is research-related:
if intent in ["idea", "research", "market", "competitors", "naming", "personas", "pricing"]:
invoke("faion-researcher")
Sub-Skill Invocation
# Market intelligence
invoke("faion-market-researcher", mode="market")
# User research
invoke("faion-user-researcher", mode="personas")
# Full research (sequential)
invoke("faion-market-researcher", mode="market")
invoke("faion-market-researcher", mode="competitors")
invoke("faion-user-researcher", mode="personas")
invoke("faion-user-researcher", mode="validate")
Next Steps
After research complete, offer:
- "Create GTM Manifest?" →
faion-marketing-manager - "Create spec.md?" →
faion-sdd - "Start development?" →
faion-software-developer
Rules
- Sequential execution - Run agents ONE BY ONE (not parallel)
- Sub-skill routing - Market topics → market-researcher, User topics → user-researcher
- Source citations - All research must include URLs
- Data quality - If not found → "Data not available"
faion-researcher v2.0 Orchestrator with 2 sub-skills Total: 43 methodologies | Agents: 2 | Modes: 9