Skip to content
For Claude Code · Cursor · any MCP agent

Build what you intended.

You can prompt an agent to build a feature. The harder part: knowing whether what it built is what you meant. IntentDocs defines what “correct” looks like — acceptance criteria your agent checks and you can verify — before the build starts.

Works before you open Cursor. Before a repo exists. An interview turns your idea into stories, data models, and acceptance criteria — wired to your agent via MCP so every session starts from the same plan.

Spec, the intentdocs mascot, waving

Hi, I'm Spec. I'll generate your specs and hand them to your agent via MCP. You get the build. I log what happened.

7-day trial·No CLI? Connect remotely·INTENT.md is yours to keep
Claude CodeCursorAny MCP AgentINTENT.MD v1.0 · CC BY19 Agent Tools
The problem

When intent is fuzzy, software gets expensive.

AI agents are powerful. But without the right context, they make the wrong assumptions — confidently, and at speed.

See why intent matters →

YOU TELL CURSOR

“Add account deletion.”

It doesn't know you decided deleted accounts need a 30-day recovery window.

YOU TELL CLAUDE

“Change checkout.”

It doesn't know you decided to keep the guest flow and never add coupon codes.

YOU TELL CODEX

“Fix the onboarding.”

It doesn't know onboarding must complete in under three screens.

The solution

From idea to implementation. One source of intent.

IntentDocs becomes the system of record for your product intent — available to every coding agent, every session, over MCP.

YOU — describe your idea
◉ INTENTDOCS — requirements · decisions · stories
AGENTS — Claude Code · Cursor · Codex
CODE >_
How it starts

You don't need to write a 40-page PRD.

Tell IntentDocs what you're trying to build. It interviews you like a great product partner — asking the questions that expose missing decisions, edge cases and assumptions.

See an example interview →

◉ INTENTDOCS

Should existing users who authenticate with email be able to connect a Google account with the same email?
What happens if someone tries to register a Google account whose email already exists in the system?

RESULT

REQUIREMENT

Users can authenticate without passwords.

DECISION

Do not introduce password credentials.

CONSTRAINT

Existing accounts must match by verified email.

ACCEPTANCE

Google sign-in works from signup and login.
It gets smarter over time

Your agent's memory resets. Your product's doesn't.

Every decision, constraint and requirement becomes durable context — available to whichever agent you use next.

SEP

Why we chose passwordless auth

OCT

Why orgs have one owner

NOV

Why billing uses Stripe Checkout

JAN

Why account deletion takes 30 days

TODAY

“Refactor authentication”

Claude already has the decisions that matter.

The difference is massive

WITHOUT INTENTDOCS

PromptAgent reads codeAgent assumesYou correct itAgent retriesSomething gets missed

WITH INTENTDOCS

IntentAgent gets contextConstraints understoodImplementationCriteria checkedDone

Never heard of MCP?

It's a cable between your spec and your agent.

You paste one config block once. From then on your agent can read the plan and write progress back — no copy-paste, nothing going stale.

YOU

Plan in the UI

MCP SERVER

One source of truth

AGENT

Builds + reports

Prompts only

Your agent is guessing — and so are you.

×Scope invented mid-session, requirements quietly skipped
×Context files go stale the moment the plan changes
×No record of what shipped, or why it was built that way

With IntentDocs

A spec it reads live, and reports back into.

Stories, data model and acceptance criteria over MCP
Edit in the UI — the agent sees it on its next call
Every criterion checked, every decision logged
01

Three steps, about ten minutes.

Then every session your agent starts already knowing the plan.

Step 1

Talk through the idea

An interview turns it into a story map, data model, acceptance criteria and build order.

interview → blueprint
4 activities · 12 stories
38 acceptance criteria

Step 2

Paste the config

One block, once. Your agent gains 19 tools for reading and reporting.

{
  "mcpServers": {
    "intentdocs": {
      "command": "npx",
      "args": ["intentdocs", "mcp"]
    }
  }
}

Step 3

Build story by story

Criteria get checked off, decisions get logged, and you can see it all in Review.

8 stories shipped
26/26 criteria pass
! 2 unplanned changes flagged
02

You think in the UI. Your agent works in the repo.

Same source of truth, two interfaces. Drag a story, change a priority, rewrite a criterion — the agent picks it up on its next call.

Story map canvas

IntentDocs story map canvas — drag-and-drop activities and stories

Review — built vs planned

IntentDocs review tab — what was built versus what was planned

What the agent can do

start_story / complete_story
report_criteria pass · fail
add_criteria / replace_criteria
log_decision / add_note
+ 13 more
03

The part prompts can't give you: a record.

Evaluability

See acceptance criteria checked off story by story — and deviations flagged. Know if it's right without reading the code.

Repeatability

Edit the spec, not the prompt. The agent adjusts on its next run.

Portability

INTENT.md sits in your repo, in plain markdown. Switch agents whenever you want.

Built for founders building with AI — before the first commit.

You can generate code. You can prompt an agent to build a feature. What's hard: knowing whether what it built is what you actually meant. IntentDocs is the spec layer that defines “correct” before the agent starts — readable acceptance criteria, story by story, that you can check without reading the code. Senior engineering rigour without the senior engineer.

04

Start free. Pay when it's load-bearing.

Trial

7 days

£0

  • 1 project
  • Full agent interview
  • CLI access
  • Every template
  • No card required
Get started

Pro

Popular

Most popular

£29/mo

Billed £290/year

  • Up to 10 projects & unlimited stories
  • intentdocs CLI
  • Custom spec templates
  • Priority support
Start Pro →

Team

For teams

£19/seat/mo

Billed £190/seat/year

  • Everything in Pro
  • Team workspace
  • Workspace invites
  • Shared spec templates
Talk to us

All plans include the intentdocs CLI, story map canvas, MCP server, and spec sync

I've never set up an MCP server.

You won't have to. Run one command, or paste one config block — the remote option needs no CLI at all.

Am I locked in?

No. INTENT.md is an open, CC-BY format in plain markdown, committed to your repo. It works without an account.

Does this slow me down?

Ten minutes up front replaces the re-explaining you do every session — and the rework when the agent guesses wrong.

I don't have a codebase yet. Does this work?

That's exactly when to start. IntentDocs works before the first line of code — the interview produces acceptance criteria, and you give the spec to your agent when you're ready to build.

Spec, the intentdocs mascot, waving hello

Give your agent something to build against.

Spec your next feature in ten minutes, then let Claude Code do the rest.

Start free — no card →