Skip to content

ADR-0005: Agent Adapter is separate from Execution Environment ​

  • Status: Accepted
  • Date: 2026-09-10

Context ​

Coupling provider and runtime creates a cross-product of Claude×worktree, Claude×Docker, Codex×worktree, etc.

Decision ​

Agent Adapter/Strategy owns provider protocol. ExecutionEnvironment owns where work runs.

Consequences ​

First environment is LocalWorktree. Additional runtimes can be introduced without rewriting provider integrations.

Change rule ​

If implementation evidence proves this wrong, update the canonical architecture/product document first and then supersede/amend this ADR. The ADR is not allowed to keep current docs stale.

Forge is local-first. The docs are part of the product engineering system.