AI Fluent · Chapter 07

Sandbox-First Development

You don't have a testing team. You're the whole team. A sandbox is where you break things safely so your real product never breaks in front of real people.

5 min read Shaen Hawkins
Split image — calm production kitchen versus chaotic sandbox
Plain English

You wouldn't test a new sauce recipe by serving it to a full dining room. You'd try it in the back kitchen first. Your sandbox is the back kitchen. Same equipment, same ingredients — but the food goes in the trash, not to customers.

Two Versions of Everything

Production

The live version your real users see. The dining room. Everything here must work. You never experiment in production.

Sandbox

A separate copy that exists purely for testing. The test kitchen. Break things here freely. No users will ever see it.

THE PROMOTION WORKFLOW SANDBOX (TEST KITCHEN) 1. BuildMake change 2. TestVerify it works PROMOTE PRODUCTION (DINING ROOM) 3. Same ChangeIdentical. No tweaks. 4. Test AgainDon't assume. Skipping sandbox = borrowing time at very high interestEvery shortcut has cost more time than it saved

The urge to skip the sandbox is strongest when the change seems small. "It's just a text change." Those are the changes that break things — because your guard is down.

The Time I Skipped It

Three days of broken payments because I saved ten minutes of sandbox testing. A "quick fix" directly in production broke the Stripe webhook. Real users were paying but not getting access. By the time I noticed, I had three days of manual subscription repairs to do.

That was the last time I ever skipped the sandbox.

Diagram comparing sandbox workflow versus direct-to-production failure
The Rule

Skipping sandbox feels like saving time. It is borrowing time at a very high interest rate. Every single time.

Chapter Appendix
Dual environment setupNaming conventionsPre-promotion checklistEnvironment variable management