AI Agent は実装前に1コマンド打て

• URL: https://zenn.dev/tadkud/articles/ai-agent-environment-verification-rule

• 日付: 2026-06-14

• Tier: Tier 3

• 要旨: AI エージェントの失敗は実装力より「環境前提の未確認」から始まることが多い。実装前に CLI/コンテナ/リポジトリ状態を command -v / docker ps / git status -sb / test -f で1コマンド確認するルールを定着させることで、誤判定に基づく無駄な修正を大幅に削減できる。

詳細

• 失敗パターン3例（実体験）:
  1. Docker 未確認のまま OCI ATP と誤判断（2026-05-23）
  2. codex exec で desktop 操作系がそのまま使えると思い込み（2026-05-23）
  3. signal.alarm 未設置で hang 要因を見落とし（2026-05-19）
• 1コマンド確認の例: command -v grok（CLI 実在確認）/ docker ps（コンテナ確認）/ git status -sb（リポジトリ状態）/ test -f ~/.grok/config.toml && ls -l（ファイル実在確認）。
• AI エージェントでの特有リスク: 人間は「この前もここで詰まった」と思い出せるが、エージェントはもっともらしい前提の上にもっともらしい実装を積み上げてしまう。
• 重要な運用: 確認結果を短く残す（docker ps で対象なし など1行）。会話ログに埋めず feedback_*.md に昇格させ次プロジェクトで再利用できるようにする。
• 先に打つ1コマンドは「後で30分かけて誤判定を掃除しないための最短手順」。