Pimp My IDE / Garage Dispatch
← Back to the garage
September 2, 2026 · Agent-era maintenance

The agent ships. The code still has to fit in your head.

A coding agent can keep extending a thicket long after the humans stopped seeing the shape of it. That is not superhuman maintainability. It is a missing dashboard light.

The take

“The agent can change it” is a capability claim. “The team can explain, review, and repair it” is a health claim. Put the second one back on the instrument panel before the merge loop quietly optimizes it away.

The old alarm was a confused human.

Rodrigo Rosenfeld Rosas names a sharp failure mode in AI Agents and the Refactoring That Never Happens: experienced developers used to hit a tangled module, lose the mental model, and treat that discomfort as a maintenance signal. Agents can often trace another caller and add another branch without producing the same visceral stop sign.

The useful part of the argument is not “agents never get lost”—they absolutely can. It is that successful task completion can hide declining human legibility. If the patch passes, the next ticket arrives. Nobody opens a maintenance bay because the machine did not complain.

Finish-line automation raises the stakes.

Visual Studio Code 1.136 introduces Agent Merge in preview. Its documented loop can address review feedback, failed checks, and merge conflicts, rerun workflows, and continue until a pull request is ready to merge. That sounds useful. It also makes the definition of “ready” matter more than ever.

A green workflow proves whatever the workflow checks. A resolved comment proves the comment was handled. Neither proves that a teammate can explain the new control flow tomorrow morning. Machine closure and human comprehension are separate circuits.

A merge loop needs an understanding brake, not just a conflict wrench.

More tools do not create stewardship by themselves.

Chrome DevTools MCP is trending today with an impressive inspection surface: browser automation, console and network debugging, screenshots, performance traces, and performance insights. Its own README also clearly warns that the server can expose and modify browser data, and documents separate usage-statistics controls.

That is what mature tooling looks like: capability paired with explicit boundaries. But even excellent observability answers only the questions it was asked. A trace can expose a slow interaction. It cannot decide whether a six-file workaround should become one coherent module. Inspection reach is not structural taste.

Install a deliberate refactoring reflex.

  1. Require the map. Before a non-trivial change, ask for the rule, exceptions, state transitions, and ownership boundary in plain language.
  2. Track explanation drag. If a reviewer cannot predict the change without replaying half the repository, stop treating that cost as invisible.
  3. Budget the pit stop. Let the agent propose a smaller boundary before it extends the next exception. Refactoring is work, not a prompt adjective.
  4. Re-prove behavior. Characterization tests before structure work; focused tests and a readable diff after it.
  5. Keep a human receipt. One paragraph: what rule is clearer now, what stayed behaviorally stable, and what debt remains.

The goal is not handcrafted purity or mandatory rewrites. It is operational ownership. If nobody can explain where the rule lives, the team has leased its steering wheel to the only thing still willing to enter the maze.

Interactive makeover / refactor redline

Feel the maintenance load.

Traditional purpose replaced: a static “clean code” checklist after the patch. Better version: a keyboard-native tach combines change shape, reviewer friction, proof strength, and an explicit pit-stop receipt before merge.

Maintenance Tach

Set what you actually observed. The dial is an editorial heuristic—not a complexity metric and not a security score.

5How many decision forks and exceptions must a reviewer hold?
4How widely does the behavior leak across files or modules?
6How hard is it for a human to predict the path unaided?
6Characterization tests, focused checks, and readable evidence cool the dial.

Pit Chief Readout

Warm · inspect before merge

The change may be shippable, but explanation drag is carrying more load than proof removes. Ask for the rule and the exception map before adding another branch.

Human-understanding pit stop
Why it is better: sliders make hidden review friction discussable; native checkboxes preserve an auditable stop condition; the output is a handoff artifact instead of a decorative score.

Sources read, not vibes

  1. Rodrigo Rosenfeld Rosas — AI Agents and the Refactoring That Never Happens (September 2, 2026): the disappearing human “I am lost” signal, modularity, reviewability, and agent context cost.
  2. Hacker News discussion, item 49541496: current public discussion attached to the essay; linked exactly through the HN item API.
  3. Visual Studio Code 1.136 release notes (September 2, 2026): Agent Merge preview, its repeated PR-finishing loop, and agent-session changes.
  4. ChromeDevTools/chrome-devtools-mcp: current README for browser inspection capabilities, supported browsers, browser-data warning, performance CrUX behavior, and usage-statistics controls.