15 from Merge Debt: The 2026 Bill Your Parallel AI Agents Are Running Up
The landing order: parallel agents count once their work is in main, shaped and in a chosen order
By Vladimir Mikhalev Docker Captain · CNCF Ambassador · IBM Champion
Worktrees parallelize the work. Main is a single sequence. The gap between code agents have finished and code that has landed, reviewed and reconciled, is merge debt, and it grows in front of the one gate that did not scale: human review.
The controls below need no vendor claim. They make the debt visible and the repayment cheap enough to happen daily.
- 1
Give every agent its own worktree
Each agent edits its own copy of the tree, so nothing collides while the work is in flight. It is the right primitive for the work, and it moves the problem to the landing.
- 2
Check what each worktree touches before you spawn another
Two agents aimed at the same module is a collision you scheduled. A commit graph that shows every active worktree and its working changes in one view (GitLens 18 does) makes it a ten-second look.
- 3
Give the landing order an owner
When several branches finish together, the sequence is an engineering decision: smallest blast radius first, or the hottest file first, chosen, not left to whoever presses merge first. Owner: the engineer or lead who owns the target branch.
- 4
Cap diff width per agent task
Cap agent tasks the way you cap pull request size for people, and split before landing, not after the review stalls. Every downstream cost (rebase, review, revert) grows with the width.
- 5
Make commit shaping the entry fee to main
Machine output does not enter history as one blob called "update payments". Reviewable commits with meaningful messages, shaped by hand or by a tool such as Commit Composer (part of GitKraken AI, a paid plan), are required before review.
- 6
Plot the debt next to velocity
Two numbers per team on the same dashboard: time from agent-done to merged in main (the queue depth) and the share of agent-authored code reworked within two weeks (the quality echo). Owner: the engineering manager.
Three questions for the next engineering leadership meeting
- What is our median time from agent finished to merged in main, and is it growing?
- Who decided the landing order of the last three parallel branches that touched the same service, and was it decided at all?
- What share of AI-authored code merged last quarter was rewritten within two weeks?
What it rests on
The study behind the perception gap, and the tools the steps name. A measured run of one worktree per agent comes with the worktrees post on 2 December.
- METR, the randomized controlled trial of early-2025 AI tools, 10 July 2025: 19% slower, believed 20% faster, 16 developers, 246 tasks.
- GitLens 18: agent sessions, worktrees and working changes in one commit graph.
- GitKraken AI: Commit Composer restructures a sprawling diff into reviewable commits before review.
Generating is parallel. Landing is serial, and someone should choose the order.
The long version is the post Merge Debt. METR, Measuring the Impact of Early-2025 AI on Experienced Open-Source Developer Productivity, 10 July 2025; GitKraken, GitLens 18.