NeuralOS
GuideIntermediate

C-A-Rプロトコル · AIと一緒にバグのないソフトウェアを構築する方法(Claude Code, Codex, NeuralOS)

AIに何かを構築させると、AIは「ビルダーモード」に入ります。楽観的で、たった一つの幸せな道だけを想像し、自分自身のミスが見えません。C-A-Rプロトコル(構築 · 監査 · 振り返り)は、AIに帽子を替えさせ、悲観的な監査者の目で自分の仕事を見直させます — しかも別のターンで。これは、本番環境で壊れるデモと、耐えられるソフトウェアの違いです。ここに完全な手法と、Claude Code、Codex、NeuralOSで有効化するマスタープロンプトを紹介します。

Jun 17, 202614 min
これは誰のため?
AIでアプリを構築するすべての人のためです — プログラミングは必要ありません。もしAIに「完成、もう動きます」と言われた後に何かが壊れた経験があるなら、この手法はあなたのためのものです。Claude Code、Codex、Cursor、そしてNeuralOSでも同じように機能します。

問題:AIは自分自身のバグが見えない

構築と監査は両立しない精神状態です。AIが構築しているとき、AIは楽観的です。たった一つの幸せな道を想像し、「動かすこと」に集中します。そのモードでは、自分自身のミスに対して盲目です。監査はその逆を要求します。悲観主義、つまり何かが失敗しうるあらゆる形を想像することです。

AIに構築と見直しを同時にさせると、両方のタスクが損なわれます:中途半端に構築し、中途半端に監査するのです。解決策は、より賢いプロンプトではありません — 2つのフェーズを別々のターンに分けることです。

こう考えてみてください
文章を書いて校正するようなものです。書きながら校正すると、進まないしミスも見つかりません。優れた書き手は、まずすべてを書いて、翌日、頭が冴えた状態で校正します。C-A-Rは、あなたのAIにその「翌日」を与えるのです。

プロトコルの3つのフェーズ

C — 構築(Construir)。 AIは創造的なエネルギーで構築します:競合の標準をリサーチし、クリーンなアーキテクチャで、進めながら自己テストします。終わったら、手を止めてあなたに報告書を渡します(何をしたか、どんな決定を下したか、何をしなかったのか、そしてその理由)。まだ監査はしません。

A — 監査(Auditar)(そしてここに本物のデバッグがあります)。 新しいターンで(頭が冴えた、悲観的な状態で)、AIは自分自身の仕事すべてを読み返し、デバッグを行います:本物のバグ(メモリリーク、競合状態、セキュリティの欠陥、壊れたアクセシビリティ)を狩り出し、そして何より、ビルダーモードが残したギャップ、抜け、不整合を修正します。ただ「ミスを見つける」だけではありません:すべてを洗練させ、レジェンダリーな状態に仕上げます。各発見は、修正を固定する回帰テストとともに修正されます — テストがなければ、その修正は完了していません。

R — 振り返り(Reflexionar)。 AIは監査の教訓を書き記します:ビルダーモードで何を見落としたか、そしてなぜか。その文書はサイクルごとに成長し、プロジェクトの制度的記憶になります — 次回はもう同じミスを犯しません。

黄金のルール
構築と同じターンで監査することは絶対にしない。チェックリストをコードのコメントとして書くことはそれを適用したことにはなりません — 監査は別のターンで、それを裏付けるテストとともに存在しなければなりません。その分離こそが秘訣のすべてです。

完全なループ · 本当の閉じ方(C-A-Rだけではない)

実際には、C-A-Rは「振り返り」で終わりません:知識が失われず、次のサイクルがより良く始まるように、エコシステム全体を養うことで閉じます。これが本物のループです。開発の良いパスの後に毎回適用されるとおりに — そしてシリーズで見たすべてを一つにまとめます:

黄金のサイクル(良いものを仕上げるたびに)
構築 → AIが作り、あなたに報告書を渡す。
スモークテスト → 仕事を固定するテストを走らせる;先に進む前にすべて緑に。
監査 / デバッグ → 新しいターン:バグを狩り、ギャップ・抜け・不整合を修正し、レジェンダリーになるまで洗練する(各修正にはそのテストを)。
振り返り → AIが教訓を書く(何を見落としたか、なぜか)。
GitHubにプッシュ → 良いポイントをクラウドに保存する(あなたのセーフティネット)。
グラフを更新 → Graphifyを使っているなら、新しいものを反映するようグラフを再構築する。
プロトコルをメモリに保存CLAUDE.mdに残して、AIが絶対に忘れないようにする。
ループはどのくらいの頻度で?
各スプリントまたは重要な開発パスの後に — 各行の後ではありません。ルール:保存する価値のあるものを仕上げたとき、完全なループを閉じます。些細な小さな修正には必要ありません;フィーチャー、リファクタリング、複数ファイルにまたがる変更には、常に。
プロトコルをAIのメモリに保存しよう
これを習慣にして忘れないようにするために最も重要なこと:プロトコルを`CLAUDE.md`に貼り付ける(またはあなたのエージェントの指示ファイルに)。そうすればAIは、あなたが思い出させなくても、毎セッションでデフォルトとして適用します。これはシリーズの第1段(メモリ)があなたのために働いている状態です:プロトコルはあなたの頭ではなく、メモリの中で生きます。

