Az agent feltérképezi a teljes rendszerét. Minden ezt követő munkamenet betölti.

A térkép három szabálya

• A topológiát egyszer rajzoljuk meg, a gyökérben. Egy lap sosem ismétli meg a vezetékeket; csak a saját részleteit és eljárásait tartalmazza. A duplikáció az elcsúszás kezdete, ezért felépítésből fakadóan nincs is belőle.
• Az értékek sehol nem szerepelnek a térképen. Nincs port, kapacitás, ár vagy darabszám – egy oldal csak azt mondja meg, hol él a szám, sosem azt, mi az. Az értékeket hordozó térkép egy héten belül téves lesz.
• Aki egy vezetéket megváltoztat, ugyanabban a munkamenetben frissíti a térképet. A gyökér tartalmaz egy sort – ellenőrizve <date> ekkor: <what> –, és az olvasó pontosan ennyire bízik a térképben.

Amit a gyökértérkép tartalmaz, sorrendben

• Mi a projekt, két mondatban, és az ellenőrzött sor.
• A diagram: dobozok és nyilak, vezetékenként egy nyíllal, jelezve, mi halad rajta. Az irány fontosabb, mint bármi más az oldalon.
• A vezetékek felsorolva: ki kezdeményez, mi halad át rajtuk, és mi sosem. Ez az a szakasz, amely leleplezi a hazugságokat.
• A tárolók: minden hely, ahol az állapot él, mit tartalmaz, és mit sosem.
• A mutató: minden tábla név szerint, minden eljárás tábla és szakasz szerint.

Mit tartalmaz egy tábla

• A síkja minden része esetén: mi az, mit tartalmaz, kivel és mely irányban beszél, mit sosem tesz, és mi történik, amikor fut.
• Ahol az értékek élnek – pointerek, sosem értékek.
• A műveletei: a pontos parancsok, mit kell visszolvasni, hogy működött-e, és mi ment ténylegesen félre közben, dátummal.

Egy keddi napon az ügynököd kinyitja a térképet, meglátja a vezetéket, amelyet érinteni készül, és megnézi az ellenőrzött sor dátumát, mielőtt bármit változtatna.

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

Négy szakasz, és semmi más

• Eldöntve – döntésenként egy sor az érvényben lévőkről: a dátum, aki döntött, és a miért. Egy javaslatot sosem írnak eldöntöttként.
• Következik – sorrendben, legfeljebb tíz tétel. Minden sor megnevezi a dolgot, és kimondja, hogyan néz ki a kész. A sorrend az egyetlen állapot, amelyet egy terv ismer.
• Parkolva — felmerült ideák, amelyeknek még nem van döntése, azonosítva a megfelmerülési dátumukkal.
• Kezdjük az emberrel – azok a döntések, amelyeket csak ember hozhat meg, soronként egyet, dátummal ellátva.

A törvény, amely megakadályozza a rothadását

• „Befejezve” azt jelenti, hogy eltűnt. Aki befejez egy tételt, még ugyanabban a munkamenetben eltávolítja, és oda teszi, ami megváltozott: a vázat az atlaszba, a döntést vagy a mérést a nyilvántartásba, a kódot egy commitba. Nincs „Kész” részleg.
• A Ledgerbe kerül be. Egy elkapott, de még fontos sor egyetlen sorként bekerül a Next vagy a Parked rovatba, és elhagyja a Ledgert; a többi elhal.
• Egy időben egy író. Olvassa el a tervet, mielőtt átírja, és írja át egészében.

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