Agentul dumneavoastră desenează harta întregului sistem. Fiecare sesiune ulterioară o încarcă.

Cele trei reguli ale unei hărți

• Topologia este desenată o singură dată, în rădăcină. O planșă nu reia niciodată firele; ea conține doar propriile detalii și procedurile ei. Duplicarea este locul unde începe derivarea, deci prin construcție nu există nicio duplicare.
• Valorile nu se află nicăieri pe hartă. Fără porturi, limite, prețuri sau contoare — o pagină spune unde locuiește numărul, niciodată ce este el. O hartă care poartă valori este greșită într-o săptămână.
• Cine modifică un fir actualizează harta în aceeași sesiune. Rădăcina conține o linie — verificată la <date> în raport cu <what> — și cititorul are încredere în hartă exact până atât.

Ceea ce conține harta rădăcinii, în ordine

• Ce este proiectul, în două propoziții, și linia verificată.
• Diagrama: cutii și săgeți, câte o săgeată pentru fiecare fir, cu ceea ce circulă pe ea. Direcția contează mai mult decât orice altceva pe pagină.
• Firele, enumerate: cine inițiază, ce circulă, ce nu circulă niciodată. Aceasta este secțiunea care prinde minciunile.
• Stocurile: fiecare loc unde trăiește starea, ce conține, ce nu conține niciodată.
• Indexul: fiecare placă după nume, fiecare procedură după placă și secțiune.

Ce conține o placă

• Pentru fiecare parte a planului său: ce este, ce conține, cu ce comunică și în ce direcție, ce nu face niciodată și ce se întâmplă când rulează.
• Unde se află valorile — pointeri, niciodată valori.
• Procedurile sale: comenzile exacte, ce trebuie citit înapoi pentru a ști că a funcționat și ce a mers de fapt prost în timpul execuției, cu data.

Într-o marți, agentul dumneavoastră deschide harta, vede cablul pe care urmează să-l atingă și verifică data de pe linia verificată înainte să schimbe ceva.

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

Patru secțiuni, și nimic altceva

• Decis — o linie pentru fiecare decizie în vigoare: data, cine a decis și de ce. O propunere nu este niciodată notată ca decisă.
• Următor — ordonat, cel mult zece puncte. Fiecare linie numește lucrul și spune cum arată finalizarea. Ordinea este singura stare pe care un plan o are.
• Parked — idei propuse și nu decizate, fiecare cu data la care a fost propusă.
• Începe cu omul — deciziile pe care doar o persoană le poate lua, câte una pe linie, cu dată.

Legea care împiedică degradarea

• „Finalizat” înseamnă eliminat. Cine finalizează un element îl elimină în aceeași sesiune și plasează ce s-a schimbat acolo unde îi este locul: firul în atlas, decizia sau măsurătoarea într-un registru, codul într-un commit. Nu există o secțiune „Finalizat”.
• Ledger-ul este parcurs în interiorul lui. Un rând prins care încă contează devine o linie în Next sau Parked și părăsește Ledger-ul; restul dispare.
• Un singur scriitor odată. Citește planul înainte de a-l rescrie și rescrie-l integral.

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