Developer field guide

Stop version two from collapsing by writing one page before the AI writes any code.

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

24 pages Screen-friendly A5, prints on A4 and US Letter Read on screen, or print Last reviewed July 2026 Version 2026-07

Your project worked at version one. Then you asked for one more feature, and the whole thing quietly came apart. This 24-page field guide teaches the habit that ends that loop: a one-page plain-English spec that catches problems on paper, where they are cheap to fix, instead of in code, where they are not — you draft it with the AI, judge it like an editor, turn it into a small task list, and build one step at a time.

Buy now · $11.24

Instant PDF download after checkout on Payhip. Nothing is shipped.

Cover of Write It Down First
Previews show each page at reduced resolution; the download is the full print-quality PDF.
Cover of Write It Down First
1 / 4

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

Who it's for

  • Builders whose AI projects collapse the moment they ask for one more feature
  • Anyone who hates rewrites and wants problems caught on paper, where they are cheap

Who it's not for

  • Anyone hoping for a tool to buy — the method is tool-neutral and works with any assistant, including free tiers
  • People building throwaway experiments — the book itself has an honest chapter on when spec-first is overkill

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 organisation tool, not legal, tax, medical, or religious authority.

Held to The CalmKit Standard

Last reviewed July 2026 ·

Drafted with AI assistance and then reviewed and curated by a real person who's been through it.

Please verify independently. Where a step depends on current rules or prices, the guide says so on the page.

What the Standard commits us to →

Write It Down First
24 pages · Instant PDF · $14.99$11.24