Skip to content
← すべての事例

フレームワークの移行

DWP が想定して作られた作業の説明的なウォークスルーです。数十のファイルと数時間にまたがる移行、すなわち導きのないエージェントが筋を見失うほど長い作業です。

目標

「サービス全体にわたって、データレイヤーをレガシーの ORM から新しいものへ移行する。」

計画なしの場合

エージェントはコンテキストが中途半端な変更で埋まるまでモデルを編集し、どの呼び出し箇所をすでに変換したかを忘れ、何が残っているかの記録もないままビルドを赤いまま放置します。再開するとは、チャットのログから自身の思考の筋道を再構築することを意味します。

Deep Work Plan として

/dwp-create は目標を、それぞれが受け入れ基準と検証ゲートを備えた、アトミックで順序づけられたタスクへと分解します。

  1. 新しい ORM を古いものと並べて導入する（振る舞いの変更なし。ゲート: ビルドとテストが緑）。
  2. モジュール A のモデルと呼び出し箇所を移行する（ゲート: モジュール A のテストが緑)。
  3. モジュールごとに繰り返す。各一タスクずつ。タスクのたびに進捗を記録する。
  4. レガシーの ORM とそのシムを取り除く（ゲート: 参照が残っていない。スイート全体が緑)。
  5. ドキュメントとモジュールごとの README を更新する。

/dwp-execute はタスクを順序どおりに実行し、合格した各ゲートのあとにコミットし、PROGRESS.md を更新します。途中でコンテキストウィンドウがリセットされても、/dwp-resume がディスクから計画と進捗を読み、次の未チェックのタスクで続行します。

成果

移行は、小さく、レビュー可能で、個別に検証された一連のコミットとして着地します。そして、会話ではなく計画が信頼できる情報源であるため、中断を生き延びます。