Implementation planning

When a plan is worth writing

More than about three steps, more than one file of consequence, or any work that will be handed off. Below that, planning costs more than it saves.

Writing the plan

A plan is executable when someone who was not in the conversation can follow it without guessing. That means every step names:

• The change — the file or surface, and what it should do afterward.
• The proof — the command that shows it worked. "Run the tests" is not a step; the exact invocation is.
• The checkpoint — whether a human reviews before the next step starts.

Order steps so the system is working at the end of each one. A plan whose midpoint is a broken build cannot be paused, and every plan gets paused.