Small Steps, Eyes Open

Finally, Building

You’ve got your requirements, your look, your screen rules, and a plan you’ve read and approved. Now the fun part: building.

And because you did all that thinking first, building is mostly calm. You just follow one simple rule:

One small step at a time. Check each one before the next.


Why Not Just Build It All at Once?

It’s tempting to type “build the whole website” and wait. Here’s why that goes badly:

When everything is built at once, problems pile up on top of each other. By the end, you can’t tell which part caused which problem, and fixing one can break another.

When you build in small steps, each problem shows up right when it appears, while it’s still small and easy to fix.

All at onceSmall steps
ProblemsFound at the end, tangled togetherFound right away, one at a time
FixingHard: “which part broke this?”Easy: “the step I just did”
Save pointsOne, at the end (if it works)One after every working step
Your controlYou find out what you got at the endYou steer the whole way

The Rhythm

Every milestone in your PLAN.md goes through the same four beats:

  1. Ask for one milestone. “Do step 2 of the plan: the home page.”
  2. Watch it work. Auto mode on, eyes on the screen. Esc if it wanders.
  3. Look at the result on localhost. Click everything. Check the phone-sized view (F12, then Ctrl+Shift+M).
  4. Save it. “Save a checkpoint and push it.” Then tick it off in the plan.

Then /clear, and start the next milestone with a fresh whiteboard. Your notebook, requirements and plan are all in files, so nothing is lost.


“Done” Means “Go Look”

This is the heart of the always-check habit.

When Claude says a step is done, that means it thinks it’s done. Usually it’s right. Sometimes it isn’t:

  • It might have misunderstood what you meant.
  • It might have changed something you didn’t ask for.
  • It might say it works when it doesn’t quite.

Claude isn’t lying when this happens. It’s just very confident, even when it’s wrong. So you check. Every time.

Claude builds. You check. That’s the partnership.

A few quick checks that catch most problems:

  • Click every button and link on the part that changed.
  • Look at the phone-sized view.
  • Ask Claude: “What exactly did you change in this step?” If the list has something you didn’t expect, ask about it.

How to Ask for a Step

Point Claude at the plan, and name the step:

Let's do step 3 of @PLAN.md: the gallery. Only that step. When you're done, start the preview so I can check it.

The words “only that step” matter. Without them, an eager Claude might helpfully start on step 4 too.

When you’ve checked it and you’re happy:

Looks great. Save a checkpoint, push it, and tick off step 3 in PLAN.md.

Try it

Start building your website. Take the first step from your PLAN.md, and go through the full rhythm: ask, watch, look, save. Then /clear and do the next one.

See an example prompt
Let's do step 1 of @PLAN.md. Only that step. When it's done, start the preview and tell me what to look at.

After checking it in the browser:

It works. Save a checkpoint, push it, and tick off step 1 in PLAN.md.

Then:

/clear