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.

Vào một ngày thứ Ba, agent của bạn mở bản đồ, thấy đường nối sắp chạm tới, và kiểm tra ngày trên dòng đã kiểm chứng trước khi thay đổi bất cứ điều gì.

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

Bốn phần, và không gì khác

• Đã quyết định — mỗi quyết định đang có hiệu lực một dòng: ngày, người quyết định, và lý do. Một đề xuất không bao giờ được ghi là đã quyết định.
• Tiếp theo — có thứ tự, tối đa mười mục. Mỗi dòng nêu tên việc và mô tả thế nào là hoàn thành. Thứ tự là trạng thái duy nhất mà một kế hoạch có.
• Tạm gác — những ý tưởng đã nêu nhưng chưa quyết định, mỗi ý kèm ngày được nêu.
• Mở với con người — những quyết định chỉ con người mới có thể đưa ra, mỗi quyết định một dòng, có ghi ngày.

Đạo luật ngăn nó bị mục nát

• Hoàn thành nghĩa là biến mất. Ai hoàn thành một nhiệm vụ thì xóa nó ngay trong cùng phiên đó, và đặt những thứ đã thay đổi vào vị trí phù hợp: sơ đồ nối vào bản đồ tổng thể, quyết định hoặc số đo ghi vào bản ghi, mã nguồn vào một commit. Không có mục nào gọi là "Đã hoàn thành".
• Sổ cái được đi qua từng dòng. Dòng còn quan trọng sẽ trở thành một dòng trong mục Next hoặc Parked và rời khỏi sổ cái; phần còn lại bị loại bỏ.
• Mỗi lần chỉ một người viết. Hãy đọc kế hoạch trước khi viết lại, và viết lại toàn bộ.

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