Skip to content

ADR-0014: Worktree cleanup is recoverability-based ​

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

Context ​

Automatic lifecycle cleanup is useful but destructive mistakes destroy trust immediately.

Decision ​

Forge never automatically deletes dirty/unrecoverable work, and age alone never grants cleanup permission.

Consequences ​

Cleanup eligibility derives from Task terminal state, no active Run/Operation, clean/recoverable Git state, and retain policy.

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.