Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 19 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,30 @@
[![npm downloads](https://img.shields.io/npm/dm/tweakidea.svg)](https://www.npmjs.com/package/tweakidea)
[![license](https://img.shields.io/npm/l/tweakidea.svg)](LICENSE)

Stress-test a startup idea across 14 weighted dimensions — with evidence grades, assumption tracking, and three rewrites targeting your weakest scores.
An independent second opinion on your startup idea. Free, evidence-backed, ready in 10 minutes.

```bash
npx tweakidea
```

**What you get:**

- **A scorecard** — verdict (PIVOT / GO / KILL), weighted score, letter-graded evidence
- **A 14-dimension breakdown** — per-dim scores with what's strong, what's weak, what's untested
- **An assumption ledger** — every untested claim in your idea, surfaced so you know what to validate next
- **A shareable HTML report** — opens in your browser, easy to revisit

**Why not just ask ChatGPT?**

- 14 evaluators run in parallel — one per dimension
- Each runs its own independent targeted web search and cites sources
- Every untested assumption in your idea is surfaced
- Output is a structured beautiful scorecard you can revisit and share, not a one-shot paragraph

Browse full interactive reports: [Airlock](https://ephx.dev/reports/airlock) · [Mirror](https://ephx.dev/reports/mirror) · [Giftwrap](https://ephx.dev/reports/giftwrap)

[![TweakIdea HTML report — Mirror](assets/report.png)](https://ephx.dev/reports/mirror)

## Why I built this

An idea dies from what you don't verify. TweakIdea runs an idea through 14 weighted dimensions — pain intensity, willingness to pay, solution gap, founder-market fit, and ten more — each scored with cited web research. Fourteen Sonnet evaluators work in parallel; Opus merges the results into a scorecard with strengths, weaknesses, and three rewrites targeting the weakest dimensions. The output names what you haven't tested yet. It doesn't tell you to quit your job.
Expand Down Expand Up @@ -55,12 +73,6 @@ Claude: [three rewrites — small reframe, medium reshape, big reimagine]
[paste any rewrite into /tweak:evaluate to re-score]
```

## Example reports

Browse full interactive reports: [Airlock](https://ephx.dev/reports/airlock) · [Mirror](https://ephx.dev/reports/mirror) · [Giftwrap](https://ephx.dev/reports/giftwrap)

[![TweakIdea HTML report — Mirror](assets/report.png)](https://ephx.dev/reports/mirror)

## The 14 Dimensions

| Weight | Dimension | What it measures |
Expand Down
Loading