Skip to main content
manual page/ ADRs

ADR 0003: Distillation is unidirectional

Sections
4
Format
Markdown
Order
41 / 156

Status

Accepted

Context

Information must move from high verbosity (research, narrative) toward executable task files. Reverse flow ("code → spec", "feelings → audit as requirements") rewires truth to match patches and destroys auditability.

Decision

Allowed transitions follow the verbosity gradient downhill only, with explicit Distillation Loss Statements when material is dropped. Promotions from task findings back into specs/audits are narrow corrective moves, not full reversals.

Consequences

  • Positive: accountable compression; ambiguity surfaces as authoring work (spec-writing) instead of silent implementation drift.
  • Negative: mandates extra hops (research → spec → feature) — intentional friction.

Starter kit: Set up a workspace