Specification over implementation notes
Platform spec ADR
Specification over implementation notes
Spec standingStandard
- Conformance evidence policy - Contracts and edge cases States the normative guarantees and what happens at boundaries or failure edges.
- Conformance evidence policy - Design model Explains the persistent concepts, entities, and boundaries this feature relies on.
- Conformance evidence policy - Examples Gives concrete newcomer-friendly scenarios mapped to real compiler paths.
- Conformance evidence policy - FAQ and troubleshooting Answers common operator and contributor questions with practical next checks.
- Conformance evidence policy - Flow and algorithm Walks through runtime/order-of-operations behavior in the implementation.
- Conformance evidence policy - Verification and traceability Shows how the team proves this feature works and where evidence lives.
0 revisions (git unavailable at build; counts may be empty)
No commits recorded for this path.
Full tree: run pnpm verify:platform-spec-layout (writes src/generated/platform-spec-layout-report.json).
Context
Section titled “Context”Implementation crates accumulated informal notes that diverged from published contracts.
Decision
Section titled “Decision”Normative platform-spec prose and ADRs under this feature supersede informal comments in implementation crates until explicitly migrated into spec text.
Consequences
Section titled “Consequences”Engineers file spec/ADR updates when behavior changes; crate comments are non-authoritative for conformance arguments.
Verification anchors
Section titled “Verification anchors”compiler/crates/beskid_tests/src/analysis/diagnostics.rscompiler/crates/beskid_tests/src/doc_tests.rscompiler/crates/beskid_e2e_tests/src/tests/runtime_cases.rs