ハーネスを別リポに移植したら全部壊れた ── 暗黙に依存していた5つの環境前提

自作のCLAUDE.md（AIエージェントの設定ファイル）を別リポに移植した際にAIが正しく動作しなかった経験から、暗黙の依存関係や環境前提の重要性を説く。AIエージェントが期待通りに機能するためには、設定だけでなく、周囲の環境や依存関係の整備が不可欠であることを示唆している。

• ハーネスを別リポジトリに移植するとAIエージェントが正しく動作しなくなる事例が報告されている。
• AIエージェントの動作には、設定ファイルだけでなく、暗黙的な環境依存関係が影響していることが判明した。
• 開発者はAIエージェントを移植する際、環境前提条件の明示化と整備の重要性を認識する必要がある。
• 移植失敗の原因は、依存ライブラリのバージョンやOS設定などの環境差異にあると推測される。