問題:AIは自分自身のバグが見えない
構築と監査は両立しない精神状態です。AIが構築しているとき、AIは楽観的です。たった一つの幸せな道を想像し、「動かすこと」に集中します。そのモードでは、自分自身のミスに対して盲目です。監査はその逆を要求します。悲観主義、つまり何かが失敗しうるあらゆる形を想像することです。
AIに構築と見直しを同時にさせると、両方のタスクが損なわれます:中途半端に構築し、中途半端に監査するのです。解決策は、より賢いプロンプトではありません — 2つのフェーズを別々のターンに分けることです。
プロトコルの3つのフェーズ
C — 構築(Construir)。 AIは創造的なエネルギーで構築します:競合の標準をリサーチし、クリーンなアーキテクチャで、進めながら自己テストします。終わったら、手を止めてあなたに報告書を渡します(何をしたか、どんな決定を下したか、何をしなかったのか、そしてその理由)。まだ監査はしません。
A — 監査(Auditar)(そしてここに本物のデバッグがあります)。 新しいターンで(頭が冴えた、悲観的な状態で)、AIは自分自身の仕事すべてを読み返し、デバッグを行います:本物のバグ(メモリリーク、競合状態、セキュリティの欠陥、壊れたアクセシビリティ)を狩り出し、そして何より、ビルダーモードが残したギャップ、抜け、不整合を修正します。ただ「ミスを見つける」だけではありません:すべてを洗練させ、レジェンダリーな状態に仕上げます。各発見は、修正を固定する回帰テストとともに修正されます — テストがなければ、その修正は完了していません。
R — 振り返り(Reflexionar)。 AIは監査の教訓を書き記します:ビルダーモードで何を見落としたか、そしてなぜか。その文書はサイクルごとに成長し、プロジェクトの制度的記憶になります — 次回はもう同じミスを犯しません。
完全なループ · 本当の閉じ方(C-A-Rだけではない)
実際には、C-A-Rは「振り返り」で終わりません:知識が失われず、次のサイクルがより良く始まるように、エコシステム全体を養うことで閉じます。これが本物のループです。開発の良いパスの後に毎回適用されるとおりに — そしてシリーズで見たすべてを一つにまとめます:
- 構築 → AIが作り、あなたに報告書を渡す。
- スモークテスト → 仕事を固定するテストを走らせる;先に進む前にすべて緑に。
- 監査 / デバッグ → 新しいターン:バグを狩り、ギャップ・抜け・不整合を修正し、レジェンダリーになるまで洗練する(各修正にはそのテストを)。
- 振り返り → AIが教訓を書く(何を見落としたか、なぜか)。
- GitHubにプッシュ → 良いポイントをクラウドに保存する(あなたのセーフティネット)。
- グラフを更新 → Graphifyを使っているなら、新しいものを反映するようグラフを再構築する。
- プロトコルをメモリに保存 →
CLAUDE.mdに残して、AIが絶対に忘れないようにする。
どう適用するか、ステップバイステップ
- AIに機能を構築するよう頼み、終わったら報告書をくれるよう頼む(まだ監査はさせない)
- 報告書を読んで承認する
- 新しいメッセージで「監査を進めて」と書く
- AIは監査者の目ですべてを読み返し、各バグをそのテストとともに修正する
- 修正された発見のリストとともに監査を渡してくる
- AIはミスを繰り返さないよう教訓を保存する
マスタープロンプト(コピーして貼り付け)
これをプロジェクトの最初に貼り付けてください(AIの指示ファイルに:CLAUDE.md、.cursorrules、NeuralOSのエージェントの指示、または単にチャットの冒頭に)。そこから、あなたのAIはC-A-Rをデフォルトで適用します。
今後、すべての些細でない作業(新しいフィーチャー、リファクタリング、複数ファイルにまたがる変更)で、構築-監査-振り返り(C-A-R)プロトコルを適用してください。1行の些細な修正のとき、または明示的に頼まれたときだけスキップしてください。 === フェーズ1 · 構築 === 創造的なエネルギーで構築してください。コードを書く前に競合の標準をリサーチしてください。クリーンな境界のアーキテクチャで。進めながら自己テストしてください。 終わったら、手を止めて報告書をください: - 作成/変更したファイルと主要な決定 - 標準に対してどんな改善を加えたか - テスト結果(type-check、build、tests) - 何をしなかったか、そしてその理由(スコープの境界) それから待ってください。このターンでは監査しないでください。監査を構築と混ぜないでください。 === フェーズ2 · 監査(別ターン · 私の承認が必要)=== 私が「監査を進めて」と言うまで待ってください。それから: 1. 各ファイルを監査者の頭で(冴えた、悲観的な状態で)読み返す 2. 発見をカタログ化する: - クリティカル:本物のバグ(メモリリーク、競合状態、セキュリティの欠陥、壊れたアクセシビリティ、間違ったセマンティクス、データ破損) - 改善:堅牢性、パフォーマンス、UXの磨き上げ 3. 各発見を、それを固定する回帰テストとともに修正する — テストがなければ修正は完了していない 4. エッジケースの積極的なテストを走らせる:unicode、境界値、イベントのスパム、並行操作、キャンセルパス 5. 四重に検証する:type-check + build + 既存のテスト + 新しいテスト、閉じる前にすべて緑に === フェーズ3 · 振り返り(監査とともに)=== 教訓の文書を書いてください:各発見をその根本原因とともに(ビルダーモードで何を見落としたか?)、メタ教訓、そして次の構築のための更新されたチェックリスト。この文書はサイクルごとに成長し、プロジェクトのメモリになります。 ルール: - 構築と同じターンで監査しない。 - 新しいコードに対して本物の監査パスを走らせずに「バグなし」と断言しない。 - 監査の修正の回帰テストをスキップしない。 - 根本原因を、決してパッチではなく。値が空で届いたら、なぜかを見つける;デフォルト値で塞がない。
すでに持っているものに合わせて、あなた独自のプロトコルを組み立てる
上のプロンプトはベースです。しかしプロトコルは、シリーズのツールを加えるとより強力になります。あなたのセットアップに対応するプロンプトを使ってください — 少ないものから完全なものへ。狙いは:AIが持っているものすべてでループを閉じることです。
=== ループの締めくくり · GITHUB === 監査が緑になった後(type-check + build + スモークテストすべてパス)、仕事を完了とみなす前に: 1. まだやっていなければ、スモークテストを走らせるよう私に思い出させる。 2. 達成したことを説明する明確なメッセージでコミットする。 3. 良いポイントをクラウドに保存するためGitHubにプッシュする。 進捗をバックアップして残さずにサイクルを閉じないでください。
=== 監査のための深いコンテキスト === 監査する前に、プロジェクトの知識グラフ(Graphify)またはRAGを参照し、私が触れたものが残りとどうつながっているかを理解してください。私が変更したファイルだけでなく、システム全体への影響を理解した上で監査してください。自問してください:他のどの部分がこれに依存しているか?連鎖的に何が壊れた可能性があるか? === ループの締めくくり · フルスタック === 監査が緑になったら、完全なサイクルをこの順序で閉じてください: 1. スモークテスト → すべて緑に。 2. コミット + GitHubにプッシュ(良いポイントを保存)。 3. 新しい変更を反映するよう知識グラフ(Graphify)を再構築 / 更新する。そうすれば次の監査は冴えたコンテキストを持つ。 4. 監査の教訓をプロジェクトのメモリ文書に保存する。 5. C-A-Rプロトコルが忘れられないよう、CLAUDE.mdに書かれたままであることを確認する。 このループは各スプリントまたは重要な開発パスの後に適用します。
適用するにはどんなリソースが必要?
- コード構築用のAI:Claude Code、OpenAI Codex、Cursor、またはNeuralOS(すでにエージェントとアプリのForge(フォージ)が統合されています)
- マスタープロンプトを貼り付ける指示ファイル(
CLAUDE.md、.cursorrules、またはエージェントの指示) - 待つ規律:構築を承認し、別のメッセージで監査を頼む
- 任意だが推奨:監査が完全なコンテキストを持てるようにするプロジェクトの知識グラフ(下のGraphifyのリソースを参照)
監査を次のレベルへ
監査のフェーズは、AIが触れたファイルだけでなくプロジェクト全体がどうつながっているかを理解していると、はるかに強力になります。そのためにGraphifyがあります:あなたのリポジトリを、AIが監査前に参照する知識グラフに変換します。
AIアシスタント(Claude Code、Codex、OpenCode)のためのマルチモーダル知識グラフ構築ツール。リポジトリ全体を、コードが何をするか、そしてなぜそう設計されたのかを説明するインタラクティブなグラフに変換します。
Graphify · あなたのAIのための知識グラフ(完全ガイド)より良く監査するために、AICにプロジェクトの完全な地図を与える方法を学びましょう。