Marcos Marx.

Rebuilding from first principles

The protocol for learning by rebuilding things that already exist.

I rebuild things that already exist — a Pomodoro timer, an Obsidian-like editor, pieces of a terminal. Not to ship them. To find the wall the original authors hit, and hit it myself.

The protocol

  1. Pick something you use daily and take for granted.
  2. Rebuild the smallest honest version — small is fine, faking the hard part is not.
  3. Write down where you got stuck. The stuck points are the curriculum.
  4. Read the real implementation only after suffering. Before: trivia. After: decisions.

Current rebuilds

ProjectRebuildingThe wall so far
tomatteA Pomodoro timerMenu bar apps and the macOS lifecycle
(editor)Obsidian-style notesPlugins are an architecture, not a feature
(terminal)How a shell talks to the kernelPTYs, detail by detail, step by step

Stuck points archive

This section grows as I get stuck, which is to say: constantly. Each entry is one wall, what finally made it click, and what the click generalized to.

On this page