02 / Isolate

Sharing the world

Separate code is easy. What about shared databases, ports, services, and environments?

Separate source trees can still point at one mutable database or one set of service ports. The right isolation boundary depends on the change being attempted.

When is a branch not enough?

01

Fork the running environment

Give work separate runtime namespaces so independent agents do not contend for the same services.

Trade-off: More isolation means more environments to provision and clean up.

02

Branch data as well as code

Explore ways to copy, diff, and reconcile database or data-lake state per task.

Trade-off: Diverged data eventually needs a reconciliation policy.

03

Reconcile isolated results

Isolation creates exploration freedom; the unresolved problem is bringing successful changes back.

Trade-off: The difficult boundary moves to reintegration.

The comparison: worktrees separate files; runtime namespaces separate services; data branches separate mutations. All isolation has a reintegration cost.

WHAT TO WATCHEnvironment setup, teardown and cleanup cost.

Video

Building an Autonomous Engineering Org - Angie Jones, Agentic AI Foundation

youtube.com · Angie Jones · from 14:20

“Another issue, specifically when running multiple agents in parallel, was that the agents were bumping into each other as they were trying to work. And more importantly, our machines couldn’t handle the load anymore.”
Take

Block’s answer was dedicated cloud workspaces, one isolated environment per agent. Quoted from YouTube’s auto-generated captions.

  • Isolate
Video

Building your own software factory — Eric Zakariasson, Cursor

youtube.com · Eric Zakariasson, Cursor · from 21:00

“you can reuse services but you’re still going to have to branch every like database or cache or user management to have like reproducible and separate environment”
Take

Worktrees separate the code, not the state. Cursor runs each cloud agent in its own VM with its own database, and he guesses they run “multiple thousands a day”. Quoted from YouTube’s auto-generated captions.

  • Isolate
Video

CI/CD with Robert Erez

youtube.com · Robert Erez, Octopus Deploy · from 59:07

“any sort of scenario where you want that AI agent to kind of validate what it’s done, you’re essentially talking about ephemeral environments, even if it’s not exposed to people”
Take

The old pattern was a few shared test environments, one per tester, with people coordinating who had the system. Agents that check their own work need environments that are created and torn down per change. Quoted from YouTube’s auto-generated captions.

  • Isolate
  • Verify
Quote

claims: MCP claims store is cwd-relative (bare resolve()), so every worktree/session gets its own claims.json

github.com · Issue #3178

“Under the repo's own "worktree-per-writer" rule, each worktree (and each Claude Code session with a different cwd) reads and writes a different claims.json, so claims_claim / claims_board / claims_steal do not coordinate the sessions they are meant to coordinate.”
— ruvnet (Ruflo maintainer), on GitHub
Take

Isolating the code also isolated the coordination. Shown by reading the source, not from an incident where two agents took the same task. The fix, PR #3210, was still unmerged in October 2026.

  • Coordinate
  • Isolate
Quote

Dolt Concurrency Model: Transaction-Based Shared Main

github.com · Problem Statement, item 1

“Workers can't see each other's beads. A bead created by agent A is invisible to agent B until A's branch merges to main.”
— Steve Yegge
Take

Giving each worker its own branch let them write without contention, but they couldn't coordinate. The design doc moved everything to one shared main with explicit transactions, live since 24 February 2026.

  • Coordinate
  • Isolate
Quote

Durable state anchored to raw process.cwd(): agent cwd drift silently resets autopilot/neural/metrics/memory

github.com · Issue #2633, Summary

“The result is that state is written to whichever subdirectory the session drifted into, and then never read again. Nothing errors.”
— sparkling, on GitHub
Take

On one 12-repository workspace this left 109 state directories (97 stray) and about 25 daemons. Fixed in the reporter's fork; the upstream issue is still open. A 2025 issue (#765) describes the same root cause.

  • Remember
  • Isolate
Quote

Harness engineering: leveraging Codex in an agent-first world

openai.com · Increasing application legibility

“As code throughput increased, our bottleneck became human QA capacity.”
— Ryan Lopopolo, OpenAI
Take

