您的代理程式會繪製出您整個系統的地圖，之後的每個工作階段都會載入它。

地圖的三條規則

• 拓撲只在根地圖中繪製一次。 圖版絕不重述連線；它只承載自身的細節與程序。重複是偏移的起點，因此設計上就不存在重複。
• 地圖上不存放任何數值。 沒有連接埠、容量、價格或數量——頁面只說明數值存放在哪裡，絕不寫出數值本身。帶有數值的地圖一週內就會出錯。
• 無論誰改動了連線，都在同一個會話中更新地圖。 根地圖上有一行——於 <date> 對 <what> 完成驗證——讀者對地圖的信任也正好到此為止。

根地圖依序記載的內容

• 用兩句話說明這個專案是什麼，以及驗證那一行。
• 圖表：方框與箭頭，每條連線一個箭頭，並標明其上傳輸的內容。方向比頁面上其他任何東西都重要。
• 連線清單：由誰發起、傳輸什麼、絕不傳輸什麼。這一節就是用來抓出謊言的。
• 儲存區：狀態所在的每個位置、它存放什麼、絕不存放什麼。
• 索引：每張圖版按名稱列出，每個程序按圖版與章節列出。

一張圖版記載什麼

• 針對其層面的每個部分：它是什麼、存放什麼、與什麼通訊以及朝哪個方向、絕不做什麼，以及運行時會發生什麼。
• 數值存放之處——只有指標，絕無數值。
• 其程序：確切的指令、事後要讀回什麼以確認成功，以及實際出過什麼問題，並附日期。

某個星期二，您的代理程式打開地圖，看到即將觸及的線路，於是在做出任何變更之前，先確認了該驗證行上的日期。

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

四個章節，僅此而已。

• 已決定 — 每項有效決定一行：記載日期、決定者以及原因。提案絕不會被寫成已決定。
• 待辦 — 按順序排列，最多十項。每行寫明事項名稱並說明完成的樣貌。順序是計劃唯一的狀態。
• 已擱置 — 已提出但尚未決定的想法，每個想法都標有提出日期。
• 從人的角度出發——只有人才能做出的決定，每項一行，並標明日期。

防止其腐化的法則

• 完成即移除。完成一項工作後，就在同一個會話中將其移除，並把變更放到該放的地方：線路放進圖譜，決定或測量結果記入記錄，程式碼提交到 commit。不存在「已完成」區塊。
• 賬本會被逐一走訪。仍然重要的被擷取列會成為「Next」或「Parked」中的一行，並離開賬本；其餘的則被清除。
• 一次只有一位撰寫者。重寫計劃前先閱讀它，並整體重寫。

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