~ $ cd projects/architecture && cat README.md

How this site is built

The code of this site is written by an AI — Claude, in Claude Code — from what I ask of it. I say what the site is and how it should be made; it writes the program, and the tests.

The picture is that program. Every ball is a file, every box a folder of the frame or a feature, and every arrow a box that needs another. It is read from the source by the TypeScript compiler, at every commit that changed it. Play it and watch it grow; tangle it to see the same files with nobody saying where anything goes, and untangle it again. Put the tests in, and every file with something in it to run that no test imports directly is drawn as a ring. Point at a file, and its own arrows come out: what it needs, and what needs it.

c862b80 27 September 2026 — The sixty-four rooms drawn as rooms: walls where there is no way out, a door that wants a key marked until it is opened, what each room holds now as a picture, the player standing in it, and the life left as hearts. The game's own words and its status line are as it printed them
366 files in 34 boxes, 156 tests · 209 arrows between boxes, 325 of all 802 onto a type · a test reaches 188 of the 316 files with something to test · no boxes in a circle

The arrows point one way

A rule written in a document is a rule that can be missed, by a person or by an AI. So the rules of this code are not in a document: they are tests it has to pass. architecture.test.ts reads the same graph this picture draws, and fails when

a file outside a folder named browser/ touches the page,
the frame imports a feature,
two boxes need each other round in a circle,
a file exports more than one value,
a feature is missing from the diagrams in ARCHITECTURE.md.

The dashed arrows need only a type: a box that depends on an interface, not on what implements it. That is dependency inversion, and it is what lets a feature be removed by removing its folder.

8 September 2026

On its first day the source was sorted by kind of file: a core and a ui. On the second it was sorted by what the site is — a frame, and the features standing in it — in one commit: The folders say what the site is, not what kind of file each one holds. Drag the slider back to it and watch the files cross.