Skip to content

Commit ed77697

Browse files
24601claude
andcommitted
docs: add domain-specific use cases to README
Show non-obvious uses: trading analysis, competitive intelligence, architecture decisions, design research, security audit prep, compliance research, market sizing. Positions the tool beyond "research a topic" into expert-grade domain synthesis. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 4deda42 commit ed77697

File tree

1 file changed

+71
-0
lines changed

1 file changed

+71
-0
lines changed

README.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,77 @@ uv run scripts/research.py start "How does auth work?" --context ./src --output
104104
uv 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

109180
First-time setup for humans and agents:

0 commit comments

Comments
 (0)