Agent Wranglers

Working in small steps Required

Work on a branch and commit often

Let agents work only on a branch, and commit after each step that passes the checks.

How to do it

Create a branch per task, or a separate worktree per agent when several run at once. Commit every working step, so a bad step can be undone without losing the good ones. Merge to the main branch only after review. When several agents work at once, give each one its own files or its own worktree. Agents editing the same file overwrite each other's work. A shared build folder breaks the same way, so each agent builds into its own output folder or worktree.

How to check

The main branch has branch protection, and no agent commit lands on it without a reviewed pull request.

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/branch-and-commit.