Skip to content

ADR-0013: Worktree paths use immutable IDs

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

Context

Provider session state can be keyed by cwd; renaming a workspace/path can break resume behavior.

Decision

Worktree filesystem identity is based on Project/Task IDs, not mutable titles/slugs.

Consequences

Human title remains metadata while the underlying path stays stable.

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.