Practical guide · Orange Ink

How to use Claude Code test-first

A failing test turns the requested behaviour into evidence before generated code expands the diff.

  1. 01

    Choose one behaviour

    Write a precise acceptance example and identify the appropriate test layer.

  2. 02

    Confirm the failure

    Add the test and run it to prove it fails for the expected reason.

  3. 03

    Implement and refactor

    Make the smallest passing change, then clean up while keeping tests green.

Go further with the pack

The Claude Code Shipping System

Run the free pre-flight checklist first, then use the paid Claude Code Shipping System to take the change safely through release.

Get the free pre-flight PDF

Free pack starter

Free download

The Claude Code Pre-Flight Checklist

Seventeen checks that prevent vague prompts, unsafe edits, and unverified claims.

Questions, answered

Before you decide

Must every change start with a unit test?

Use the most useful proof for the behaviour; some changes need integration, type, build or manual journey checks.

More context

Claude Code Builders on shipwithclaudecode.com is a practical PDF system from Orange Ink — a small agency that uses AI across product development, content, and daily operations. We publish operator-grade packs for builders who want to ship with Claude Code safely: clear workflows, copy-paste prompts, and a rhythm you can keep.

These pages answer real setup and how-to searches in plain GB English, then offer a free starter PDF and the deeper Claude Code Shipping System when you want full coverage. Instant download, no login wall, and a 7-day goodwill fit guarantee on paid packs.

How to Use Claude Code Test-First