Making AI Coding Enjoyable - Fix the Process, Not the AI
Making AI Coding Enjoyable - Fix the Process, Not the AI
You have seen the complaints: "AI generated a 200-file changeset and broke everything." The natural reaction is to blame the AI. But this is almost always a process failure, not a model failure.
The Real Problem
When an AI agent touches 200 files in one go, something went wrong before the agent started. Nobody scoped the task. Nobody defined boundaries. The agent was given a vague instruction like "refactor the authentication system" and it did exactly what you asked - it touched everything related to authentication, which turned out to be half the codebase.
The same thing would happen if you told a junior developer to "refactor auth" without constraints. The tool is not the problem. The instructions are.
Scope Your Agents Tightly
The fix is simple: break large tasks into small, well-defined units. Instead of "refactor authentication," try "extract the token refresh logic into a separate module without changing any external interfaces." The agent now has clear boundaries and a definition of done.
This is the same principle behind good software engineering. Small PRs, clear acceptance criteria, isolated changes. AI agents just make the cost of loose scoping more visible because they work faster and amplify bad instructions.
Practical Rules
Give each agent one file or one module to work on. Define what should change and what should not. Use parallel agents with git worktrees for isolation - if one agent's changes are wrong, you throw away that branch without affecting others. Review the diff before merging, just like you would with a human contributor.
The Result
When you scope agents properly, AI-assisted coding goes from frustrating to genuinely enjoyable. You spend your time thinking about architecture and reviewing diffs instead of writing boilerplate. The 200-file changeset problem disappears because no single agent is allowed to touch 200 files.
- Context Management Is 90% of AI Coding Skill
- Stop Fighting the Context Limit - Scope Each Agent
- Five Agents Same Codebase - Coordination Lessons
Fazm is an open source macOS AI agent. Open source on GitHub.