Someone just booked an audit
Engineering · a direct answer

Why does my AI coding agent keep breaking my code?

An AI coding agent breaks code because it is allowed to write before it can prove. Without a stated, falsifiable proof of done, it optimises for the appearance of completion: declaring success on code it never ran, editing files it never read, and skipping the reconnaissance that would have shown what was already true.
Written 29 October 2026 · last changed 29 October 2026

Prompting harder does not fix this, because the failure is structural. The agent is not lying; it is answering the question you asked, which was “build this” rather than “build this and show me the check that could fail”.

The fix is a gate in front of the write tools: no mutation until the governing procedure is loaded and the proof is written down. Once that exists, the same model produces materially different work — not because it got smarter, but because it can no longer skip the step.

The fix, in four steps

  1. Recon before edits Read-only survey first: what exists, what is load-bearing, what must not change. Write it down before touching anything.
  2. State the proof before the first line One sentence: “done when this command prints this output.” If you cannot write it, the task is not ready.
  3. Gate the write tools Refuse write, patch and execute until the procedure is loaded. A rule in a prompt is advice; a hook is a rule.
  4. Attack the result Independent critics with different briefs, then a judge that scores them. “Works on my machine” is a finding, not a defence.

“I've worked with people who understand AI and others who understand business, but rarely someone who connects both so naturally. He helped us rethink our workflows and showed how specialized AI agents could take over repetitive work while keeping our team focused on higher-value decisions.”

Issac, Consultant

The same engine, set up for one kind of work. It is not software you log into. You get the modules, the procedures and the documentation, and you own them.

audit USD 500₹30,000 · sprint USD 3,500₹2,10,000 · retainer from USD 250/mo₹15,000/mo
Seven a month, slots open on the 1st

Only taking seven audits a month. We check the fit before you pay.

Get this applied to your business

USD 500, fixed scope, 3 days, every finding cites what I read. Seven a month, and we check the fit before you pay: if you are not a fit you are not charged.

AI workflow audit, USD 500→

Questions

Will a better model fix this on its own?+
No. The failure is structural, not capability-based. A more capable model produces more convincing unverified work, which is worse.
What is a falsifiable proof in this context?+
A command plus an expected output that could plausibly not happen. “It looks correct” is not a proof; “npm test exits 0 and the new case appears in the output” is.
Do I need tests for this to work?+
You need a check that can fail. A test suite is the usual form, but a curl against a running server, a diff against a known-good file, or a headless browser assertion all serve the same purpose.

More answers