コードを「書く」から「指揮する」へ──エージェント時代のエンジニア生存術

今日の課題：コンテキストファイルを整備してエージェントの成功率を上げる

所要時間：15〜20分

2026年5月、Anthropicが公開した 「2026 Agentic Coding Trends Report」が開発者の間で大きな話題となっている。

そのなかで特に衝撃的だったのが、次のデータだ。

• Claude Code のセッションのうち 78% がマルチファイル編集を含む（2025年Q1は34%）
• セッションの平均時間は 4分（自動補完時代）→ 23分（エージェント時代）へ
• 1セッションあたりのツール呼び出し平均：47回

つまり、AIは今やコードの一行を補完するのではなく、 複数ファイルにわたって数十の操作を自律的に実行している。

そして最も実用的な知見がこれだ。

コンテキストファイルが整備されているプロジェクトでは、 エージェントのエラーが 40% 減り、タスク完了速度が 55% 向上する。

つまり、今のエンジニアに求められるのは「より良いコードを書くスキル」ではなく、 「エージェントが正確に動けるよう文脈を整えるスキル」だ。

手順

1. CLAUDE.md を作成する（未作成なら） プロジェクトルートに置き、以下を記述する：

   • リポジトリの目的と全体構成（300字程度）
   • 使用している技術スタックのバージョン
   • 「やってはいけないこと」（例：本番DBへの直接書き込み禁止）
   • テストの実行方法と期待される出力

2. 決定済みの設計方針を明示する 「なぜこのアーキテクチャを選んだか」を1段落書く。 エージェントは文脈なしに「より良い設計」に勝手に変更しようとする。 理由が書いてあれば、その変更は起きにくい。

3. よく繰り返すタスクを「レシピ」として書き出す 「新しいAPIエンドポイントを追加する手順」などを箇条書きで docs/recipes/ に置く。エージェントはこれを参照して一貫した実装をする。

4. エージェントの出力をレビューする習慣をつくる Anthropicのレポートによると、「delegation gap」が存在する： エンジニアは業務の約60%でAIを使うが、完全に委任できると感じるのは0〜20%に留まる。 この感覚は正しい。エージェントの出力をそのままマージしない習慣を維持する。

5. 週次でコンテキストファイルを更新する 設計変更・新機能追加のたびに CLAUDE.md を更新する。 このメンテナンスコストが、エージェントエラーの40%削減につながる。

関連記事 3本の要約

1. エージェント型コーディングがソフトウェア開発を再定義する

出典： Anthropic 2026 Agentic Coding Trends Report

開発の中心が「コードを書くこと」から「エージェントを指揮すること」へ移行しつつある。 楽天のエンジニアチームは、1250万行のコードベースに対して エージェントが単独7時間で複雑な機能実装を完了した事例を報告した。 エラーを減らすカギはコンテキストファイルの整備にある。

2. バイブコーディングとエージェント工学の収束

出典： Simon Willison's Weblog（2026年5月6日）

Simon Willisonが「不穏な気づき」として語る： プロ品質の気迫で仕上げたはずのコードと、 バイブコーディング（深く考えず雰囲気でAIに書かせること）で生成したコードが、 見た目も構造も区別できなくなってきた。 30分で100コミット・完全なREADME・網羅的なテストを持つリポジトリが作れる今、 「品質」をどう定義し直すかが問われている。

3. LLMの過去6ヶ月を5分で総括

出典： Simon Willison's Weblog（2026年5月19日）

2大トレンドは「コーディングエージェントの実用化」と「ラップトップで動くモデルの急成長」。 Qwen3などのローカルモデルが最高峰クラスの推論を手元PCで実現。 最強モデルの座は3大プロバイダ間で5回入れ替わり、 開発者は特定モデルへの依存をやめ「タスクに合わせた使い分け」に移行している。

明日試す候補 3項目

1. CLAUDE.md に「このリポジトリでやってはいけないこと」を3項目追加し、エージェントの挙動が変わるか確認する
2. エージェントに長めのタスクを渡し、完了後に変更ファイルの一覧と差分を自分でレビューする習慣を1週間続ける
3. ローカルLLMを立ち上げ、ネット非接続環境でのコーディング補助として使えるか試す