Agent của bạn vẽ bản đồ toàn bộ hệ thống của bạn. Mỗi phiên làm việc sau đó đều nạp nó.

Ba quy tắc của bản đồ

• Cấu trúc liên kết được vẽ một lần, ở bản gốc. Một trang không bao giờ lặp lại các đường kết nối; nó chỉ chứa chi tiết của riêng mình và các quy trình của nó. Sự trùng lặp là nơi sai lệch bắt đầu, nên theo thiết kế không có trùng lặp nào.
• Các giá trị không nằm ở đâu trong bản đồ. Không có cổng, giới hạn, giá cả hay số lượng — một trang chỉ nói con số nằm ở đâu, không bao giờ nói nó là gì. Một bản đồ mang theo giá trị sẽ sai trong vòng một tuần.
• Ai thay đổi một đường kết nối thì cập nhật bản đồ trong cùng phiên đó. Bản gốc chứa một dòng — đã xác minh <date> đối chiếu với <what> — và người đọc tin bản đồ đúng đến mức đó.

Bản đồ gốc chứa những gì, theo thứ tự

• Dự án là gì, trong hai câu, và dòng xác minh.
• Sơ đồ: các khối và mũi tên, mỗi đường kết nối một mũi tên với những gì chạy trên đó. Hướng quan trọng hơn bất cứ thứ gì khác trên trang.
• Các đường kết nối được liệt kê rõ: ai khởi tạo, thông tin gì được truyền đi, và thông tin gì không bao giờ được truyền. Đây chính là phần giúp phát hiện ra những lời nói dối.
• Các kho lưu trữ: mọi nơi trạng thái tồn tại, chúng chứa gì, và chúng không bao giờ chứa gì.
• Mục lục: mỗi bản ghi kèm tên, mỗi quy trình được liệt kê theo bản ghi và mục.

Bản ghi chứa những gì

• Với mỗi phần của mặt phẳng đó: nó là gì, nó chứa gì, nó giao tiếp với cái gì và theo hướng nào, nó không bao giờ làm gì, và điều gì xảy ra khi nó hoạt động.
• Nơi các giá trị tồn tại — là các con trỏ, chứ không phải chính các giá trị.
• Các quy trình của nó: các lệnh chính xác, cần đọc lại cái gì để biết quy trình đã thành công, và những gì thực sự đã gặp sự cố khi thực hiện, kèm theo ngày tháng.

Bản đồ gốc, về hình dạng

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