@@ -104,6 +104,77 @@ uv run scripts/research.py start "How does auth work?" --context ./src --output
104104uv run scripts/research.py start " Analyze the Python code" --context ./src --context-extensions py,md
105105```
106106
107+ ## Use Cases
108+
109+ This tool turns any AI agent into a domain specialist. The async, multi-step synthesis produces expert-grade output -- not search results.
110+
111+ ### Trading & Finance (OpenClaw, Pi, any agent)
112+
113+ ``` bash
114+ # Make your agent a trading analyst
115+ uv run scripts/research.py start \
116+ " Analyze NVDA: bull/bear thesis, valuation metrics, institutional positioning, and risk factors" \
117+ --output nvda-analysis.md
118+
119+ # Due diligence grounded in your portfolio
120+ uv run scripts/research.py start \
121+ " Evaluate this portfolio for concentration risk and sector exposure" \
122+ --context ./portfolio.csv --output due-diligence.md
123+ ```
124+
125+ ### Competitive Intelligence
126+
127+ ``` bash
128+ # Deep-dive a competitor using your own product docs as context
129+ uv run scripts/research.py start \
130+ " How does Competitor X compare to our product? Where are we ahead, where are we behind?" \
131+ --context ./docs --output competitive-analysis.md
132+ ```
133+
134+ ### Software Architecture (Claude Code, Codex, Amp)
135+
136+ ``` bash
137+ # Research trade-offs for an architecture decision
138+ uv run scripts/research.py start \
139+ " Compare event sourcing vs CQRS vs traditional CRUD for our domain model. \
140+ Which approach fits best given our codebase?" \
141+ --context ./src --output adr-research.md
142+
143+ # Security audit prep grounded in your dependencies
144+ uv run scripts/research.py start \
145+ " Research known CVEs and threat models relevant to our dependency tree" \
146+ --context ./package-lock.json --output security-research.md
147+ ```
148+
149+ ### Design & UX Research
150+
151+ ``` bash
152+ # Research design patterns grounded in your existing styles
153+ uv run scripts/research.py start \
154+ " Research accessible color systems, type scales, and motion design principles \
155+ for a dark-first design system" \
156+ --context ./src/styles --output design-research.md
157+ ```
158+
159+ ### Research & Analysis (any agent)
160+
161+ ``` bash
162+ # Academic-style literature review
163+ uv run scripts/research.py start \
164+ " Systematic review of retrieval-augmented generation architectures published in 2025-2026" \
165+ --report-format comprehensive --output rag-review.md
166+
167+ # Market sizing for a product idea
168+ uv run scripts/research.py start \
169+ " TAM/SAM/SOM analysis for AI-powered code review tools targeting enterprise" \
170+ --output market-sizing.md
171+
172+ # Regulatory compliance research grounded in your architecture
173+ uv run scripts/research.py start \
174+ " What SOC 2 Type II controls apply to our system architecture?" \
175+ --context ./docs/architecture --output compliance-research.md
176+ ```
177+
107178## Onboarding
108179
109180First-time setup for humans and agents:
0 commit comments