# Nyash Design Notes

Public, stable design documents and architecture explanations.

Use for rationale, trade‑offs, and diagrams that are safe to cite.

Contents to consolidate here:
- Architecture overviews derived from ARCHITECTURE.md
- Backend design (LLVM/Cranelift) summaries
- MIR/IR evolution notes that are not drafts

Draft, exploratory, or long‑form papers should remain under `docs/private/` until finalized.

