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

سه قاعده نقشه

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

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

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

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

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

در یک سه‌شنبه، نماینده شما نقشه را باز می‌کند، سیمی را که می‌خواهد دست بزند می‌بیند و پیش از تغییر هر چیزی، تاریخ خط تأییدشده را بررسی می‌کند.

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. بخشی به نام «تمام شد» وجود ندارد.
• دفتر Ledger پیمایش می‌شود. ردیفی که شناسایی شده و هنوز اهمیت دارد، یک خط در Next یا Parked می‌شود و از Ledger خارج می‌گردد؛ بقیه از بین می‌روند.
• یک نویسنده در هر بار. قبل از بازنویسی، طرح را بخوانید و سپس آن را به طور کامل بازنویسی کنید.

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