Plans
Dated working plans, spike notes, and design briefs in flight. WORKING tier per _meta/definitive-articles.md: speculative, and allowed to contradict DEFINITIVE docs while in flight. A plan graduates to DEFINITIVE through an ADR or a new spec, and then this copy goes.
Convention
Section titled “Convention”Filenames are YYYY-MM-DD-<slug>.md. Undated work in this folder is a smell.
A plan whose subject has shipped gets deleted rather than kept. Once an ADR or a spec carries the decision, a second copy here creates two sources of truth. Git history is the archive. Eighteen superseded plans left on 2026-07-29 for that reason, including the whole post-v0.1/ tree; see ../_meta/pruning-2026-07-29.md. 2026-07-30-keyboard-layer-model-iteration-2.md left on 2026-08-29 once ADR-0062 carried its decision.
Contents
Section titled “Contents”| Plan | Subject |
|---|---|
2026-06-23-trackpoint-guidelines.md | Trackpoint usage conventions across the system and in carts. The FFI itself is ADR-0035. |
2026-06-26-first-party-programs-implementation-roadmap.md | Build order across the thirteen first-party programs of ADR-0042. |
2026-06-30-dossier-viewer-design.md | DOSSIER viewer design. |
2026-07-18-cipher-line-modes-design.md | CIPHER-LINE modes: splash direction and wire path. |
2026-07-23-dossier-readiness-lens-design.md | DOSSIER readiness lens. |
2026-07-27-knamp-reliability-design.md | WavAmpster playback reliability. |
2026-07-29-text-entry-surface-survey.md | Survey of every text-entry surface across the runtime and the programs. |
2026-07-30-snippets-and-the-secret-store.md | Snippet library, REPL history, and keystore consolidated into one durable store. |
Related
Section titled “Related”adr/: where a plan lands once the decision is made._meta/definitive-articles.md: the corpus state machine.