Ваш агент накреслює карту всієї вашої системи. Кожна наступна сесія її завантажує.

Три правила карти

• Топологія накреслюється один раз, у корені. Аркуш ніколи не повторює з’єднання; він несе лише власні деталі та свої процедури. Дублювання — це початок дрейфу, тому його немає за самою конструкцією.
• Значення на карті не живуть ніде. Жодних портів, лімітів, цін чи лічильників — сторінка каже, де живе число, а не яким воно є. Карта, що несе значення, за тиждень стає неправильною.
• Хто змінює з’єднання, той оновлює карту в тій самій сесії. Корінь містить рядок — перевірено <date> щодо <what> — і читач довіряє карті рівно настільки.

Що містить коренева карта, за порядком

• Що таке проєкт, у двох реченнях, та перевірений рядок.
• Діаграма: блоки та стрілки, по одній стрілці на кожен дріт із зазначенням того, що ним передається. Напрямок важливіший за все інше на сторінці.
• З’єднання, перелічені: хто ініціює, що передається, що ніколи не передається. Саме цей розділ викриває брехню.
• Сховища: кожне місце, де живе стан, що він містить, а що ніколи не містить.
• Індекс: кожна плита за назвою, кожна процедура за плитою та розділом.

Що містить плита

• Для кожної частини її площини: що це таке, що вона містить, з чим і в якому напрямку взаємодіє, чого вона ніколи не робить і що відбувається, коли вона запускається.
• Де живуть значення — вказівники, а не самі значення.
• Його процедури: точні команди, що прочитати, щоб переконатися, що все спрацювало, і що насправді пішло не так під час виконання, із датою.

У вівторок ваш агент відкриває карту, бачить з’єднання, яке збирається торкнутися, і перевіряє дату на верифікованому рядку, перш ніж щось змінити.

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