作りかけを引き継いだAIは『未完了』を勝手に埋めはじめる ― 引き継ぎで踏んだ2つの地雷

AIエージェントへの引き継ぎで直面した「未完了」作業の伝達と、`.gitignore`に隠された重要データの喪失という2つの地雷について解説。Claude CodeとCodexでの3D地図ルート描画ツール開発の経験を共有。

• AIエージェントへの引き継ぎにおいて、設定ファイル共有よりも「作業の未完了理由」の伝達が重要である。
• AIは進捗のバラつきを「未完了」と誤読し、意図せず作業を進めてしまう可能性がある。
• AIに作業を引き継ぐ際は、実際のデータから現況を組み立て表示する仕組みと、「進め方」自体を明記することが有効である。
• 中間生成物で再生成できないデータ（判断履歴など）が .gitignore に含まれていると、引き継ぎ時に問題を引き起こす可能性がある。
• AIエージェントへの引き継ぎでは、進捗の文脈と失うと戻れないデータの管理が鍵となる。