Je agent tekent de kaart van je hele systeem. Elke sessie daarna laadt hem.

De drie regels van een kaart

• De topologie wordt één keer getekend, in de wortel. Een plaat herhaalt nooit de verbindingen; ze draagt alleen haar eigen detail en haar procedures. Duplicatie is waar drift begint, dus die bestaat er niet, bij constructie.
• Waarden staan nergens in de kaart. Geen poorten, limieten, prijzen of aantallen — een pagina zegt waar het getal woont, nooit wat het is. Een kaart die waarden draagt is binnen een week fout.
• Wie een verbinding wijzigt, werkt de kaart bij in dezelfde sessie. De wortel draagt een regel — geverifieerd op <date> tegen <what> — en een lezer vertrouwt de kaart precies zover.

Wat de wortelkaart bevat, in volgorde

• Wat het project is, in twee zinnen, en de geverifieerde regel.
• Het diagram: vakken en pijlen, één pijl per draad met wat erover reist. De richting is belangrijker dan al het andere op de pagina.
• De draden, opgesomd: wie initieert, wat er reist, wat er nooit reist. Dit is het gedeelte dat de leugens vangt.
• De stores: elke plek waar state leeft, wat die bevat en wat die nooit bevat.
• De index: elke plaat bij naam, elke procedure bij plaat en sectie.

Wat een plaat bevat

• Voor elk deel van zijn vlak: wat het is, wat het bevat, met wie het communiceert en in welke richting, wat het nooit doet, en wat er gebeurt wanneer het draait.
• Waar de waarden leven — pointers, nooit waarden.
• De procedures: de exacte commando's, wat je terug moet lezen om te weten dat het gewerkt heeft, en wat er daadwerkelijk misging bij het uitvoeren, met de datum.

Op een dinsdag opent je agent de kaart, ziet de verbinding die hij gaat aanraken, en controleert de datum op de geverifieerde regel voordat hij iets verandert.

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore

Vier secties, en niets anders

• Besloten — één regel per beslissing die geldt: de datum, wie besloot, en waarom. Een voorstel wordt nooit als besloten opgeschreven.
• Volgende — geordend, maximaal tien items. Elke regel noemt het ding en zegt hoe af eruitziet. Volgorde is de enige status die een plan heeft.
• Geparkeerd — ideeën die zijn voorgesteld maar nog niet zijn beslist, elk met de datum van indiening.
• Begin met de mens — de beslissingen die alleen een persoon kan nemen, één regel per beslissing, met datum.

De wet die voorkomt dat het rot.

• ‘Afgerond’ betekent weggehaald. Wie een item afmaakt, haalt het in dezelfde sessie weg en plaatst wat veranderd is op de juiste plek: de draad in de atlas, de beslissing of de meting in een record, de code in een commit. Er is geen ‘Afgerond’-sectie.
• De Ledger wordt hierin opgenomen. Een gevangen regel die nog belangrijk is, wordt één regel in Next of Parked en verlaat de Ledger; de rest verdwijnt.
• Eén schrijver tegelijk. Lees het plan eerst voordat je het herschrijft, en herschrijf het in zijn geheel.

my-app-plan — walked 2026-09-10 by the Tuesday session

## Decided
2026-08-14 · you · Postgres, not SQLite — two writers, one box
2026-09-02 · you · ship the importer before the dashboard — nobody can try it empty

## Next
1. Importer accepts CSV with a header row. Finished: a real customer file lands.
2. Retry the webhook on 5xx. Finished: one blip stops costing a record.
3. Dashboard: one chart, last 30 days. Finished: it answers "is it working".

## Parked
2026-08-30 · a public status page — nothing to show yet

## Open with your user
2026-09-08 · free tier: how many rows before it asks for money