eric/audita
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 6 Wiki Activity

Adopt upstream ADR guidance and revise durable documentation requirements

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-08 15:18:38 +00:00
parent d2c0e22a9a
commit c94086048a
3 changed files with 28 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/roadmap/glossary-stages.md
View File

@@ -119,12 +119,14 @@ semantics remain part of the open decision below.
### Durable Decision Record
Completion requires recording the scope model and its rationale in an accepted
[ADR](../adr/README.md) before retiring this roadmap. Put the enduring
classification rule in the [architecture policy](../policy/architecture.md),
linked to that ADR; keep the implemented per-field scope and fallback contracts
in the [configuration reference](../config.md). The roadmap continues to own
implementation status until the feature lands.
Completion requires recording the scope model in durable documentation before
retiring this roadmap. Put the enduring classification rule and its rationale
in the [architecture policy](../policy/architecture.md); keep the implemented
per-field scope and fallback contracts in the [configuration reference](../config.md).
These configuration design decisions do not require an ADR. Reserve ADRs for
major architectural decisions under the
[documentation policy](../policy/documentation.md#architecture-decision-records).
The roadmap continues to own implementation status until the feature lands.
Update the [configuration change guide](../internal/cli-config.md) to require
classifying each new setting by consumer lifecycle, specifying its inheritance
@@ -175,7 +177,7 @@ Exercise the selected request and validation overrides through stage consumers,
including independent budgets without changing shared backend admission or the
initial transcript sections. Cover all validation-profile fallback cases above
and preserve the distinction between explicit and derived values in inspection.
Confirm that the durable policy, ADR, configuration contracts, and contributor
Confirm that the durable policy, configuration contracts, and contributor
guidance are in place before declaring this feature complete.
## Open Decisions