Speaker Notes

AI Agents Still Can't Maintain Your Codebase

While coding agents accelerate feature delivery, unattended models degrade codebase quality over time, requiring structured planning, execution backpressure, and collaborative control planes.

Perfology · 16:07 · YouTube ↗

Talk · solo speaker  Intermediate · Concepts, data, and software architecture strategy

Highlights

3 clips · 4 min of 16 min
    • Unattended models fail to improve or maintain codebase maintainability over time.
    • Slop Code Bench shows current models struggle significantly with iterative, long-term code evolution.
    • Maintainability lacks a fast oracle, making reinforcement learning difficult for architecture.
    • Spending 20-30 minutes planning upfront saves hours during review.
    • Balancing spec depth helps minimize expected pain and costly rework later.
    • Avoid arguing over trivial UI details during planning phases.
    • Provide agents with browsers, curl, and video recording to test their own work.
    • Use curated repo-level anti-slop rules to prevent common agent anti-patterns.
    • Feed user feedback and pager alerts directly into agentic PR generation.

Questions this video answers

6 · every answer cites the moment it was said
01 Why do unattended coding agents degrade codebase quality over time? 3 sources · 5:13

Unattended coding agents often focus purely on passing immediate tests without regard for good architecture or maintainability. Reinforcement learning relies on fast oracles, but code maintainability has no fast oracle to catch bad design decisions made by models. Consequently, codebases accumulate technical debt and slop that requires human intervention to clean up.

02 What does Slop Code Bench measure about modern AI models? 3 sources · 6:30

Slop Code Bench evaluates models by disclosing challenges in incremental bits and making the model write code iteratively over multiple features rather than solving the entire problem all at once. This mimics real-world software evolution and reveals that top models score relatively low on maintaining clean codebases over time. The benchmark demonstrates that unsupervised coding workflows still struggle significantly with long-term code quality.

03 How can planning beforehand reduce rework when using coding agents? 3 sources · 9:17

Spending 20 to 30 minutes up front on planning and architecture drastically cuts down the time and friction required during code review. YOLO prompting with a two-sentence instruction usually results in a high probability of having to fix or rework code later. Writing a more detailed spec reduces the expected pain and likelihood of major agentic hallucinations.

04 What practical methods give AI agents backpressure during development? 3 sources · 11:15

Developers can provide agents with execution backpressure by giving them browsers, shell access with curl, or recording tools so they can independently test their changes. Additionally, adopting strict linter rules cataloged specifically against known AI anti-patterns prevents models from introducing sloppy syntax. Providing immediate operational feedback loops lets agents hill climb toward correct functionality.

05 How can engineering teams integrate AI directly into incident response? 3 sources · 11:50

Teams can streamline incident management by configuring pager alerts to automatically generate pull requests that the agent believes will fix the issue. Even if engineers can only successfully merge a portion of these automated PRs, it substantially increases development throughput and system reliability. This shifts the burden of debugging out-of-hours issues toward collaborative machine assistance.

06 What is the role of a modern control plane in an AI infrastructure stack? 3 sources · 13:48

A control plane acts as the centralized system where teams dispatch work, collaborate on active sessions, and share architectural plans. Instead of passing ad-hoc patches through chat tools, a dedicated control plane stores session traces, prompts, and streaming diffs. This setup provides visibility into what agents are doing across the organization in real-time.

Section-by-section summary

3 parts

Unattended agents accumulate codebase slop

Coding agents excel at solving isolated problems but fail to preserve long-term codebase maintainability. Data shows that relying entirely on unattended models leads to degraded code review quality, increased bugs, and architectural regression over time. Standard benchmarks often fail to capture this because maintainability lacks a fast verification oracle.

Best practices for agentic software factories

Successful AI-assisted development requires disciplined workflows like upfront planning, visual alignment, and robust testing harnesses. Giving agents tools to execute code and test their work provides essential backpressure. Additionally, adopting repo-level anti-slop rules helps prevent models from introducing common code anti-patterns.

The modern infrastructure stack for AI agents

Building an agentic software factory involves managing compute, developer environments, custom harnesses, and control planes. Centralizing session traces, plans, and real-time diffs enables seamless team collaboration. This unified workspace approach helps engineers coordinate effectively on complex agent-driven tasks.

0:00 / 16:07
k play/pause · f fullscreen · m mute
n next · p previous clip · t highlights/full
< > slower/faster · / search what was said
  • Context engineering1× · first 0:43

    The practice of structuring prompts and context for coding agents to improve generation performance.

  • Slop Code Bench2× · first 6:21

    A benchmark designed to evaluate how well coding models maintain clean codebases over iterative feature additions.

  • Human Layer3× · first 0:49

    A multiplayer coding agent workspace and control plane built for engineering team collaboration.

  • 12-factor agents2× · first 0:43

    A set of design principles and best practices for building and running agentic coding systems.

  • Show Me1× · first 10:50

    An open source skill that prompts agents to present information visually rather than in walls of prose.