shipspec

For anyone building apps with AI

Get your app built right the first time.

Describe your app idea. Answer a few simple questions. Get a clear plan and ready-made files that Claude Code, Cursor or Codex can follow step by step — so you spend less time fixing what your AI got wrong.

Free · 3 plans a month · No card needed

Why AI builds the wrong thing

Most ideas leave out the details. Your AI fills the gaps with guesses. Shipspec finds the gaps first:

An appiPhone or web? that helpshow, exactly? peoplewho is it for? cook with what’s in the fridge.what does the user do first?

Gaps answered · plan ready

Each red mark becomes one quick question. Your answers turn into a plan your AI can’t misread.

What you get

A clear plan, not a wall of text.

What to build first, what can wait, what could go wrong, and how you’ll know each step is done — plus the pages AI usually forgets, like sign-in, password reset, privacy policy and terms.

Overview

§1

Snap your fridge, get three recipes you can cook tonight. Target: 500 paying users by month 6 (assumed).

500 users × $6 ≈ $3K a month

Not for: restaurant kitchens.

the numbers add up ✓

First version

§4
FeatureNow?Notes
Fridge photoYesThe core loop
Shopping listYesFrom missing items
AndroidNoAfter 300 iPhone subscribers
Meal plansNoVersion 2

every “later” has a reason ✓

Risks

§7
  • The photo misses some items

    → Let people add items by typing before recipes load.

  • Recipes start to repeat

    → Rotate by cuisine and skip anything rated down.

every risk has a backup plan ✓

Build plan

§9
  • Wk 1Upload a photo → items listed on a test phone
  • Wk 2Tap “cook” → 3 recipes in under 5 seconds
  • Wk 3A tester subscribes in test mode in under 2 min
  • Wk 420 beta testers cook one recipe each

every step has a finish line ✓

Sources

§11
  • App Store Review Guidelines · checked
  • Payment provider pricing · checked
  • Household food-waste figures (to verify)

no made-up facts ✓

Checked before you build

Every plan gets a score, and a to-do list.

91/100

  • Has a clear goalpass
  • Says who it’s not forpass
  • Says when “later” features comepass
  • Every risk has a backup planpass
  • Goals have real numberspass
  • Every step has a finish linepass
  • Guesses are clearly markedpass
  • Says what happens when things breakpass
  • Says how it launchespass
  • Spells out security rulespass
  • Includes sign-in and legal pagespass
  • Has speed targetsfix

fix → Add a speed target, like “results show up in under 3 seconds on an iPhone 13”. Shipspec tells you exactly what’s missing.

Your AI knows exactly what to do.

You get a folder of ready-made files. Open it in Claude Code, Cursor or Codex and paste one message. Your AI builds the app one step at a time, checks its work, and stops to show you.

your-app/
└ AGENTS.mdrules your AI must follow
└ CLAUDE.mdsetup for Claude Code
└ PROGRESS.mdremembers progress between sessions
└ START_HERE.mdthe one message you paste
└ docs/
└ PRD.mdyour full plan
└ human-setup.mdthings only you can do: logins, keys
└ test-scenarios.mdtests, including what can go wrong
└ milestones/
└ M1-photo-upload.mdstep 1: what to build, how to check it
└ M2-recipes.md
└ M3-paywall.md
└ M4-launch.mdsign-in, privacy policy, terms, 404s

Free to start. Unlimited with your own Claude.

Free

$0

3 plans a month

  • ✓The questions, the plan and the files
  • ✓Security rules and legal pages included
  • ✓Redo a plan once if you want changes
Get my plan

Pro

More

plans every month

  • ✓Everything in Free
  • ✓More plans each month
  • ✓Cancel any time
See Pro

Bring your own AI

∞

plans, using the Claude, ChatGPT or Cursor account you already pay for

Terminal
$ claude mcp add --transport http shipspec https://shipspec.app/api/mcp
> use shipspec to write a PRD for my idea…
Connection guide →

Questions, answered.

What is Shipspec?

Shipspec turns an app idea into a clear plan and a folder of ready-made files that AI coding tools follow step by step. You describe the idea, answer 3–6 questions, and get the plan, the build steps, the tests, and the security and legal pages your app needs.

Which AI coding tools does it work with?

Claude Code, Cursor and Codex, plus any AI coding tool that reads files in your project. The files include AGENTS.md, which these tools read on their own, and CLAUDE.md for Claude Code.

Is Shipspec free?

Yes. You get 3 plans a month for free, no card needed. You can also make unlimited plans inside your own Claude, ChatGPT or Cursor account by connecting the Shipspec MCP.

Do I need to know how to code?

No. The plan is written in plain language, and your AI coding tool does the building. You paste one message to start, then approve each step when it stops to show you.

Why does AI build the wrong thing without a plan?

Most app ideas leave out details like who it's for, what happens first, and what must never happen. AI coding tools fill those gaps with guesses. Shipspec asks about the gaps first and writes the answers into rules and steps the AI follows.

What happens to my idea?

Your idea is sent to the AI model that writes the plan. Your draft is saved in your browser, and when you're signed in we store only how many plans you've used, not the plan itself.

Tell us your idea. Get a plan your AI can follow.

Free · 3 plans a month · No card needed