Engineering brief

Your AI agent harness is overengineered. The model got better.

AI Engineer3 min read · saves 15 min

At a glance

The brief is enough

Relevance
Practical value
Radar
Time horizon
This year
Warnings
None

Google DeepMind built the same agent three ways, deleting code each time. The final version replaced Python orchestration with a markdown file and bash access.

Agent orchestration is shifting from code to files, changing how teams build, debug, and govern AI workflows.

Watch if you are evaluating agent frameworks and want to see how Google's remote agent compares.

Summary

The shift. Philipp Schmid from Google DeepMind demonstrated a clear evolution in how agents are built: from raw Python loops to framework abstractions, and now to a file-and-instruction model where markdown files replace most code. The demo built the same GitHub PR review agent three ways, each version deleting code and adding files.

The pattern. Version one required a Python class, JSON tool schemas, manual tool routing, error handling, and state management. Version two used the Agent Development Kit (ADK) which removed boilerplate but still required Python tool implementations. Version three used Google's remote agent with a sandbox environment, GitHub CLI, and a single agents.md file for instructions. The agent handled tool selection, installation, and error recovery autonomously.

The mechanism. Google's interactions API and remote agent provide server-side state management, automatic context compaction, and an isolated Linux sandbox with a network proxy for credential injection. Users define an agents.md file with instructions and skills.md files for capabilities. The agent self-discovers which tools to use rather than requiring predefined function calls.

The evidence. Schmid cited Cursor replacing 12,000 lines of TypeScript with 200 lines of agent files for git worktree orchestration. He mentioned Ancient Engineering Manos refactoring their agent harness five times in six months, LangChain rearchitecting open deep research three times in a year, and Worsel removing 80% of their tools for better performance. These examples suggest a pattern, not a controlled experiment.

The trade-off. Moving orchestration from code to files trades deterministic control for model autonomy. Teams lose the ability to audit exact execution paths and must trust the model's tool selection. The approach depends on model quality, raises governance questions about agent actions, and shifts the debugging challenge from code to prompt engineering. Missing from the talk: evaluation strategies, failure modes, and cost implications of longer agent sessions.

The bottom line. The trend is real: better models enable less orchestration code. But the practical path for most teams is incremental, not all-or-nothing. Start by moving one or two deterministic workflows to instruction files, measure success rates, and keep escape hatches in place. The hard work moves from code to evaluation.

My take

I buy the direction but not the timeline. Moving from Python to files works for well-scoped tasks like code review. For complex multi-step workflows with compliance requirements, I'm not ready to trust model judgement over deterministic orchestration. The Cursor example is compelling, but 12,000 lines of TypeScript replaced with 200 lines of prompts sounds like the original code was overengineered, not that files are universally better. Teams should experiment with file-based agents for bounded tasks while keeping traditional orchestration for high-stakes paths. The real unlock isn't files replacing code, it's knowing which pattern fits which problem.

What to do with this

  1. Identify one bounded, low-risk workflow to reimplement as a file-based agent this quarter.
  2. Set up evaluation metrics for agent success rate, latency, and cost before changing architecture.
  3. Conduct a code audit of your current agent harness for unnecessary complexity the model could replace.

Watch the video

This video is blocked due to your privacy settings. To watch this video, please accept YouTube marketing cookies.

Related breakdowns

Get TL;DW

Too Long; Didn't Watch.

A concise breakdowns of the AI and devtools videos that actually matter for engineering leaders.

Free. Weekly. No hype.

Video and thumbnails remain the property of their respective creators. tldw.news provides editorial analysis, commentary, and discovery links to original content.