Design Notes
Forward-looking design documents — roadmaps, slicing decisions, and feature sketches authored before a decision is ratified. They explore a problem space, weigh options, and propose a direction.
These documents are non-normative. When a design here is accepted it graduates into an ADR (rationale) and/or the type specification / internal spec (binding behaviour); the spec and the ADR bind, the design note does not. A note may be partially superseded, stale, or never sliced — read the Status line at the top of each before relying on it.
Filenames are YYYYMMDD-<slug>.md, dated to authorship.
Adding a design note
Section titled “Adding a design note”- Name the file
YYYYMMDD-<slug>.mdusing the authorship date. - Open with a
Status:line stating the kind (Draft / Design note / Research / Investigation / Planning) and what would supersede it. - Add a row to the index table above.
- When the design is ratified, open an ADR and/or amend the spec, and update the note’s Status to point at the binding document.
© 2026 TypedDuck. Licensed under CC BY-SA 4.0.