Code Review on Coderrob

Functional Documentation Is an Agentic Guardrail

Tue, 21 Jul 2026 09:00:00 -0500

Functional documentation becomes more valuable, not less, when AI agents are writing and reviewing code.

I heard an architect argue that, in the age of AI agents, functional documentation in source code was no longer necessary. The agent can read the code, after all. Why explain what a function does when the implementation is sitting right there?

My first reaction was that the opinion was somewhat absurd and potentially dangerous.

Agentic Development and the Review-Centric Workflow

Thu, 14 May 2026 00:00:00 -0500

AI is going to change software teams whether we pretend to be ready or not.

The lazy version of that change is simple: give everyone an agent, tell them to go faster, and hope review catches whatever falls out the other side.

That is not a strategy.

The better version is this:

Move humans closer to design and review, then let agents help execute well-defined units of work.

That does not mean developers stop being technical. It means the team’s technical energy shifts toward architecture, decomposition, design patterns, refactoring, review, verification, and shared understanding.

Trust but Verify: The Math of Rigorous Software Development

Fri, 10 Apr 2026 10:00:00 -0500

Between Satire and Ridicule

It started, as these things often do, with a comparison nobody asked for.

I made a post saying that, with AI-assisted workflows, I can contribute anywhere from 20 to 300,000 lines of change in a day.

That number was not meant to say, “Look at me, I make ALL the tokens go brrrrrrrt…”

It was me counting additions plus deletions across real work: feature creation, refactoring, documentation, automation, test updates, generated assets, project scaffolding, cleanup, and the supporting files needed to make the work sustainable.