ایجنت شما نقشه کل سیستم شما را می‌کشد. هر جلسه بعدی آن را بارگذاری می‌کند.

سه قاعده نقشه

• توپولوژی یک بار، در ریشه، کشیده می‌شود. یک پلیت هرگز سیم‌ها را بازگو نمی‌کند؛ فقط جزئیات خودش و رویه‌هایش را حمل می‌کند. تکثیر جایی است که انحراف آغاز می‌شود، پس به‌ساخت هیچ‌جایش نیست.
• مقادیر هیچ‌جای نقشه نیستند. نه درگاه، نه ظرفیت، نه قیمت، نه شمارش — یک صفحه می‌گوید عدد کجا زندگی می‌کند، هرگز چه چیزی است. نقشه‌ای که مقدار حمل کند، ظرف یک هفته غلط است.
• هر کس سیمی را تغییر دهد، نقشه را در همان جلسه به‌روز می‌کند. ریشه یک خط دارد — تأییدشده در <تاریخ> نسبت به <چه چیزی> — و خواننده نقشه را دقیقاً تا همان حد باور می‌کند.

آنچه نقشه ریشه نگه می‌دارد، به ترتیب

• پروژه چیست، در دو جمله، و خط تأیید.
• نمودار: جعبه‌ها و پیکان‌ها، یک پیکان برای هر سیم با آنچه روی آن می‌رود. جهت از هر چیز دیگر روی صفحه مهم‌تر است.
• سیم‌ها، فهرست‌شده: چه کسی آغاز می‌کند، چه چیزی می‌رود، چه چیزی هرگز نمی‌رود. این همان بخشی است که دروغ‌ها را می‌گیرد.
• فروشگاه‌ها: هر مکانی که وضعیت در آن زندگی می‌کند، چه چیزی نگه می‌دارد و چه چیزی هرگز نگه نمی‌دارد.
• فهرست: هر صفحه به نام، و هر روش بر اساس صفحه و بخش مربوطه.

یک صفحه چه چیزی را در خود نگه می‌دارد

• برای هر بخش از صفحه‌اش: چیست، چه چیزی نگه می‌دارد، با چه چیزی و در چه جهتی گفتگو می‌کند، چه کاری هرگز نمی‌کند، و وقتی اجرا می‌شود چه اتفاقی می‌افتد.
• جایی که مقادیر قرار دارند — اشاره‌گرها، هرگز خود مقادیر.
• روش‌های آن: دستورهای دقیق، چه چیزی را باید خواند تا معلوم شود کار انجام شده، و چه چیزی واقعاً در حین انجام آن خراب شده، همراه با تاریخ.

نقشه ریشه، از نظر شکل

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