An interactive reference / Vol. 01

Understanding Software

A field guide for people who use, design, and build software.

Written in conversation with an AI guide.

Software can feel like a sealed box. You tap a screen, send a message, or run a command—and a stack of hidden systems springs into motion.

This is a place to open that box. Follow the diagrams, trace the layers, and ask about anything that catches your attention.

A tap travelling down through three layers of softwareAn isometric diagram of three stacked planes. A touch lands on a single cell of the top grid and travels straight down through the logic and system planes.FIG.001ONE TAP / THREE TRANSLATIONS01 INTERFACEPIXELS + TOUCH02 LOGICEVENT + INTENT03 SYSTEMMEMORY + STATEtapx, y
FIG.001

A simple input becomes useful only after each layer translates it into a language the next layer understands.

START WITH A QUESTION

What actually happens when I press a button?

Ask the guide
Section through a key switch, from keycap to scancodeA cutaway section through a mechanical key switch: keycap, stem, return spring, contacts, and the circuit board beneath. A dashed line follows the signal from the contacts out of the drawing as a scancode.FIG.004SECTION A—A / SWITCH AT REST01 KEYCAPWHAT YOU TOUCH02 STEMTRAVEL 4 MM03 SPRINGRETURNS THE KEY04 CONTACTSCIRCUIT CLOSES05 BOARDCOPPER + FIBREGLASS06 SCANCODENOW IT IS SOFTWARE
FIG.002

Nothing is software until something physical says so — a spring returns, two contacts touch, and a closed circuit becomes a number to read.

Exploded view of the layers a single request passes throughAn exploded isometric drawing of six layers pulled apart along a single vertical axis: interface, application, runtime, model, data, and machine. Each layer is numbered and labelled with a leader line.FIG.003EXPLODED VIEW / TRACE THE SIGNAL01 INTERFACEPIXELS + INPUT02 APPLICATIONRULES + INTENT03 RUNTIMETIME + MEMORY04 MODELMEANING + STATE05 DATASTORAGE + RECALL06 MACHINESILICON + POWER
Artifact Studio
A software system drawn as a landscape of cost and complexityAn isometric surface plot with one dominant peak and three smaller ridges rising from a flat base, drawn as a shaded mesh.FIG.002COST SURFACE / NOT TO SCALE01 PEAKONE HARD PROBLEM02 RIDGEWHAT IT TOUCHES03 BASELINEWHAT YOU SEE
V1.0Ask · plan · illustrate · revise.Sample figure · cost surface

NO PREREQUISITES REQUIRED

Go from “it just works” to “I see how it works.”

Bring a concept, a line of code, or a half-formed question. The guide will meet you there.

Start a conversation