良いAI支援開発はタスクレベルではなくシステムレベルで起こる

Redditユーザーのu/johns10davenportは、AI支援開発における真のレバレッジはプロンプトの改善ではなく、システムを変えることにあると主張しています。著者はよくあるフラストレーションを語ります:Phoenixアプリに新機能を追加するたびに、AIコーディングエージェントは機能を実装するものの、メニュー項目を追加し忘れるのです。ページは存在し、機能は動作するが、ユーザーがそこにたどり着く方法がないのです。
タスクレベルの修正の問題点
最初の直感は「ボタンを追加して」とモデルに指示することです。それは効果がありますが、人間がまだ思考しています——問題を診断し、修正を指示しているのです。著者はこれを「Anthropicにフリートークンをもらうためにペロトンを漕いでいる」と呼びます。プロンプトエンジニアリングは、モデルに何をすべきかを伝える能力を高めるだけで、依然として人間がモデルのために働いているのです。
システムレベルのシフト
欠落したボタンを修正する代わりに、著者は「将来このミスを不可能にするにはどうすればよいか?」と考えました。彼らの解決策は、BDDスペックとPhoenix LiveViewテストヘルパーを利用したものです。テストフレームワークのnavigate関数を使うと、エージェントは任意のページに直接ジャンプでき、UIを経由せずにテストに合格します。そこで、エージェントがnavigateを呼び出すのを禁止するリンタールールを作成しました。これにより、テストを既知の開始ルートに配置する許可されたフィクスチャのみが利用可能となり、エージェントが新機能に到達する唯一の方法はUIをクリックして進むことです——つまり、テストに合格するためにメニュー項目を追加せざるを得なくなります。
結果:同じ問題は二度と発生しません。なぜなら、より優れたプロンプトのためではなく、正しい動作が唯一可能な動作だからです。
重要なポイント
モデルの出力を修正するのはやめましょう。代わりに、正しい出力が最も抵抗力の少ない経路となるように環境を制約することです。すべてのミスは、次のミスを設計によって排除するチャンスです。
📖 元の記事を読む: r/ClaudeAI
👀 See Also

Anthropicの非公開OAuthレート制限プールは、Claude Codeシステムプロンプトを必要とします
AnthropicのOAuthトークンを使用する際、APIはシステムプロンプトがClaude Codeとして識別されるかどうかに基づいて、リクエストをClaude Codeのレート制限プールにルーティングします。システムプロンプトに「You are Claude Code, Anthropic's official CLI for Claude.」を追加することで、不可解な429エラーが解消されます。

OllamaのDockerコンテナ内でOpenClawを実行し、ネットワークを簡素化する
Redditユーザーが、公式のollama/ollama Dockerコンテナ内にOpenClawをインストールして、OpenClawがlocalhost経由でOllamaと通信できるようにする方法を紹介。host.docker.internalや追加のネットワーク設定が不要になる。欠点はRAM使用量が多いこと。

Redditユーザーが共有する、Claude Codeプロンプティングのよくある間違いとその修正方法
Node.jsのバックエンド作業でClaudeを使用している開発者が、数か月の使用を経て、検証要件の欠落やClaudeをワンショットツールとして扱うなど、10のよくあるプロンプティングの間違いを特定しました。彼らは各問題に対する修正を含むビジュアルガイドを作成しました。

より効果的なAIエージェント指示のための音声入力ツールの活用
ある開発者が、OpenClawへの指示をタイプ入力から音声入力に切り替えたところ、より自然で詳細なコンテキストが提供されることで出力品質が向上したことがわかりました。この際、SaySo.aiをディクテーションツールとして使用しました。