Working in small steps
Plan before code, give each task clear acceptance criteria, keep every change small, and commit on a branch so any step can be undone.
- Required 4
- Recommended 2
Required
Plan before the agent writes code
RequiredFor any change beyond a few lines, have the agent read the relevant code and write a plan before it edits anything.
Give every task acceptance criteria
RequiredState how you will know the task is done before the agent starts, as checks it can run itself.
Keep each change small
RequiredKeep every change small enough that a person can review it properly in one sitting.
Work on a branch and commit often
RequiredLet agents work only on a branch, and commit after each step that passes the checks.
Recommended
Keep one task per session
RecommendedGive each agent session one task, and start a fresh session for the next one.
Ask for the smallest change that works
RecommendedTell the agent to make the smallest change that meets the criteria, and to ask before adding dependencies, files or abstractions.
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.