The fix was to make the app bootable per worktree, with an ephemeral logs, metrics and traces stack, so Codex could run and check one instance per change itself.

  • Verify
  • Isolate
Quote

How to operate shared platforms safely at agent scale

datadoghq.com · Allocate capacity based on workload criticality

“At Datadog, we first introduced source-specific limits to prevent concurrent evaluation workloads from consuming the entire shared quota. Now, we further isolate evaluation traffic by routing it through a separate provider account.”
— Datadog
Take

Isolation is not only about files and environments. A shared model quota is a resource agents compete for too.

  • Isolate
Quote

Make Every PR Prove Itself

builders.abnormal.ai · Share one environment, override one service

“Every agent shares one running base environment and overrides only the service it’s touching.”
— Michel Chatmajian, Abnormal AI
Take

At 200+ agent PRs a day, a full environment per branch was too expensive. Each testbox overrides only the service under change and gets private copies of the datastores it declares.

  • Isolate
Quote

Make Every PR Prove Itself

builders.abnormal.ai · Share one environment, override one service

“A redirect only works if every consumer of the config layer honors it, and the ones that don’t fail silently, because a working connection to the wrong database looks exactly like a working connection. We shipped two consumers that quietly ignored ours.”
— Michel Chatmajian, Abnormal AI
Take

Isolation that leaks fails silently. They added a capture agent that checks the connections each test actually makes against the service’s declared manifest.

  • Isolate
  • Verify
Quote

Meet Hoplites: How Paxos is Redesigning Software Delivery Around Human-Directed Agents

paxos.com

“Across all four, the same patterns showed up: Slack as the universal entry point, pre-warmed ephemeral sandboxes, async fire-and-forget that produces PRs, human review as the merge gate, directory-scoped context files (CLAUDE.md / AGENTS.md), bounded CI retries, and MCP as the tool-integration standard.”
— Cameron Fleet, Paxos
Take

The four are Stripe’s Minions, Ramp’s Inspect, Spotify’s Honk and Paxos’s own Hoplites. A useful checklist of what company agent factories have converged on.

  • Isolate
  • Verify
Quote

Minions: Stripe’s one-shot, end-to-end coding agents

stripe.dev · How do minions work?

“This also gives parallelization without the overhead of something like git worktrees, which wouldn’t scale at Stripe.”
— Alistair Gray, Stripe
Take

Each minion gets a pre-warmed devbox, ready in about 10 seconds with Stripe code and services loaded and cut off from production and the internet. Over a thousand merged PRs a week are written entirely by minions.

  • Isolate
Quote

Minions: Stripe’s one-shot, end-to-end coding agents—Part 2

stripe.dev · Devboxes, hot and ready

“Humans should be able to give many agents logically separate work. Agents should have clean environments and working directories: it unnecessarily wastes tokens on resolution if agents are interfering with one another’s changes.”
— Alistair Gray, Stripe
Take

Stripe keeps a warm pool of identical devboxes, with repositories cloned and Bazel and type-checking caches already warm, and gives each task its own box.

  • Isolate
  • Plan
Quote

Ruflo CLAUDE.md

github.com · Concurrent Automated Development

“Never allow two writers in one worktree. Give every writing agent an isolated worktree and explicit file ownership.”
— Ruflo maintainers
Take

The same section adds: "Only the integration owner edits shared manifests and lockfiles or reconciles overlapping changes."

  • Isolate
  • Coordinate
Quote

Why We Built Our Own Background Agent

builders.ramp.com · Sandbox

“This ensures that at most, the repository is 30 minutes out of date”
— Ramp
Take

Every Inspect session starts from a repository image rebuilt every 30 minutes, so isolation comes with a known staleness bound. Inspect writes about 30% of merged PRs in Ramp’s frontend and backend repositories. The Pragmatic Engineer later reported 75%.

  • Isolate
  • Integrate
Quote

Worktrees (AI Development Setup)

stevekinney.com

“Worktrees reduce file collisions. They do not isolate services, ports, databases, secrets, or decisions.”
— Steve Kinney
  • Isolate

Tools filed under isolate

Preview · not yet reviewed by a human