Ajanınız tüm sisteminizin haritasını çizer. Sonraki her oturum onu yükler.

Bir haritanın üç kuralı

• Topoloji bir kez, kökte çizilir. Bir levha bağlantıları asla tekrar etmez; yalnızca kendi ayrıntısını ve prosedürlerini taşır. Çoğaltma sapmanın başladığı yerdir, bu yüzden yapı gereği hiç yoktur.
• Değerler haritada hiçbir yerde yaşamaz. Port yok, kapasite yok, fiyat yok, sayı yok — bir sayfa sayının nerede yaşadığını söyler, ne olduğunu asla. Değer taşıyan bir harita bir hafta içinde yanlış olur.
• Bağlantıyı değiştiren, haritayı aynı oturumda günceller. Kök bir satır taşır — <what> karşısında <date> tarihinde doğrulandı — ve okuyucu haritaya tam o kadar güvenir.

Kök haritasının tuttukları, sırasıyla

• Projenin ne olduğu, iki cümleyle, ve doğrulama satırı.
• Şema: Kutular ve oklar; her kablo için bir ok ve üzerinde taşınan veri. Sayfadaki her şeyden çok yön önemlidir.
• Listelenen kablolar: Kim başlatır, ne taşınır, ne asla taşınmaz. Yalanları yakalayan bölüm budur.
• Depolar: Durumun yaşadığı her yer, neyi tuttuğu, neyi asla tutmadığı.
• Dizin: Her plaka adıyla, her işlem plaka ve bölüme göre.

Bir plaka neyi barındırır

• Düzleminin her bölümü için: ne olduğu, neyi tuttuğu, kiminle ve hangi yönde konuştuğu, asla ne yapmadığı ve çalıştığında ne olduğu.
• Değerlerin nerede durduğu — işaretçiler, asla değerler değil.
• Süreçleri: Kesin komutlar, işlemin başarılı olduğunu anlamak için neyin geri okunacağı ve bu sırada gerçekte neyin yanlış gittiği, tarihle birlikte.

Bir salı günü ajanınız haritayı açar, dokunmak üzere olduğu kabloyu görür ve bir şey değiştirmeden önce doğrulanmış satırdaki tarihi kontrol eder.

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

Dört bölüm, başka hiçbir şey

• Kararlaştırıldı — yürürlükteki her karar için bir satır: tarih, kim kararlaştırdı ve neden. Bir öneri asla kararlaştırılmış yazılmaz.
• Sıradaki — sıralı, en fazla on madde. Her satır işi adlandırır ve bitmişin neye benzeyeceğini söyler. Sıra, bir planın sahip olduğu tek durumdur.
• Park Edilmiş — ortaya atılan ancak henüz karara bağlanmamış fikirler; her birinin ortaya atıldığı tarih de belirtilmiştir.
• İnsanla başlayın — yalnızca bir insanın alabileceği kararlar, her biri ayrı satırda ve tarihli.

Onu çürütmekten koruyan yasa

• “Bitirildi” demek, kaldırılmış demektir. Bir görevi bitiren kişi onu aynı oturumda kaldırır ve değişenleri ait olduğu yere koyar: teli atlasa, kararı veya ölçümü bir kayda, kodu ise bir commit’e. “Bitirildi” bölümü yoktur.
• Ledger içine dahil edilir. Hâlâ önemli olan yakalanan satır, Next veya Parked bölümünde bir satır haline gelir ve Ledger’dan çıkar; geri kalanlar silinir.
• Bir kerede yalnızca bir yazar. Yeniden yazmadan önce planı okuyun ve tamamını baştan yazın.

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