← All writing
Writing

Worktrees for knowledge work: parallel work without contamination

AI & Agents

Developers use worktrees so multiple branches of work can happen in parallel without stepping on each other's changes.

You need the same concept.

Not the Git mechanics. The operating principle underneath them.

A worktree is an isolated copy of a project. OpenAI's Codex docs describe it plainly: worktrees let Codex run multiple independent tasks in the same project without interfering with each other, and automations in Git repositories can run on dedicated background worktrees that never conflict with your ongoing work.

That maps almost perfectly to modern knowledge work, because the problem isn't that you lack ideas.

The problem is that too many half-formed ideas collide in the same document, channel, or meeting until nothing is usable.

You ask for a pricing memo. Then a sales objection arrives that undermines it. Then a competitor launches something adjacent. Then the board narrative changes direction. Suddenly one document is trying to be a strategy memo, a sales script, a roadmap input, and a fundraising story all at once.

That's not collaboration.

That's contamination.

The knowledge-work version of worktrees is simple: run each meaningful line of inquiry in its own isolated thread before merging it back into the main decision.

Thread A analyzes enterprise buyer objections. Thread B rewrites positioning for mid-market buyers. Thread C pressure-tests pricing against current competitors. Thread D summarizes customer evidence from recent calls. The main thread decides which version becomes the official narrative.

Each thread gets its own goal, source material, assumptions, and output format. The main thread doesn't become a dumping ground. It becomes the integration point where you compare finished proposals.

This gives you three capabilities that are hard to get any other way.

Parallelism without chaos

You can explore multiple options at once without forcing one draft to carry every possible direction. AI makes it cheap to generate alternatives, and without isolation, that cheapness becomes noise that buries the signal.

Safer experiments

Want to test a sharper narrative? A more aggressive offer? A different ICP? A contrarian recommendation you're not ready to commit to?

Do it in a worktree-style thread. The main artifact stays stable until the experiment earns its way in, and nothing gets contaminated by an idea you were only stress-testing.

Cleaner review

When the thread comes back, you review it as a discrete proposal: what changed, what evidence was used, what assumptions it made, what should be merged, what should be discarded.

That beats reviewing an AI-generated blob and trying to reverse-engineer where every idea came from. You can actually trace the reasoning.

The trap is treating parallel agents as a way to produce more output.

That's backwards.

Parallel agents earn their keep when they preserve optionality without destroying coherence, and your job becomes more editorial: define the lanes, protect the main workspace, compare the outputs, merge the winning changes, archive the experiments.

That's why worktrees matter beyond software. They're a pattern for disciplined exploration, and the principle holds in every effective multi-agent workflow.

You don't need Git to learn from Codex.

You need the habit underneath it: don't let every experiment mutate the source of truth. Run the experiment in isolation.

Then merge deliberately.

---

Codex for knowledge workers is a five-part series:

  1. Codex is becoming a workspace, not a chatbot
  2. The chief-of-staff thread
  3. Worktrees for knowledge work (you're reading this)
  4. Automations turn follow-up into managed background work
  5. The Codex operating manual for knowledge workers

Setting up the tooling: the Codex CLI config.toml Guide 2026 covers profiles, permission modes, AGENTS.md, and plugins. The earlier Codex CLI Developer Guide covers the 0.42.0 command surface these workflows were first built on.

Keep thinking with us

Practical AI ideas, delivered where you already are.

Get occasional field notes on choosing models, building useful AI workflows, and making better decisions with the tools.

Prefer a messaging app?

Telegram and WhatsApp are broadcast-only and carry the same posts. Pick the app you prefer.