マニュアル駆動開発：クロードコードの自信過剰な逸脱を防ぐ方法

マニュアル駆動開発（MDD）は、Claude Codeにおける自信過剰な乖離を解決するために設計された方法論です。AIがシステムに関する誤った前提に基づいて作業するため、コンパイルが通り自身のテストを通過する誤ったコードを生成する問題に対処します。

問題：自信過剰な乖離

Claude Codeが大規模な本番コードベースで作業する際、いくつかのファイルを読み込み、パターンを推測し、前提に基づいてコーディングを開始します。これにより自信過剰な乖離が生じます - コードは正しく見え、実行され、テストを通過しますが、Claudeが実際のシステム動作ではなく自身の前提に対してテストを書いたため、間違っているのです。この乖離は、実際のユーザーがClaudeが知らなかったエッジケースに遭遇する本番環境で初めて表面化します。

著者は、これは単にClaudeがあなたのシステムを知らないという問題ではなく、開発者も自身のシステム全体を確実に説明できないという点を指摘しています。深夜11時には、オペレーターが特定のグループにスコープされていること、ROLE_HIERARCHYが3つの異なるファイルで定義されていること、基本層ポリシーがシステム専用でAPI経由では作成できないことなどを思い出して伝えることはできないでしょう。

本番環境でのMDDの成果

MDDを使用した本番環境監査では：

• 7つのセクションを監査
• 190件の所見を特定
• 876件の新規テストを作成
• 7時間48分のClaude Codeセッション時間
• 推定234〜361時間の人間開発者時間を節約（30〜46倍の圧縮率）
• 全セクションでCLAUDE.mdルール違反ゼロ

コードベースには200以上のルート、80以上のモデル、ネットワークポリシーをホスト上のライブnftablesルールに変換するデーモン強制パイプラインが含まれていました。

MDDが他のツールと異なる点

MDDは既存のツールとは異なる問題に対処します：

• GSDはコンテキスト腐敗（セッションが埋まるにつれて品質が低下する問題）を解決
• Mem0とClaude-Memはセッション健忘症（セッション終了時にすべてを忘れる問題）を解決
• MDDは自信過剰な乖離（誤った前提に基づく間違ったコード）を解決

これら3つは互いに競合せずに同時に実行できます。ルール施行をリアルタイムで監視するRuleCatchは、MDDを使用したSwarmKビルドでは、MDDなしのセッションと比較して60%少ないルール違反を報告しました - 同じモデル、同じルール、同じコードベースでの結果です。

この方法論、プロンプト、セクションごとのデータは、ソースによれば文書化され再現可能です。