entry~1 min readUpdated 2026-06-21#orientation#path

Start Here

This atlas has one throughline: go from "I can program" to "I understand the machine." You can read any note on its own, but the branches are ordered as a descent and a climb. Here's the path.

The path

  1. Reset your mental modelMachine Model. How the hardware actually works under the runtime. Almost no code; everything else hangs off it.
  2. Descend into CC from the Metal, then Pointers & Memory. The language and the manual memory management that make you responsible for everything.
  3. See the metalAssembly & Compiler Output and Toolchain & Linking. What the compiler emits, and the pipeline that builds and debugs it.
  4. (Optional) C++Modern C++. RAII and the rest. Skip it on the first pass if you want; the OS is C-first.
  5. Climb back to systemsSystems Programming and Concurrency & Performance. Talk to the kernel; make it fast.
  6. Build the machineOS from Scratch. The project that consumes all of the above.

Running through all of it: Craftsmanship Low-Level — the testing and review discipline that keeps bare-metal work honest.

How to read it

  • Notes are atomic and source-backed. Each branch index lists its planned notes and the canonical sources behind them.
  • The OS target is x86-64 via cross-compiler + QEMU — host-agnostic, so it runs the same on Intel and Apple Silicon.
  • Assembly is x86-64 primary with an ARM64 appendix per note.

See also: Must Know · Full Index