Agen Anda menggambar peta seluruh sistem Anda. Setiap sesi berikutnya memuatnya.

Tiga aturan sebuah peta

• Topologi digambar sekali, di akar. Sebuah lembar tidak pernah menuliskan ulang kabel-kabel; ia hanya membawa detailnya sendiri dan prosedurnya. Duplikasi adalah tempat penyimpangan dimulai, jadi tidak ada duplikasi sejak awal.
• Nilai tidak berada di mana pun dalam peta. Tidak ada port, batas, harga, atau jumlah — sebuah halaman menyatakan di mana angka itu berada, bukan berapa nilainya. Peta yang membawa nilai akan salah dalam seminggu.
• Siapa pun yang mengubah sebuah kabel memperbarui peta dalam sesi yang sama. Akar membawa satu baris — terverifikasi <date> terhadap <what> — dan pembaca mempercayai peta sebatas itu saja.

Apa yang disimpan peta akar, secara berurutan

• Apa itu proyek tersebut, dalam dua kalimat, dan baris yang telah diverifikasi.
• Diagram tersebut terdiri dari kotak-kotak dan panah-panah; satu panah untuk setiap kabel beserta apa yang mengalir di dalamnya. Arah lebih penting daripada hal lainnya pada halaman tersebut.
• Kabel-kabel tersebut, diuraikan sebagai berikut: siapa yang memulai prosesnya, apa yang dikirim, dan apa yang tidak pernah dikirim. Inilah bagian yang mengungkap kebohongan.
• Toko-toko: setiap tempat di mana state berada, apa yang disimpannya, dan apa yang tidak pernah disimpannya.
• Indeks: setiap pelat dicantumkan berdasarkan namanya, setiap prosedur dicantumkan berdasarkan pelat dan bagiannya.

Apa yang dimuat dalam sebuah pelat

• Untuk setiap bagian dari bidangnya: apa itu, apa yang disimpannya, dengan apa dan ke arah mana ia berkomunikasi, apa yang tidak pernah dilakukannya, dan apa yang terjadi ketika ia berjalan.
• Di mana nilai-nilai berada — pointer, bukan nilai itu sendiri.
• Prosedurnya: perintah-perintah yang tepat, apa yang perlu dibaca untuk mengetahui apakah prosesnya berhasil, serta apa yang sebenarnya salah selama pelaksanaannya, beserta tanggalnya.

Pada hari Selasa, agen Anda membuka peta, melihat kabel yang akan disentuhnya, dan memeriksa tanggal pada baris terverifikasi sebelum mengubah apa pun.

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

Empat bagian, dan tidak ada yang lain

• Decided — satu baris per keputusan yang berlaku: tanggal, siapa yang memutuskan, dan alasannya. Sebuah usulan tidak pernah ditulis sebagai keputusan.
• Next — berurutan, maksimal sepuluh item. Setiap baris menyebutkan halnya dan menjelaskan seperti apa bentuk selesainya. Urutan adalah satu-satunya status yang dimiliki sebuah plan.
• Parked — ide yang diajukan dan belum diputuskan, masing-masing dengan tanggal pengajuannya.
• Mulai dengan manusia — keputusan-keputusan yang hanya bisa diambil oleh manusia, satu baris per keputusan, disertai tanggalnya.

Hukum yang mencegahnya membusuk

• Selesai berarti hilang. Siapa pun yang menyelesaikan suatu butir menghapusnya dalam sesi yang sama dan meletakkan apa yang berubah di tempat yang semestinya: kabelnya ke atlas, keputusan atau pengukurannya ke dalam catatan, kodenya ke dalam komit. Tidak ada bagian Selesai.
• Ledger dimasukkan ke dalamnya. Baris yang tertangkap dan masih penting menjadi satu baris di Next atau Parked dan keluar dari Ledger; sisanya hilang.
• Satu penulis pada satu waktu. Baca rencananya sebelum menulis ulang, dan tulis ulang seluruhnya.

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