Skip to content

docs: ADR 0007 — charters vs gates - #33

Merged
rxdu merged 1 commit into
mainfrom
docs/adr-0007-module-placement
Jul 12, 2026
Merged

docs: ADR 0007 — charters vs gates#33
rxdu merged 1 commit into
mainfrom
docs/adr-0007-module-placement

Conversation

@rxdu

@rxdu rxdu commented Jul 12, 2026

Copy link
Copy Markdown
Owner

Folds in the design principle stated 2026-07-12: module definition must be forward-looking (consumers change and will change) while construction stays grounded. §1 restructured into module charters (role-based, define what belongs where eventually, veto wrong-home placements regardless of consumer counts) and build gates (the four criteria, governing when code is built or promoted), with incubate-in-the-consumer as the default until gates pass — the charter fixes destination, the gates fix timing, nothing is built before something needs it. Docs-only.

…unded)

User principle folded in: module definition must not depend solely on
existing consumers (they will change). Charters state each module's
role forward-looking and veto wrong-home placements; the four criteria
become build gates governing WHEN code is constructed/promoted, with
incubate-in-the-consumer as the default until gates pass. The charter
fixes destination, the gates fix timing.
@rxdu
rxdu merged commit 3c0410c into main Jul 12, 2026
2 checks passed
@rxdu
rxdu deleted the docs/adr-0007-module-placement branch July 12, 2026 03:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant