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

地圖的三條規則

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