bigtask-map — карта великої задачі

Прийшла ідея, більша за одну сесію, і шляху до неї ще не видно. Карта не кидається на ціль — вона знаходить шлях: розкладає туман на питання-рішення і закриває їх по одному, поки не лишиться нічого, що треба вирішити перед тим, як просто піти й зробити.

Карта планує, а не робить. Кожен пункт закривається рішенням, не написаним кодом. Потягнуло писати код — це сигнал, що карта скінчилася: шлях ясний, час передавати роботу в ce-plan → ce-work.

Файл карти

Одна карта — один файл docs/maps/<назва>.md. Шаблон: tools/map-template.md.

Карта — зміст, а не склад. Кожне рішення живе в одному місці — у своєму пункті; карта лише називає його одним рядком. Швидкий стан без читання всього файлу: bash tools/map-status.sh docs/maps/<назва>.md.

Називай словами, не номерами

У розмові з користувачем звертайся до пунктів назвою, ніколи номером. «#3, #7, #12» — стіна, яку не читають. «Чим платимо» і «Де живуть фото» — видно з першого погляду.

Режим 1 — накреслити карту

Користувач приходить із туманною ідеєю.

1. Назви пункт призначення. Проведи допит (grill-me), поки не буде одного-двох рядків: як виглядає «дійшли». Це фіксує межі — усе решта міряється по ньому.
2. Обійди рубіж вшир, не вглиб. Другий допит: не заглиблюйся в одну гілку, а перелічи, які рішення взагалі попереду. Туману не виявилось, шлях видно до кінця → карта не потрібна, скажи це прямо й веди в ce-plan.
3. Створи файл із шаблону: призначення, примітки, порожні «Вирішено», туман у «Ще не сформульовано».
4. Випиши пункти, які вже можна сформулювати — і другим проходом пропиши, що кого блокує.
5. Стоп. Креслення — це робота однієї сесії. Нічого не вирішуй сьогодні.

Режим 2 — пройти пункт

Користувач приходить із картою. Пункт може не називати — тоді бери сам перший вільний.

1. Прочитай тільки карту, не всі пункти підряд.
2. Візьми пункт із рубежу — відкритий, незаблокований. Познач [~] (в роботі), щоб паралельна сесія його не взяла.
3. Вирішуй. Тягни деталі сусідніх пунктів на вимогу, не заздалегідь. За замовчуванням — grill-me.
4. Запиши відповідь у пункт, познач [x], і додай один рядок у «Вирішено» на карті.
5. Перекресли туман: відповідь зробила щось формулюваним → винеси це з «Ще не сформульовано» в новий пункт. Відповідь показала, що пункт узагалі за межами цілі → закрий його і перенеси рядок у «Поза межами».

Одне питання за сесію. Виняток — суто довідкові пункти (почитати документацію, з'ясувати факт): їх можна закрити кілька, зокрема паралельними агентами.

Туман vs пункт

Проба одна: чи можеш ти сформулювати питання ЗАРАЗ — не чи можеш відповісти.

• Питання вже гостре (навіть якщо заблоковане) → пункт.
• Питання ще розпливчасте → «Ще не сформульовано», одним рядком «тут щось буде».

Не ріж туман на дрібне заздалегідь: одна пляма туману потім може стати трьома пунктами або жодним.

Поза межами

Туман збирається тільки в бік цілі. Робота за ціллю — не туман, вона в окремому розділі «Поза межами». Пункт виявився зайвим → закрий і залиш один рядок із причиною. Звідти нічого не повертається: щоб повернути, треба перекреслити ціль — а це вже нова карта.

Не роби так

• Писати код замість того, щоб закрити питання.
• Розписати всю карту наперед, включно з туманом.
• Тримати текст рішення і в пункті, і в карті — правитимеш у двох місцях, розійдеться.
• Закрити три питання за сесію, бо «вони маленькі» — контекст пливе, останнє буде найгіршим.