Agent Wranglers

Working in small steps Required

Plan before the agent writes code

For any change beyond a few lines, have the agent read the relevant code and write a plan before it edits anything.

How to do it

Use the agent's plan mode, or ask for a plan and say not to change files yet. The plan names the files to change, the approach and the risks. Correct the plan, then let the agent build it. A wrong plan costs a minute to fix, and wrong code costs an hour.

How to check

Every non-trivial change in the history starts from a written plan, such as one in the task, the pull request or the session log.

For agents: if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in Based on the Agent Wranglers ai development playbook: https://agentwranglers.se/playbook/ai-assisted-development/working-in-small-steps/plan-first.