프레임워크 마이그레이션

DWP가 만들어진 목적인 작업의 예시 워크스루입니다. 즉 수십 개 파일과 여러 시간에 걸친 — 안내받지 못한 에이전트가 맥락을 놓칠 만큼 긴 — 마이그레이션입니다.

목표

하나의 큰 변경 → 순서가 있는 게이트형 작업

계획이 없을 때

대규모 마이그레이션 ✗ 빌드가 실패해요

Deep Work Plan으로 다룰 때

1. ✓ 작업 1 ⬡ 게이트
2. ✓ 작업 2 ⬡ 게이트
3. ✓ 작업 3 ⬡ 게이트
4. ✓ 작업 4 ⬡ 게이트
5. ✓ 작업 5 ⬡ 게이트

“서비스 전체에 걸쳐 데이터 계층을 레거시 ORM에서 새 ORM으로 마이그레이션하라.”

계획이 없을 때

에이전트는 컨텍스트가 절반쯤 끝난 변경으로 가득 찰 때까지 모델을 편집하고, 이미 어떤 호출 지점을 변환했는지 잊으며, 무엇이 남았는지에 대한 기록 없이 빌드를 빨간색으로 남깁니다. 재개한다는 것은 채팅 로그에서 자기 자신의 사고 흐름을 재구성하는 일을 뜻합니다.

Deep Work Plan으로서

/dwp-create는 목표를 원자적이고 순서가 있는 task로 분해하며, 각 task는 인수 기준과 검증 게이트를 갖습니다.

1. 기존 ORM과 나란히 새 ORM을 도입합니다(동작 변화 없음. 게이트: 빌드 + 테스트 통과).
2. 모듈 A의 모델과 호출 지점을 마이그레이션합니다(게이트: 모듈 A 테스트 통과).
3. 모듈마다 하나의 task씩 반복합니다 — 모든 task 후 진행 상황을 기록합니다.
4. 레거시 ORM과 그 심(shim)을 제거합니다(게이트: 참조가 남지 않음. 전체 스위트 통과).
5. 문서와 모듈별 README를 갱신합니다.

/dwp-execute는 task를 순서대로 실행하며, 게이트를 통과할 때마다 커밋하고 PROGRESS.md를 갱신합니다. 도중에 컨텍스트 윈도가 초기화되면, /dwp-resume가 디스크에서 계획과 진행 상황을 읽어 다음 미완료 task에서 계속합니다.

결과

마이그레이션은 작고, 검토 가능하며, 개별적으로 검증된 일련의 커밋으로 안착합니다 — 그리고 중단을 견딥니다. 대화가 아니라 계획이 진실 공급원이기 때문입니다.