Forward-looking design proposals that don’t yet rise to the level
of an architectural decision record (ADR — those live in
docs/decisions/).
Status legend:
-
[draft]— circulating; not yet shippable -
[review]— ready for maintainer review -
[accepted]— accepted; usually gets promoted to an ADR or to adocs/architecture/doc when work starts -
[rejected]— closed without merge; reasoning preserved in-file -
[superseded]— replaced by another proposal; pointer to successor
| Number | Title | Status |
|---|---|---|
Multi-producer carrier sections for L2–L6 and L15 |
|
|
Access-site carrier section ( |
|
|
Region imports carrier section ( |
|
|
Capability grants carrier section ( |
|
|
Note
|
Proposals 0001 and 0002 were promoted to
ADR-0002 and ADR-0003 on 2026-05-30. The proposal
files remain in docs/proposals/ as the canonical wire-format and
producer-obligation references; the ADRs record the decisions and
their consequences.
|
The strategic decisions (D1–D6) from
docs/PRODUCTION-PATH.adoc §"Load-bearing
decisions" are tracked there directly; each will land an ADR under
docs/decisions/ when made rather than first landing as a proposal.
When the engineering surface grows (Phase 2+), this directory becomes the natural staging ground for design-doc-level proposals before they harden into ADRs.
-
File:
docs/proposals/NNNN-short-slug.adoc(numbering starts at 0001; pad to 4 digits) -
Top-of-file metadata: status, author, date, last-updated
-
Sections: Context, Proposal, Alternatives considered, Open questions, Acceptance criteria
-
Cross-link to the relevant phase issue (
#48–#54) and to related ADRs / architecture docs
-
docs/decisions/— accepted decisions (ADRs) -
docs/architecture/— current architecture documentation -
docs/PRODUCTION-PATH.adoc— strategic plan; proposals usually fit into a specific phase