Skip to content

Commit cd3b35a

Browse files
hesamsheikhhesamsheikh
authored
Merge pull request #38 from zychenpeng/add-pre-build-idea-validator
Add use case: Pre-Build Idea Validator (idea-reality-mcp)
2 parents 5750847 + c997bfb commit cd3b35a

File tree

2 files changed

+105
-0
lines changed

2 files changed

+105
-0
lines changed

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,7 @@ Solving the bottleneck of OpenClaw adaptation: Not ~~skills~~, but finding **way
7878
| [AI Earnings Tracker](usecases/earnings-tracker.md) | Track tech/AI earnings reports with automated previews, alerts, and detailed summaries. |
7979
| [Personal Knowledge Base (RAG)](usecases/knowledge-base-rag.md) | Build a searchable knowledge base by dropping URLs, tweets, and articles into chat. |
8080
| [Market Research & Product Factory](usecases/market-research-product-factory.md) | Mine Reddit and X for real pain points using the Last 30 Days skill, then have OpenClaw build MVPs that solve them. |
81+
| [Pre-Build Idea Validator](usecases/pre-build-idea-validator.md) | Automatically scan GitHub, HN, npm, PyPI, and Product Hunt before building anything new — stop if the space is crowded, proceed if it's open. |
8182
| [Semantic Memory Search](usecases/semantic-memory-search.md) | Add vector-powered semantic search to your OpenClaw markdown memory files with hybrid retrieval and auto-sync. |
8283

8384
## Finance & Trading

‎usecases/pre-build-idea-validator.md‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
# Pre-Build Idea Validator
2+
3+
Before OpenClaw starts building anything new, it automatically checks whether the idea already exists across GitHub, Hacker News, npm, PyPI, and Product Hunt — and adjusts its approach based on what it finds.
4+
5+
## What It Does
6+
7+
- Scans 5 real data sources (GitHub, Hacker News, npm, PyPI, Product Hunt) before any code is written
8+
- Returns a `reality_signal` score (0-100) indicating how crowded the space is
9+
- Shows top competitors with star counts and descriptions
10+
- Suggests pivot directions when the space is saturated
11+
- Works as a pre-build gate: high signal = stop and discuss, low signal = proceed
12+
13+
## Pain Point
14+
15+
You tell your agent "build me an AI code review tool" and it happily spends 6 hours coding. Meanwhile, 143,000+ repos already exist on GitHub — the top one has 53,000 stars. The agent never checks because you never asked, and it doesn't know to look. You only discover competitors after you've invested significant time. This pattern repeats for every new project idea.
16+
17+
## Skills You Need
18+
19+
- [idea-reality-mcp](https://github.com/mnemox-ai/idea-reality-mcp) — MCP server that scans real data sources and returns a competition score
20+
21+
## How to Set It Up
22+
23+
1. Install idea-reality-mcp:
24+
25+
```bash
26+
uvx idea-reality-mcp
27+
```
28+
29+
2. Add the MCP server to your OpenClaw config:
30+
31+
```json
32+
{
33+
"mcpServers": {
34+
"idea-reality": {
35+
"command": "uvx",
36+
"args": ["idea-reality-mcp"]
37+
}
38+
}
39+
}
40+
```
41+
42+
3. Add this to your OpenClaw agent instructions:
43+
44+
```text
45+
Before starting any new project, feature, or tool, always run idea_check first.
46+
47+
Rules:
48+
- If reality_signal > 70: STOP. Report the top 3 competitors with star counts.
49+
Ask me if I want to proceed, pivot, or abandon.
50+
- If reality_signal 30-70: Show me the results and pivot_hints.
51+
Suggest a niche angle that existing projects don't cover.
52+
- If reality_signal < 30: Proceed to build.
53+
Mention that the space is open.
54+
- Always show the reality_signal score and top competitors before writing any code.
55+
```
56+
57+
## Real World Example
58+
59+
**You:** "Build me a CLI tool for AI code review"
60+
61+
OpenClaw runs `idea_check("AI code review tool")` and responds:
62+
63+
> **reality_signal: 90/100 (very high)**
64+
>
65+
> Top competitors:
66+
> 1. Gitea — 53,940 stars
67+
> 2. reviewdog — 9,104 stars
68+
> 3. Danger (Ruby) — 5,649 stars
69+
>
70+
> This space has 143,000+ related repos. The top players are mature and well-funded.
71+
>
72+
> **Pivot suggestions:**
73+
> - Focus on a specific language (Rust/Go-only AI code review)
74+
> - Target a specific framework (React/Vue component review)
75+
> - Target a specific industry (financial/medical code compliance review)
76+
>
77+
> Should I proceed with a differentiated angle, or pivot to something else?
78+
79+
**You:** "What about an MCP server for pre-build idea validation?"
80+
81+
> **reality_signal: 8/100 (very low)**
82+
>
83+
> 0 direct competitors found on PyPI or npm. GitHub has some tangentially related repos but none solve this exact problem.
84+
>
85+
> The space is wide open. Proceeding to build.
86+
87+
## Variations
88+
89+
- **Deep mode for serious decisions**: Use `depth="deep"` to scan all 5 sources in parallel (GitHub + HN + npm + PyPI + Product Hunt) for major project decisions.
90+
- **Batch validation**: Before a hackathon, give OpenClaw a list of 10 ideas and have it rank them by `reality_signal` — lowest score = most original opportunity.
91+
- **Web demo first**: Try without installing at [mnemox.ai/check](https://mnemox.ai/check) to see if the workflow fits your needs.
92+
93+
## Key Insights
94+
95+
- This prevents the most expensive mistake in building: **solving a problem that's already been solved**.
96+
- The `reality_signal` is based on real data (repo counts, star distributions, HN discussion volume), not LLM guessing.
97+
- A high score doesn't mean "don't build" — it means "differentiate or don't bother."
98+
- A low score means genuine white space exists. That's where solo builders have the best odds.
99+
100+
## Related Links
101+
102+
- [idea-reality-mcp GitHub](https://github.com/mnemox-ai/idea-reality-mcp)
103+
- [Web demo](https://mnemox.ai/check) (try without installing)
104+
- [PyPI](https://pypi.org/project/idea-reality-mcp/)

0 commit comments

Comments
 (0)