Skip to content

ADR-0012: Use the user's Git executable

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

Context

Worktree semantics and Git environment behavior are subtle; mature tools have hit bugs from incorrect repository/worktree assumptions.

Decision

Forge invokes installed git through one GitService instead of embedding a Git implementation.

Consequences

Tests use real temporary repositories and real Git commands.

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.