Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ADR-0001: one-shot synthesis from three inputs

Status: accepted (2026-07-06)

Context

Two prior systems existed: ward-os (installed, lived-in, two chapters split by the debian-era-end tag) and trellis-v0 (a frozen attempted rewrite kept as comparison material). Iterating either forward in place would drag along its accidents; a fresh repo with no synthesis discipline would lose the lessons.

Decision

trellis is written ONCE, in a single synthesis session, from exactly three inputs: Debian-era ward-os (<= debian-era-end), trellis-v0, and the running-ward-os trial chapter (ward-os > debian-era-end plus the ~/trellis-feedback.md ledger). Every design decision was interviewed against all three; the outcomes are this ADR set and docs/DESIGN.md. After synthesis the inputs are history, not upstreams - nothing merges from them.

Alternatives considered

  • Evolve ward-os in place: keeps the decoy split, dirty sentinels, and 14-workflow CI it was time to shed.
  • Promote trellis-v0: frozen at pre-trial understanding; superseded.
  • Continuous synthesis: no cut point means no clean provenance.

Consequences

Clean provenance: every carried choice has an ADR; everything dropped is in docs/dropped.md. The old repos stay readable but are never merged from.