Spec-Driven Development for the AI Era

Stop Guessing.
Start Specifying.

ZeeSpec turns 60 structured questions across 6 dimensions into a complete system specification — leaving AI no room to guess, invent, or hallucinate.

▶ Start Your Spec ↓ Learn the Method
60
Questions
6
Dimensions
1h
Time Investment
∞
Clarity for AI
The Root Problem

AI fills what you don't define

User stories were designed for humans. Humans compensate for gaps with judgment. AI does not — it completes patterns. And when the pattern is vague, the output becomes plausible, not correct.

❌ User Story (Vague Input)

"As a library member, I want to cancel my book loan so I can return it early."

✗ AI might simply delete the Loan record — no audit trail, no history.
✗ No mention of late fees, so AI ignores the business rule blocking checkout.
✗ No data retention rule — AI doesn't know loans must be archived 7 years.
✗ Silent assumptions become technical debt you discover months later.
✅ ZeeSpec (Precise Input)
WHAT A Loan status can only be CANCELLED if it has no associated late fees outstanding.
WHO Only the Member who owns the loan or Library Staff can cancel it.
WHY All financial transactions must be archived for 7 years — cancellation updates status, never deletes.
HOW On cancel: set status → CANCELLED, write audit log entry, trigger late-fee check. Never hard delete.
💡
The Zachman Framework, modernized. ZeeSpec applies the 5W1H model (What, Where, When, Who, Why, How) to create a coordinate system for your system's soul. By covering all six dimensions, you ensure AI has complete bounds — leaving no dark corners where hallucinations can breed.
Interactive Explorer

The 60 Questions

Click any dimension to expand all 10 questions. Check them off as you think through your answers — your progress saves automatically.

0 / 60

Questions Explored

Check off each question as you think through your system. When you hit 60, your spec is complete and AI has no room to guess.

Interactive Spec Builder

Write Your Spec Here

Type your answers directly — they auto-save to your browser. When you're done, hit Copy Spec and paste it into any AI coding assistant.

The Workflow

From spec to system in 3 steps

Use the spec builder above, or use the CLI tool to scaffold your .spec/ folder and generate AGENTS.md.

1
🏗️
Initialize

Scaffold a .spec/ folder with 8 descriptive template files: what.md, how.md, who.md, when.md, where.md, why.md, upstream.md, downstream.md.

npx spec-cli init 📋
→
2
✍️
Describe in Plain English

Open the .md files and answer the 60 questions in plain English — or use the Spec Builder above. No schemas, no DSLs. Just describe your system to a smart colleague.

.spec/what.md, who.md, why.md...
→
3
🚀
Generate & Build

Generate your master prompt. Paste into Cursor, Claude Code, or Windsurf. Watch AI generate a complete, aligned system — deterministically, not probabilistically.

npx spec-cli generate 📋
The Rule

For every question — if you can't answer it, your system is undefined. If you skip it, AI will decide for you.

IF you can't answer it →
Your system is undefined
IF you skip it →
AI will decide for you
IF you answer it clearly →
AI becomes deterministic

Most specs describe systems. ZeeSpec forces decisions. Once decisions are explicit, AI stops being creative — it starts being correct.

🎯 Answer the 60 Questions