Architecture decision records (ADRs)
Use 000-template.md for new decisions. Number sequentially (001-…, 002-…).
| ADR | Topic | Status / primary implementation |
|---|---|---|
| 001 — Feature bit governance | Kernel capability bitmask and wire v2 | Accepted — packages/bare-os-protocol/lib/kernel-feature-bits.js, capability-words.md |
| 002 — WASM compile hook | ctx.bareOsWasmKernelCompile (compile-only) |
Accepted — packages/bare-os-booter/lib/bare-os-wasm-kernel.js, env BARE_OS_WASM_KERNEL |
ADRs capture contract and behavior choices that are expensive to reverse: protocol fields, capability semantics, boot policy keys, and deprecation windows.
Related: Documentation home · Contributing to docs · kernel program · naming migrations · compatibility matrix · docs/adr (repo-wide ADRs).