Redditユーザーが、Claude Codeの幻覚を減らすための仕様駆動アプローチを共有

Redditのr/ClaudeAIコミュニティの開発者が、長時間の開発セッションでClaude Codeを使用する際の幻覚を減らす実用的な方法を共有しました。このアプローチは、構造化されたドキュメントを通じてコンテキストを維持することに焦点を当てています。

問題：コンパクション中のコンテキスト喪失

開発者は、Claude Codeがプロジェクト開始時は順調に進むものの、複数のコンパクション後に品質が低下するパターンを説明しました。「テストを作成し、そのテストに合格するまで完了と表示しない」といった具体的な指示は、コンパクション後に忘れられ、古いバグが再発し、出力品質が悪化する原因となっていました。

解決策：仕様駆動開発

AnthropicがPlugins機能を構築した方法に触発され、開発者は仕様先行アプローチを採用しました：

• まずClaudeにアプリについて明確化する質問をさせ、詳細な箇条書き要件を含むREQUIREMENTS.mdを作成する
• 要件ドキュメントの箇条書きを参照しながら、各要件に対するタスクを含むIMPLEMENTATION_PLAN.mdを作成する
• 実装計画と100%一致するテスト計画を作成し、各タスクに対するテストケースを含める
• 実装計画を参照しステップを実行する指示を含むCLAUDE.mdを作成する

CLAUDE.mdでは特にClaudeに対して以下の指示をしています：

実装計画を参照し、その中のステップを実行してください。各タスクの開発が完了した後、対応するテスト計画項目を実行し、テストに合格した場合にのみ「完了」とマークする「必要があります」。私が提供する新しい指示ごとに、要件ドキュメント、実装計画、テスト計画を更新する必要があります。

結果

開発者は、複数のコンパクション後もはるかに優れた実行品質を報告しました。Claudeはコンパクション後に進行状況を見失わなくなり、どこから実行すべきかを理解するようになりました。開発者が「何が残っていますか？」と尋ねると有用な回答が得られ、幻覚は大幅に減少しました。

指摘された1つの制限：Claudeは依然として毎回テストを実行しないことです。開発者はこれをローカル環境の制約（古いMac、XCodeやシミュレーターの実行困難）に起因すると考えています。

Claudeはまたプロセス中にMEMORY.mdファイルを作成しましたが、開発者はこれがどのように役立つかわからないと述べています。