Specification over implementation notes
Platform spec ADR
Specification over implementation notes
Spec standingStandard
- Workspace and lock contracts - Contracts and edge cases Compiler guarantees for lock-backed graphs and workspace layout invariants.
- Workspace and lock contracts - Design model Compiler entities for workspace roots and lock materialization (workspace key prose defers to tooling).
- Workspace and lock contracts - Examples Gives concrete newcomer-friendly scenarios mapped to real compiler paths.
- Workspace and lock contracts - FAQ and troubleshooting Answers common operator and contributor questions with practical next checks.
- Workspace and lock contracts - Flow and algorithm Compiler order of operations for workspace discovery, lock apply, and graph materialization.
- Workspace and lock contracts - 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_analysis/src/resolve/mod.rscompiler/crates/beskid_cli/src/commands/compiler/crates/beskid_tests/src/projects/corelib/compile.rs