Claude Codeの断捨離：Opus 5時代のプロンプトエンジニアリング再考

我々エンジニアは、往々にして「制御」を好む。CI/CDパイプラインを厳密に定義し、Lintルールを細かく設定し、ドキュメントのフォーマットまで自動化する。Claude Codeにおいても同様で、私は5ヶ月もの間、CLAUDE.mdやskills、rulesを丹念に育て上げ、まるで巨大なレガシーシステムを構築するかのように、要件定義からADR（アーキテクチャ決定記録）、DoR（定義の準備完了）ゲートに至るまで、複雑な自律開発フローを組み上げていた。しかし、Opus 5という強力なモデルが登場した今、その「作り込み」こそが、AIの柔軟な推論能力を阻害する足枷になっていることに気づかされた。

Opus 5は、以前のモデルよりも遥かに高い文脈理解能力と自律的な判断力を備えている。それにもかかわらず、我々が過去のモデル向けに書いた「絶対にこうしろ」「迷ったらこのskillを呼べ」といった過剰な圧力表現や反復強化の指示は、AIにとってのノイズとなり、本来のポテンシャルを殺す「プロンプトのスパゲッティコード」と化していたのだ。実際に、これらの設定を読み込ませない方が、Opus 5は期待通りに動くという逆説的な事態が発生した。これは、我々がAIを「指示通りに動くツール」として扱いすぎていたことの証明であり、AIの進化速度に我々の運用手法が追いついていないという、エンジニアとして直面すべき痛烈な現実である。

今回、私はClaude自身に/claude-api prompt-auditコマンドを用いて、これらの設定を棚卸しさせた。結果として、40個あったskillは6個まで削減され、常時ロード量は32,694文字から9,465文字へと、実に72%もの劇的な削減を達成した。このプロセスで学んだのは、AIへの指示は「増やす」ことよりも「削る」ことの方が遥かに難しく、かつ重要であるという事実だ。我々は、AIに何をさせるかではなく、AIの邪魔をしないために何を捨てるべきかを、真剣に検討しなければならない。

棚卸しの過程で、私はある決定的な事実に直面した。Claudeは「指示の内容が適切か」を判断することはできるが、「その仕組み自体が今も必要か」というメタレベルの判断までは自発的に踏み込まないということだ。例えば、私が苦労して構築した自律開発ループのskillも、Claudeに「/goalで代替できないか？」と問いかけて初めて、不要であるという結論に至った。これは、AIがどれほど賢くなっても、そのAIをどう活用するかという「アーキテクチャの設計思想」は、依然として人間であるエンジニアの責任領域であることを示唆している。

実際に、過去1ヶ月のtranscriptを分析したところ、40個のskillのうち35個が一度も発火していなかった。我々は「いつか使うかもしれない」という不安から、使われないコードをリポジトリに溜め込むのと同様に、使われないプロンプトをAIに読み込ませ続けていたのだ。これはまさに、技術的負債のAI版と言える。以下の表は、今回の棚卸しによる定量的な変化を示しているが、この数値以上に重要なのは、我々の「AIとの付き合い方」がアップデートされたという点にある。

今後は、新しいモデルが登場するたびに、単にプロンプトを微調整するのではなく、その仕組み自体が現在のモデルの機能で代替可能になっていないかを、常に問い直す必要がある。AIの進化は、我々がこれまで手作業で実装してきた「開発フローの自動化」を、AIのネイティブな機能として吸収していくプロセスでもある。我々エンジニアは、AIに指示を出す「プロンプトエンジニア」から、AIが最大限のパフォーマンスを発揮できる環境を整える「AIオーケストレーター」へと、その役割をシフトさせていくべきではないだろうか。

今回の経験を通じて、私は「AIを育てる」という行為の定義を根本から見直すことになった。かつては、AIに詳細なルールを教え込むことが「育てる」ことだった。しかし、Opus 5のような高度なモデルにおいては、AIを縛るルールを減らし、AIが自律的に判断できる余白を広げることが、真の意味での「育成」なのかもしれない。これは、マイクロマネジメントを好む上司が、部下に権限委譲することで組織が活性化する現象と酷似している。AIを信頼し、過剰な制御を手放す勇気こそが、これからのエンジニアに求められる資質ではないだろうか。

また、今回の棚卸しで残った6個のskillは、今後も永続的に必要とは限らない。Opus 5がSonnet 5などのサブエージェントを呼び出す際、オーケストレーターであるOpus 5がどのようにプロンプトを制御するのか、そのブラックボックス化された挙動を我々はどこまで理解し、制御すべきなのか。新たな疑問は尽きない。我々が明日から取るべき対策は明確だ。まず、現在運用しているプロンプトや設定ファイルを、一度すべて「ゼロベース」で疑うこと。そして、AIの利用履歴を分析し、実際に使われていない指示を容赦なく削除すること。最後に、AIに対して「この仕組みは本当に必要か？」と問いかけ、AI自身の判断を仰ぐことである。

最後に、読者であるあなたに問いたい。あなたが今、AIのために書いているその長いプロンプトや複雑なルールは、本当にAIの助けになっているのか、それとも単にあなたの不安を解消するための「お守り」になっていないだろうか。AIの進化を追いかけることに必死になるあまり、我々はAIを使いこなすための「古い常識」に縛られ続けてはいないか。この問いに対する答えを出すことこそが、AI時代を生き抜くエンジニアの生存戦略となるはずだ。