Opus 4.7 でプロンプトの40%が破損、修正方法は CLAUDE.md とスキルの構造化

4月にOpus 4.7がリリースされたとき、6つの中堅企業環境全体でプロンプトの約40%が一夜で壊れました。トークン消費が増加し、出力が奇妙に文字通りになりました。4.6では曖昧な指示を補完していましたが、4.7ではそうしませんでした。修正はプロンプトの書き直しではなく、ついにCLAUDE.mdとSkillファイルを真剣に活用することでした。

何が壊れ、なぜか

4.6向けに書かれたプロンプトは、モデルが曖昧な指示を寛大に解釈することを前提としていました。4.7はそれらを文字通りに解釈し、出力を修正するのに3～4ターンが必要になりました。生き残ったプロンプトは、明示的な出力形式、長さ制限、具体例を含むSkillファイルに組み込まれていたものです。

再構築のアプローチ

6つの環境にわたって、3つの構造的変更が行われました：

• スキルがスタンドアロンのプロンプトを置き換え — 3回以上実行されたものはすべて、オーディエンス、出力形式、長さ、2〜3文の具体例を含むSkillファイル（50〜200行）に格納されました。スキルはオンデマンドで読み込まれ、コンテキストを肥大化させません。
• 階層的なCLAUDE.md — ユーザーID、ビジネス、音声ルール用のグローバルファイル1つ、エンゲージメントごとのプロジェクトレベルCLAUDE.md、1回限りのセッションレベル指示。モデルは順に読み取り、セッションをまたいで持続するメンタルモデルを構築します。
• メモリファイルの分離 — CLAUDE.mdを400行未満に維持し、詳細な組織知識はCLAUDE.mdが参照する個別ファイルに保存され、オンデマンドで読み込まれます。
• 長いスキルでの検証ステップ — モデルが出力を生成し、5〜7項目のチェックリストと照合して修正します。呼び出しごとに30秒追加されますが、後処理の手間を約70%削減しました。

3週間後の結果

• プロンプトから許容可能な出力までの平均ターン数が3〜4から1〜2に減少。
• ワークスペース全体でトークン使用量が22%削減。
• 「この出力はおかしい、もう一度試そう」という割合がプロンプト4回に1回から15回に1回に減少。
• 次のモデルリリースは、マイナスではなくプラスの効果をもたらすはずです。

未解決の問題：CLAUDE.mdのバージョン管理

プロジェクトレベルのファイルはgitで管理されていますが、グローバルCLAUDE.mdはチャット履歴に保存されており、脆弱です。まだロールバックの仕組みはありません。

メンタルモデル

モデルはエンジンです。スキル+CLAUDE.md+メモリは車です。車を一度作れば、新しいエンジンごとに速度が向上します。