Write It Down First — Spec-Driven Building with AI, for People Who Hate Rewrites (PDF Guide)

Your project worked at version one. Then you asked for one more feature, and the whole thing quietly came apart. This book is about the habit that ends that loop: writing down what you want before the AI writes any code.

Write It Down First is a 24-page field guide to spec-driven building with an AI assistant, for people who hate rewrites. It shows you how a one-page plain-English spec — a short list of what the thing is, how it behaves, and what "done" means — catches the problems on paper, where they are cheap to fix, instead of in code, where they are not. You draft the spec with the AI, judge it like an editor, turn it into a small task list, and build one step at a time.

WHAT'S INSIDE

• The fix-it loop, diagnosed — why describe-and-hope collapses at version two

• What a useful spec actually contains: the four things that belong on the page, and the two that do not

• The spec conversation: drafting with the assistant, then reading the draft like an editor with a judging checklist

• From spec to plan: turning agreed decisions into an ordered, checkable build

• The task list: one small step at a time, each with a "done means" you can verify

• A full worked example built from spec to finished feature, so you see the whole method once

• Keeping the plan honest across sessions, and an honest chapter on when spec-first is overkill

• A plain-language glossary of every term

HONEST NOTES

The examples use a paid AI assistant (from roughly US$20/month as of July 2026), but the method is tool-neutral and works with any assistant, including free tiers. Tool names and screens were last reviewed July 2026; the spec-first habit itself is the durable part and does not go stale. No invented statistics and no customer stories.

Guidance, not gospel — this is a practical field guide, not professional or financial advice.

Drafted with AI assistance and then reviewed and curated by a real person who builds this way daily.

Instant download. A5 pages, designed for screen reading; prints cleanly on A4 or US Letter. Personal use only.

First Edition — July 2026.

Questions? Reach us at calmkitco.com.