原題: The bottleneck was never the code
著者: The typical set
公開日: 2026-04-29
ソースURL: https://www.thetypicalset.com/blog/thoughts-on-coding-agents
アーカイブ日: 2026-05-07
このエッセイは、コーディングエージェントによってコードを書く速度が劇的に上がっても、それだけではソフトウェア産業全体が同じ比率で速くなるわけではない、という違和感から始まる。著者は、自身が長く後回しにしていた structured generation の実験を Codex に説明したところ、数時間で最初の動く版が返ってきた経験を紹介しつつ、それが個人の生産性の大幅な向上であることは認める。しかし、その事実からただちに「業界全体も同じように加速する」と結論づける議論には懐疑的である。なぜなら、ソフトウェア開発で本当に重い部分は、以前からコードを書く行為そのものではなく、人間同士が何を作るべきかを交渉し、共有像を揃えることだったからだと論じる。
その主張を支えるために、著者は Fred Brooks の『人月の神話』や Gerald Weinberg の議論を引く。ソフトウェアとは、複数の人間がシステムに何をさせるべきかを交渉し終えたあとに残る残滓であり、コードは難しい仕事そのものではなく、その結果にすぎない、という見方である。過去50年は、その残滓を生み出すコストが高かったため、タイピング速度、言語設計、フレームワーク、IDE、レビュー支援など、コードを早く書くための改善に注目が集まり続けた。ところが、コーディングエージェントによってコード生成のコストが十分に下がると、下に隠れていた本体、つまり「人々が合意に達するための仕事」があらわになる。結果として、作業の中心は実装から、仕様、受入基準、設計意図を明確に書き下すことへ移る。
著者はこの転換を、「ロードマップが限界を決める」と表現する。エージェントが実装を引き受けるチームでは、エンジニアは他のエンジニアを待つのではなく、次の十分に精密な仕様を待つことになる。何を作ってほしいかが曖昧なままでは、エージェントは走れない。タスク、ロードマップ、受入条件、テスト、設計書といった、人間の意図を構造化した記述こそが律速段階になる。したがって、制約はコーディング速度から、何を作るかを定める側、つまりマネジメントと組織的フォーカスへ移る。コードが安くなるほど、実現できることの表面積が広がり、Jevons のパラドックスのように、作られるものはむしろ増える。結果として、何を作らないかを決める難しさがいっそう大きくなる。
そこで重要になるのが、著者のいう「コンテキスト」である。コンテキストとは、何を作っているのか、なぜそれが重要なのか、何が試され、誰が何を決め、どこが荷重を支える部分なのか、といった、組織が暗黙のうちに共有している理解全体を指す。人間は会議室にいること、同じ Slack を読むこと、同じ障害対応を経験することなどを通じて、こうした背景知識を浸透的に獲得する。しかしエージェントはそうではない。プロンプト、ファイルツリー、ツール、明示的な指示に含まれていないことは、基本的に持っていない。したがって、書かれていないコンテキストは、エージェントが行動する際の決定的な欠損になる。十分な文脈がないエージェントは、少しだけズレた問題設定に対して、もっともらしい答えを返してしまう。
この弱点を反転させる可能性として、著者は「コンテキストを読むエージェント」ではなく「コンテキストを作るエージェント」を構想する。PR コメント、Issue、コミット履歴、古い設計文書、チャットの蓄積をエージェントが徹底的に読み込み、誰も明文化してこなかった暗黙の判断や慣習を知識ベースとして外在化するのである。単にモジュールの存在を記述するのではなく、「このモジュールが奇妙なのは過去の移行で旧挙動を守る必要があったからだ」といった背景まで書き起こすことを想定している。他のエージェントは、その知識ベースを参照して行動する。人間が非公式に行ってきた浸透的学習を、エージェントが読める形へ翻訳するループである。著者はこれをすでに自社で作り始めていると述べる。
ただし、著者はこの構想を万能視していない。Michael Polanyi の「人は語れる以上のことを知っている」という言葉を引きながら、暗黙知のすべてが文書から回収できるわけではないことも認める。対面での経験、現場での勘、言語化した瞬間に変質してしまう理解は残るだろう。したがって、そこから得られるものは完全復元ではなく、有用な出発点である。それでも、これまで人間が怠ってきた文脈の外在化を、エージェントが大幅に前進させる可能性は十分にあると見る。
エッセイの結論は、次の時代のモートは技術的なツールそのものではなく、組織のコヒーレンス、すなわち少人数から大規模組織までが一貫した判断を保ち続ける能力だというものだ。IDE、VCS、CI、マイクロサービス、DevOps のような過去の技術革新も、協調を自動的に解決したわけではなく、もともとの組織的一貫性を増幅したにすぎない。エージェントはそれよりはるかに強い倍率で、その善し悪しを増幅する。個人がコードを書く速度を上げる道具としては過大評価されている一方で、組織が何を知っているかを外在化する手段としては過小評価されている、というのが著者の最終的な見立てである。
この文章の強さは、コーディングエージェントを「個人がどれだけ早くコードを書けるか」という話から引き離し、ソフトウェア開発の本体を組織的な合意形成へ戻している点にある。Brooks や Weinberg の古典を引きつつ、コードは交渉の残滓にすぎないという見方を、現在のエージェント時代へそのまま接続している。議論の軸がツール比較や速度自慢に流れず、どこに本当の制約が残るのかを問い直しているため、短いながらも射程が長い。
特に印象的なのは、コンテキストを「組織が走るための資源」として定義し直していることだ。エージェントは書かれていないものを持たないからこそ、暗黙知の外在化が次の戦場になる、という整理は、単なるドキュメント推奨では終わらない。エージェントが PR、Issue、コミット、古い文書を読んで、背景知識そのものを生産するという着想は、運用設計、ナレッジ管理、マネジメントの境界をまたぐ発想として独自性が高い。
また、「エージェントは個人のコーディング速度を上げる手段としては過大評価されているが、組織の暗黙知を外在化する手段としては過小評価されている」という結論は、今後も繰り返し参照される可能性が高い。性能の良いモデルを選ぶことより、何を明示し、何を共有し、何を絞るかを考え続けられる組織が勝つという見立ては、エージェント導入の実務と経営判断の両方に効く。流行論ではなく、組織設計の問いとして残る文章である。