يرسم وكيلك خريطة لنظامك بأكمله، وتُحمَّل في كل جلسة لاحقة.

القواعد الثلاث للخريطة

• تُرسم البنية مرة واحدة، في الجذر. لا تعيد اللوحة رسم الأسلاك أبدًا؛ بل تحمل تفاصيلها الخاصة وإجراءاتها فقط. التكرار هو منشأ الانحراف، لذا لا يوجد تكرار من الأساس.
• القيم لا توجد في أي مكان في الخريطة. لا منافذ ولا حدود ولا أسعار ولا أعداد — الصفحة تشير إلى مكان وجود الرقم، لا إلى ما هو. الخريطة التي تحمل قيمًا تصبح خاطئة خلال أسبوع.
• من يغيّر سلكًا يحدّث الخريطة في الجلسة نفسها. يحمل الجذر سطرًا — تم التحقق في <التاريخ> مقابل <الشيء> — ويثق القارئ بالخريطة إلى هذا الحد بالضبط.

ما تحتويه الخريطة الجذرية، بالترتيب

• ما هو المشروع، في جملتين، وسطر التحقق.
• الرسم التخطيطي: مربعات وأسهم، سهم واحد لكل سلك مع ما ينتقل عليه. الاتجاه أهم من أي شيء آخر في الصفحة.
• الأسلاك، مُدرجة: من يبدأ، ما ينتقل، وما لا ينتقل أبدًا. هذا هو القسم الذي يكشف الأكاذيب.
• المخازن: كل مكان توجد فيه الحالة، ما يحتويه، وما لا يحتويه أبدًا.
• الفهرس: كل لوحة بالاسم، وكل إجراء حسب اللوحة والقسم.

ما تحتويه اللوحة

• لكل جزء من مستواها: ما هو، وما يحتويه، ومع من يتواصل وفي أي اتجاه، وما لا يفعله أبدًا، وما يحدث عند تشغيله.
• أين توجد القيم — مؤشرات، وليست القيم نفسها أبدًا.
• إجراءاتها: الأوامر الدقيقة، وما يجب قراءته للتأكد من نجاحها، وما حدث فعلًا من أخطاء أثناء تنفيذها، مع التاريخ.

في يوم ثلاثاء، يفتح وكيلك الخريطة، ويرى السلك الذي على وشك لمسه، ويتحقق من التاريخ على السطر الموثّق قبل أن يغيّر أي شيء.

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

أربعة أقسام، ولا شيء غيرها

• تمّ — سطر واحد لكل قرار ساري: التاريخ، ومن قرر، ولماذا. لا يُكتب اقتراح أبدًا كأنه قرار.
• التالي — مرتّب، عشرة بنود كحد أقصى. يذكر كل سطر الشيء ويوضح كيف يبدو الاكتمال. الترتيب هو الحالة الوحيدة التي تملكها الخطة.
• معلق — أفكار تم طرحها ولم يتم اتخاذ قرار بشأنها، مع تاريخ طرح كل فكرة.
• افتح مع الإنسان — القرارات التي لا يمكن إلا لشخص أن يتخذها، قرار واحد في كل سطر، مع تاريخ.

القانون الذي يمنعه من التعفن

• الانتهاء يعني الاختفاء. من ينتهي من مهمة ما يزيلها في نفس الجلسة ويضع ما تغيّر في مكانه المناسب: السلك في الأطلس، والقرار أو القياس في سجل، والكود في عملية التحديث. لا يوجد قسم "منجز".
• يُدمج السجل فيه. الصف المُلتقط الذي لا يزال ذا أهمية يصبح سطرًا واحدًا في "Next" أو "Parked" ويغادر السجل؛ أما الباقي فيضيع.
• كاتب واحد في كل مرة. اقرأ الخطة قبل إعادة كتابتها، ثم أعد كتابتها بالكامل.

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