Theme
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.