Міграція фреймворку

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

Мета

Одна велика зміна → впорядковані задачі з воротами

Без плану

Велика міграція ✗ Збірка падає

Як Deep Work Plan

1. ✓ Задача 1 ⬡ ворота
2. ✓ Задача 2 ⬡ ворота
3. ✓ Задача 3 ⬡ ворота
4. ✓ Задача 4 ⬡ ворота
5. ✓ Задача 5 ⬡ ворота

«Перенести шар даних зі старого ORM на новий по всьому сервісу».

Без плану

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

Як Deep Work Plan

/dwp-create розкладає мету на атомарні впорядковані задачі, кожна з критеріями приймання й перевіркою валідації:

1. Ввести новий ORM поруч зі старим (без зміни поведінки; ворота: збірка + тести зелені).
2. Перенести моделі й місця виклику модуля A (ворота: тести модуля A зелені).
3. Повторити для кожного модуля, по одній задачі на кожен — прогрес фіксується після кожної задачі.
4. Видалити старий ORM і його перехідні прокладки (ворота: посилань не лишилося; повний набір зелений).
5. Оновити документацію й README кожного модуля.

/dwp-execute виконує задачі по черзі, комітячи після кожних пройдених воріт і оновлюючи PROGRESS.md. Якщо контекстне вікно скинеться посеред роботи, /dwp-resume зчитує план і прогрес із диска й продовжує з наступної невідміченої задачі.

Результат

Міграція приземляється як послідовність малих, придатних до рев’ю, індивідуально перевірених комітів — і переживає переривання, бо джерелом істини є план, а не розмова.