プランモードは死んだ
Plan mode is dead (aymannadeem.com)
要約
著者は、AIを使ったソフトウェア開発において、以前はプランニングが最も重要になると考えていましたが、自身が開発したコーディングアプリ「Nuanced」の経験から、プランモードの有用性が低下していると結論づけています。AIモデルの高度化により、人間が詳細な指示を出す必要性が減り、また、AI生成テキストの読みにくさや、計画と実装の分離が開発プロセスを非効率にしていることが原因だと分析しています。AIがコード生成を高速化する一方で、人間がシステム全体を把握し、意思決定を行うための新しいインターフェースが必要だと述べています。
全文翻訳
Plan mode is dead
今年の初め、私はAIを使ってソフトウェアを構築する上で、プランニングが最も重要な部分になると信じていました。
この考えに対する私の信念は非常に強く、それに基づいてデスクトップコーディングアプリ全体を構築し、ローンチしました。Nuancedは、AIがコード生成の速度と量を劇的に増加させたものの、この新しい作業ペースをサポートするためのインターフェースが追いついていないという観察に基づいていました。
[画像: インターフェースとラベル付けされた馬車を追い越すモデルの速度とコード生成レース。]
Nuancedのプランニングへのアプローチは失敗しましたが、それは同時にプランモードが広範に見てあまり役に立たなくなっていることを私に明らかにしました。歴史的に、プランモードは2つの目的を果たしていました。(1) エージェントにとって十分に正確な指示を指定すること、(2) 人間が何を作っているかを理解するのを助けること。
私は、モデルがより良くなるにつれて、#1 は急速に時代遅れになりつつあると考えています。#2 はこれまで以上に重要になると考えていますが、特に並列エージェントの数が増加するにつれて、プランモードはそのための間違った抽象化です。
Nuancedを構築した理由
私が構築する動機となった製品は、最終的に、依然として関連性があり、常にそうであり続けるであろう質問に答えました。それは、「機械が人間が検査できるよりも速くシステムを変更している間、人間はソフトウェアシステムの首尾一貫したメンタルモデルをどのように維持できるか?」という質問です。
モデルは数分で数千行のコードを書くことができたため、構築しているものやその理由を考える前に、巨大なメンテナンス負担を引き継ぐことになりました。これにより、動作について推論したり、時期尚早にコードに固められた誤った仮定をデバッグしたりすることが困難になりました。
[画像: コード、プラン、差分、ファイルに囲まれ、決定、仮定、誰が何を変更したかについての質問に圧倒されている開発者。]
このようにコードを生成する容易さがより大きなドーパミン報酬を引き起こした一方で、なぜ何かを構築することが重要なのか、それがそもそも重要なのか、そして製品、デザイン、インフラストラクチャの決定を厳密に評価するという不快な作業を不明瞭にしました。私はしばしば、製品に関する決定を意識的に行う前に、製品を手にしていました。アーキテクチャの指定が不十分だった場合、エージェントはそのギャップを埋める自由を取りましたが、たとえそれが抽象化境界を区切る方法が後で問題を引き起こしたとしてもです。意図された動作と設計に関するこれらの誤解は、チャットの表面の下にある複数のファイルに伝播し、容易に見逃される可能性がありました。この表面の下で不可解な問題を探し回ることは、最初から正しく設計するよりも効率が悪いように感じられました。
[画像: 隠された依存関係、意図された動作、API境界、製品決定、仮定、コードファイルが沈む「チャット」とラベル付けされたボートから釣りをする開発者。]
この経験には、特にConductorやCodexのようなコーディングアプリがより多くのエージェントを並列で実行する能力を可能にしたとき、精神的に切り離され、ゾンビのようになった感覚がありました。以前のように、自分が取り組んでいることについて本当に集中し、同じ深さや理解にアクセスできないと感じました。これはまた、生成された結果が正しいかどうかを確認することをより困難にしました。
ユーザープロンプト → エージェントの決定 → コード → 製品の動作 の間の接続を示す、明確で解釈可能なトレースがありませんでした。これは、コードの行やファイルを見るという昔に戻りたいという意味ではありませんでした。自然言語でアイデアを推論することの方が、より簡単で効率的だと感じていました。システムの仕組みについての理解を犠牲にすることなく、自信を持ってコードの上に浮かんでいたいと思っていました。
既存のプランモードは十分な協調性を感じなかった
プランモードは存在していましたが、適切にプランニングするための正しい抽象化が存在しないと感じていました。Claude Code CLIからConductor、そしてCodexがローンチされたときにCodexへと移行する中で、私は明確な置き場所なしに、計画を細心の注意を払って形成し、削り取っていくことに気づきました。私はチャットを使用してそれを行い、Codexのアノテーション機能が登場する前は、計画の断片を新しいメッセージにコピーして改訂していました。このコピー&ペーストのワークフローはぎこちなく感じられ、現在の計画を把握しながらアイデアを練るのが困難でした。
私は自分の計画に居場所を与え、全体的なワークフローに根ざし、会話が進むにつれてバックスクロールに消えていく一時的なテキストの塊から、生きた、息づく、永続的なドキュメントに変えたかったのです。いくつかの理由から、プランモードを開発を導くファーストクラスのプリミティブに変えたかったのです。
- 何をすべきかを考える必要がありました。
- それを十分に正確に説明する必要がありました。
- 何がなされたかを理解する必要がありました。
- 物事がうまくいかなかったとき、そしてその理由を理解する必要がありました。
夢の構築
私は夢のワークフローについて考え、それを製品にエンコードすることで実現することにしました。Nuancedではスレッド(各スレッドはチャット会話)を起動できました。構築したいものについて話し合い、システムは曖昧さとあなたの入力が必要な決定を提示し、実装が始まる前に一緒に永続的な計画に到達しました。その後、Nuancedはあなたの計画を実装し、生成されたコードがあなたの要件に準拠していることを確認しました。私は意図から始まり、実装、レビュー、検証まで続くエンドツーエンドのパイプラインを望んでいました。それは、単なる別のコーディングアプリというよりも、人間の心(または私のADHDの心)の補綴物として見ていました。それは、私が何が起こっているかを把握するのを助けるのと同じくらい、指示するように設計されていました。
なぜ私が間違っていたのか
既存のツールにおけるギャップやSDLCがどのように変化しているかに関する私の考えが間違っていたというよりも、私たちの実装が期待したソリューションを提供できなかったということです。これは次の理由によるものです。
- プランニングとプランを混同した
- モデルが非常に優秀になった
- AI生成テキストを読みたい人はいない
- プランニングとビルディングを破壊的な方法で分離した
Planning != Plan
最初に学んだことは、プランニングとプランを混同していたということです。それらは実際には同じではありません。私の仮定は、実装される前に何かについて徹底的に考えるためのスペースを持つことが価値があるということでした。プロジェクトが進むにつれて、その思考を大きな構造化された成果物に保存することも価値があると考えていました。しかし、初期のユーザーはその仕様に対する関心が驚くほど少なかったのです。
モデルが非常に優秀になった
モデルがコンテキストとメモリを通じて大規模なコードベースを理解する能力が向上するにつれて、リポジトリを探索し、合理的な仮定を立てるのが得意になりました。よく考えられた結果を生成するように明示的に指示する必要性は縮小しました。
当初、モデルの能力が人間の思考のためのより良いインターフェースを設計することと競合するとは考えていませんでしたが、多くの意味でそうでした。これは、モデルが自分で確実にできる各決定が、表面に出す必要のある決定が1つ減ることを意味したからです。
AI生成テキストは読むのがつらい
仕様にはより多くの情報が含まれていましたが、より多くの明確さが生まれたわけではありませんでした。これは、私たちの仕様が長かったためです。それらは重要な決定を捉え、有用に見える多くのコンテキストを含んでいましたが、問題は:それらはAIによって生成されたものでした。AI生成テキストのペースと過度に構造化された性質には、それを非常に読みにくくする何かがあります。私の目は常にうつろでした。
この発見に仕様を廃止することで反応するのではなく、Spec Tourを構築して解決しました。仕様全体を吸収するように誰かに依頼するのではなく、Spec Tourが重要な部分を案内できると考えました。しかし、それは単に追加の複雑さの層、画面上のさらに多くのテキストが注意を要求するだけでした。仕様を使いやすくするために仕様の短い表現を生成する必要があるなら、そもそも完全な文書は何のためにあったのでしょうか?
継続的に感じられる必要のあるプロセスを分離してしまった
私たちのワークフローはあまりにも線形的で逐次的でした。私たちのプロセスは次のようなものでした。
チャット → 質問に答えることで曖昧さを解消 → 仕様生成 → 仕様レビュー → 仕様改訂 → 承認 → 実装 → コードレビュー
[画像: 開発者がチャット、質問に答えることで曖昧さを解消、仕様生成、仕様レビュー、仕様改訂、承認、実装、コードレビューという一連の段階を滝のように転がり落ちる。]
実際の思考はこのようには起こらず、これらの部分の分離は人工的で強制的に感じられました。通常、問題の一部を理解し、何かを試み、最初の生成から新しいことを学び、それがそのことについて考えを変えさせ、別のことを試すかもしれません。各ステップは新しい質問を明らかにします。プランニングとビルディングはインターリーブされ、特にNuancedで構築した方法では、プランモードが許容するよりも有機的に出現します。私たちのインターフェースは、ユーザーに「思考の終了」を強制し、ビルディングを開始できるようにしました。実装が始まると、以前のチャットベースの推論に戻ることは、ワークフローの後退のように感じられました。滝を上に遡ることはできませんでした。
Codexが現在どのように機能するかを見ると、プランニングと実行の境界は、それらが1つに収束するにつれて消えています。以前は、コーディングエージェントは、人間が次のことを行うワークフローから恩恵を受けていました。
プラン → 承認 → 実行
当時、間違った方向に行くコストは大幅に高かったです。しかし、エージェントがシステムを理解するのが得意になるにつれて、自律的に行動し、自分の作業をテストするのも得意になりました。結果を検査した後にアプローチを修正するのも得意です。これにより、異なるループが可能になります。
理解 → 行動 → 検査 → 明確化 → 調整 → 再行動
そのループの中では依然として膨大な量のプランニングが行われていますが、それは必ずしも「プラン」と呼ばれる文書として現れる必要はありません。私が犯した最大の過ちは、プランを成果物に変えてしまったことであり、人間の理解を向上させるためのプロセスを設計しなかったことだと思います。
[画像: 古い線形ワークフローはプランから承認を経て実行へと移行し、混乱した人間を障壁に残す。新しい反復ワークフローは、理解、行動、検査、明確化、調整、再行動をサイクルし、中央には幸せな人間のDJがいる。]
プランモードとビルドモードは奇妙な分離だった
Nuancedにはプランモードとビルドモードがあり、ユーザーはどちらからでも開始できました。プランモードは常に仕様を生成しましたが、ビルドモードはユーザーを仕様に強制せず、仕様を正当化しない小さなタスクに使用できました。しかし、これらのモード間の分離はぎこちなく、ユーザーはタスクがプランニングに値するかどうかというメタ質問を自分自身に尋ね、もしそうならボタンやキーボードショートカットを通じてプランモードをアクティブにするのを覚えておく必要がありました。これは、AIがすでに持っているコンテキストに基づいてあなたのために行うべき区別のように感じられ、どのモードにいる必要があるかを覚えておくことは、より多くの認知負荷を導入するように感じられました。
この認識は、私にミッドウィットミームのような感覚を与えました。つまり、必要に応じてプランニングが行われるチャットインターフェースのシンプルさが、デフォルトではなく、実際にはかなり優れているということでした。
[画像: Midwitベルカーブミーム:両端のキャラクターは「チャットスレッドは良い」と言い、中央のキャラクターは「本当に考えるには新しいプランニングインターフェースが必要だ」と言っている。]
理解の問題はまだ解決していない
何を構築するか、なぜそれが重要か、そして決定を評価することは依然として重要です。人々は、何が起こっているのかについての首尾一貫したメンタルモデルを構築する必要がありますが、AI生成テキストの大きな塊がそのための正しいインターフェースだとは思いません。チャットで決定を検討することはより直感的ですが、システムが変更されるにつれてその理解を最新の状態に保つことは依然として未解決の問題です。
5つのエージェントから数百に増えると、その問題はさらに難しくなります。追いつくことは、すべての会話を読み、各コード変更の説明を促すことを意味するわけにはいきません。エージェントは、人間の注意が最大のインパクトを与えられる最も少ない場所を特定し、その注意を有用にするのに十分なコンテキストを提示する必要があります。
数百ものますます有能なエージェントが同時にシステムを変更する中で、人々が方向感覚を保つのを助ける方法をまだ解決していません。しかし、より深い問題、つまり人間がシステムをどのように理解し、複雑な情報階層をナビゲートし、強力なツールを使用するかは、永続的な問題だと思います。インターフェースは、それを支えるテクノロジーとともに変化し続けています。複雑さを理解可能にする必要性は変わりません。
[画像: 人間とロボットが「プランモード、2025–2026」とラベル付けされた墓石のそばで悲しんでおり、花、ラップトップ、チェックリスト、記念の花輪がある。]