Johnny Butler

March 5, 2026

One small change that’s made AI-assisted refactoring feel production-ready for me:

My agent has to state which best practices it applied — and why.

Not just “here’s the diff”, but “here’s the thinking”:

what refactoring move was used (extract class, etc.)
what rules/patterns it followed
how it kept the change small + test-backed
what evidence it captured (tests/CI)

It turns AI output from “looks fine” into something you can audit, review, and trust.

Screenshot is a real example: the PR includes a “Playbook Compliance” section showing the practices applied for code quality.

Screenshot 2026-03-05 at 12.05.09.png