Free & open source on npm

The AI builds it.
You decide what.

Turn one sentence into a structured specification that makes Lovable, Bolt, Cursor, and Claude Code all build the same thing. Your design. Every time.

$ npm install -g stoa-mcp copy
GitHub
The experiment

Same prompt. 4 AI tools. Twice.

One sentence: “Personal finance tracker with categories.” First without a spec. Then with one.

Without a spec
Lovable without spec
Lovable — green fintech
v0 without spec
v0 — white, Supabase
With a Stoa spec
Lovable with spec
Lovable — dark + gold ✓
v0 with spec
v0 — dark + gold ✓
The problem was never the AI. It was what we asked for.
How it works

One sentence in. Full spec out.

A 5-stage pipeline that transforms ideas into structured, executable specifications.

1
Problem Statement
Expands your sentence into a full spec — data models, file structure, design tokens from your moodboard.
2
Acceptance Criteria
What “done” means. Specific, verifiable conditions.
3
Constraints
MUSTs, MUST NOTs, failure modes. Your dependencies and past lessons injected.
4
Decomposition
Complex tasks broken into ordered subtasks. Simple ones pass through.
5
Blind Test Scenarios
GIVEN/EXPECTED tests the AI never sees. You verify after the build.
Design intent

4 lines. Your entire design system.

Define your look once. Every spec includes your colors, layout, and typography automatically.

# Design Direction
Minimal and dark like Linear

# Colors
Primary: #E8C872
Background: #1A1A1A
Text: #F5F5F5

# Layout
Sidebar left, main content right

# Typography
Clean sans-serif, large headings

Extracted tokens

primary · #E8C872
background · #1A1A1A
text · #F5F5F5
Features

Everything a spec needs.

Moodboard

Colors, layout, typography, UI library. Defined once, injected into every spec.

Project Awareness

Scans your codebase. Second refine says “modify Dashboard.tsx” not “build from scratch.”

Clipboard Auto-Copy

After refine, the spec is on your clipboard. Cmd+V into any tool. Zero friction.

Blind Test Scenarios

GIVEN/EXPECTED tests generated per spec. Walk through them after the build.

Guardrails

“Don’t delete code.” “Run tests.” “Ask when unclear.” Rules applied to every refine.

Lessons Learned

Past mistakes auto-grow into constraints. Your project gets smarter with every build.

Quickstart

3 commands to your first spec.

# Install
npm install -g stoa-mcp

# Initialize your project
stoa init

# Edit your moodboard
stoa edit moodboard

# Refine
stoa refine "Personal finance tracker with categories"

# Spec copied to clipboard — paste into any AI tool

Stop prompting. Start specifying.

Open source. Free. Works with any AI coding tool.

npm install -g stoa-mcp

MIT License · TypeScript · No API key required (clipboard mode)

Coming Soon

The CLI is just the beginning.

The Stoa desktop app adds visual spec editing, one-click builds, auto-fix loops, blind test verification, and session history. Same pipeline. Full GUI.