制限付きエージェント環境では検証不能条件を実装失敗と分けて記録する
開発環境
テスト
AI協働
運用
AI エージェントや CI 風の sandbox で作業する場合、ファイル編集は可能でも、Docker daemon、localhost bind、ローカル DB 接続、ホーム配下の build cache 書き込みが拒否されることがある。この種の失敗はコード変更の失敗ではなく、検証環境の能力不足として切り分ける。
運用上は、まず失敗点を依存先別に分解する。Docker 起動で止まったのか、DB ping で止まったのか、ローカル HTTP サーバーの listen で止まったのか、build cache 書き込みで止まったのかを別々に見る。Go では build cache だけが原因なら、書き込み可能な一時領域を build cache に指定して再試行できる。一方で Docker・DB・localhost bind が禁止されている場合、migration 適用や httptest 系の確認は同じ環境では完了条件にできない。
報告では、通せた検証、環境制約で通せなかった検証、完了条件の充足可否を分けて書く。特に「再実行して差分ゼロ」「ローカル DB に適用済み」のような条件は、実行できていないなら未達として明示する。代替として schema/migration/hash の静的整合性や該当 package の単体テストを確認しても、それを本来の完了条件と同一視しない。