This directory holds contributor and project-internal documentation rather than end-user docs.
Contents:
testing.md— conformance and benchmark harnessesroadmap.md— current open items and exit criteriaopcodes.md— VM opcode reference (fused-op internals; not public language semantics)design/compiler-architecture.md— compiler conceptual reference: single-pass Pratt parser, expression/statement/declaration compilation, type system, scope/upvalues, module resolutiondesign/vm-architecture.md— bytecode VM conceptual reference: values, stack, chunk format, GC, call protocol, peephole fusions, invariantsdesign/gbc-spec.md— bytecode cache format specificationperf/metrics.md— performance instrumentation referenceperf/baseline-2026-06-01.md— recorded benchmark baselinedocumentation-inventory.md— public-docs coverage audit baselinedocumentation-contradictions.md— recorded documentation/implementation contradictions and their resolutionsdocumentation-plan.md— remaining public-documentation workfeature-matrix.md— feature/API implementation and test-coverage matrix
Historical design records that no longer define the current public behavior live in ../archive/.