どう適用するか、ステップバイステップ

完全なサイクル
AIに機能を構築するよう頼み、終わったら報告書をくれるよう頼む(まだ監査はさせない)
報告書を読んで承認する
新しいメッセージで「監査を進めて」と書く
AIは監査者の目ですべてを読み返し、各バグをそのテストとともに修正する
修正された発見のリストとともに監査を渡してくる
AIはミスを繰り返さないよう教訓を保存する

マスタープロンプト(コピーして貼り付け)

これをプロジェクトの最初に貼り付けてください(AIの指示ファイルに:CLAUDE.md.cursorrules、NeuralOSのエージェントの指示、または単にチャットの冒頭に)。そこから、あなたのAIはC-A-Rをデフォルトで適用します。

マスタープロンプト · 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が持っているものすべてでループを閉じることです。

レベル1 · GitHubだけを持っている
プロジェクトをGitHubに保存しているなら(そうすべきです — シリーズの第4段です)、バックアップ付きの締めくくりを加えましょう。マスタープロンプトの最後に、下の「+ GitHub」ブロックを追加してください。
マスタープロンプトに追加 · + GitHubテキスト
=== ループの締めくくり · GITHUB ===
監査が緑になった後(type-check + build + スモークテストすべてパス)、仕事を完了とみなす前に:
1. まだやっていなければ、スモークテストを走らせるよう私に思い出させる。
2. 達成したことを説明する明確なメッセージでコミットする。
3. 良いポイントをクラウドに保存するためGitHubにプッシュする。
進捗をバックアップして残さずにサイクルを閉じないでください。
レベル2 · RAGおよび/またはGraphifyを持っている
さらに知識グラフ(Graphify、第6段)やRAGを使っているなら、監査ははるかに深くなり、ループはグラフを養うことで閉じます。これがフルスタックのプロトコル、私たちが使っているものです。
マスタープロンプトに追加 · + RAG + Graphify(フルスタック)テキスト
=== 監査のための深いコンテキスト ===
監査する前に、プロジェクトの知識グラフ(Graphify)またはRAGを参照し、私が触れたものが残りとどうつながっているかを理解してください。私が変更したファイルだけでなく、システム全体への影響を理解した上で監査してください。自問してください:他のどの部分がこれに依存しているか?連鎖的に何が壊れた可能性があるか?

=== ループの締めくくり · フルスタック ===
監査が緑になったら、完全なサイクルをこの順序で閉じてください:
1. スモークテスト → すべて緑に。
2. コミット + GitHubにプッシュ(良いポイントを保存)。
3. 新しい変更を反映するよう知識グラフ(Graphify)を再構築 / 更新する。そうすれば次の監査は冴えたコンテキストを持つ。
4. 監査の教訓をプロジェクトのメモリ文書に保存する。
5. C-A-Rプロトコルが忘れられないよう、CLAUDE.mdに書かれたままであることを確認する。
このループは各スプリントまたは重要な開発パスの後に適用します。
頭の中のルール
「私は何を持っているか?」と自問して組み立てましょう:常にベースプロンプト · クラウドにバックアップするなら+ GitHub · 深いコンテキストがあるなら+ RAG/Graphify。シリーズのツールを多く持っているほど、あなたのループはより完全に(そしてより弾丸に強く)なります。

適用するにはどんなリソースが必要?

必要なものすべて
コード構築用のAI:Claude CodeOpenAI Codex、Cursor、またはNeuralOS(すでにエージェントとアプリのForge(フォージ)が統合されています)
マスタープロンプトを貼り付ける指示ファイル(CLAUDE.md.cursorrules、またはエージェントの指示)
待つ規律:構築を承認し、別のメッセージで監査を頼む
任意だが推奨:監査が完全なコンテキストを持てるようにするプロジェクトの知識グラフ(下のGraphifyのリソースを参照)
NeuralOSならさらに簡単
NeuralOSでは、各エージェントが独自の指示ファイルと永続的なメモリを持っているので、C-A-Rプロトコルは恒久的に有効になります:エージェントは構築し、あなたに報告し、別のターンで監査し、教訓を保存します — 毎回あなたが思い出させる必要はありません。

監査を次のレベルへ

監査のフェーズは、AIが触れたファイルだけでなくプロジェクト全体がどうつながっているかを理解していると、はるかに強力になります。そのためにGraphifyがあります:あなたのリポジトリを、AIが監査前に参照する知識グラフに変換します。

safishamsi/graphify
REPO

AIアシスタント(Claude Code、Codex、OpenCode)のためのマルチモーダル知識グラフ構築ツール。リポジトリ全体を、コードが何をするか、そしてなぜそう設計されたのかを説明するインタラクティブなグラフに変換します。

PythonMITView on GitHub
Graphify · あなたのAIのための知識グラフ(完全ガイド)
より良く監査するために、AICにプロジェクトの完全な地図を与える方法を学びましょう。
#metodologia#calidad#claude-code#codex
Ready to build?

Start building in
under 3 minutes

Join 4,200+ builders. No credit card. Build your first app with AI in minutes.