要約:「Vibe Coding」—AIにカジュアルにソフトウェアを構築させる行為がトレンドになっています。しかし、構造がないと、必然的に「コンテキストのずれ」やスパゲッティコードにつながります。AIを使って企業グレードのソフトウェアを構築するには、厳格な「コンテキストアーキテクチャ」が必要です。水星社では、これを「The Codex Protocol」と呼んでいます。これは、あなたのドキュメントを単なる提案としてではなく、AIが1行のコードを書く前に必ず参照しなければならない不変の法則として扱います。こちらは水星テクノロジーソリューションのCEO、ジェームズです。インターネットは「Vibe Coding」で賑わっています。その約束は魅力的です：あなたがカジュアルに（「バイブス」）AIに話しかけると、それがアプリを構築します。
私は開発サークルで流通している人気のワークフローをレビューしました。それらはプロトタイプには素晴らしいですが、真剣なエンジニアリングには致命的な欠陥があります：
それらはAIが「全体像」を覚えていると仮定しています。しかし、AIは覚えていません。
LLMはエントロピーに悩まされています。会話が長くなるにつれて、AIは40メッセージ前に合意したデータベーススキーマを忘れてしまいます。新しいパターンを創造し始めます。「バイブス」は混乱に変わります。水星社では、これを厳格なワークフローに洗練しました。私たちはこれをVibe Codingとは呼びません。私たちはこれを「コンテキストエンジニアリング」と呼びます。
AIを使ってソフトウェアを構築するための「水星プロトコル」は、私たちが「The Codex」と呼ぶ真実の単一のソースを使用します。
コア哲学：「The Codex」秘密はモデル（Claude vs. GPT-5）ではありません。秘密は「外部化された記憶」です。
プロジェクトフォルダを単なるコードの場所としてではなく、AIのための「脳」として扱わなければなりません。私たちは「/codex」と呼ばれる厳格なフォルダ構造を強制します。なぜ「Codex」なのか？それは権威を示唆するからです。これはメモではなく、「法律」です。AIが1行のコードを書く前に、必ずThe Codexを参照しなければなりません。構造
ルートディレクトリに/codexという名前のフォルダを作成します。そこには5つの不変のファイルが含まれています：
product-vision.md（なぜ）：高レベルの目標。（例：「ThreeJSを使用した3Dマルチプレイヤー犬の戦いゲーム」）
tech-stack.md（どのように）：特定のツール。（例：「ネットワーキングにはWebSockets、物理にはRapier。Reactは使用せず、バニラJSのみ」）architecture.md（地図）：
ファイル構造とデータベーススキーマ。これは最も重要なファイルです。implementation-plan.md（道筋）：
タスクのステップバイステップのリスト。各ステップには「必ず」検証テストが必要です。
progress.md（ログ）：
- 完了したこと、保留中のこと。ワークフロー：アーキテクチャ --> 実行 --> 検証
- ただチャットを開いてコーディングを始めないでください。このループに従ってください。フェーズ1：アーキテクト（モデル：Claude Opus 4.5）
- 私たちは最も賢く、最も遅いモデルを使用して法律を書きます。アクション：あなたはプロダクトマネージャーとして行動します。あなたの頭の中をチャットに放り込みます。This is the most critical file.
- implementation-plan.md (The Path): A step-by-step list of tasks. Each step must have a verification test.
- progress.md (The Log): What is done, what is pending.
The Workflow: Architecture --> Execution --> Verification
Do not just open a chat and start coding. Follow this loop.
Phase 1: The Architect (Model: Claude Opus 4.5)
We use the smartest, slowest model to write the law.
Action: You act as the Product Manager. You dump your brain into the chat.
プロンプト: "システムアーキテクトとして行動してください。私のアイデアに基づいて、product-vision.md と tech-stack.md のエントリーを作成してください。その後、architecture.md を提案してください。まだコードは書かないでください。これらのファイルは The Codex に入ります。"
成果: デザインを確定させます。AI に後でアーキテクチャの決定をすることを明示的に禁じます。
フェーズ 2: スクライブ (モデル: Claude Sonnet 4.5 / Codex)
私たちは、法律を実行するために迅速な「エージェント型」モデルを使用します。
ゴールデンルール: 新しいチャットセッションは必ず AI が The Codex に相談することから始まらなければなりません。
プロンプト: "/codex/@architecture.md と /codex/@implementation-plan.md を参照してください。現在、ステップ 3 にいます。The Codex で定義されたアーキテクチャに厳密に従ってステップ 3 を実装してください。ステップ 4 に進まないでください。"
AI に毎回 /codex を読ませることで、「コンテキストドリフト」を排除します。プロンプト #1 であろうとプロンプト #100 であろうと、AI は同じ真実に基づいています。
フェーズ 3: バリファイア (モデル: 人間 + ブラウザツール)
これがあなたの仕事です。
一般的なガイドは自動化を推奨しますが、私は人間の検証を主張します。
アクション: AI が「ステップ 3 は完了しました。」と言います。
あなた: コードを実行してください。ログを確認してください。3D プレーンは実際に飛ぶのですか？
重要なステップ: もしうまくいったら、AI に命令します: "/codex/@progress.md を更新してステップ 3 を完了としてマークしてください。新しいファイルを追加した場合は /codex/@architecture.md を更新してください。"
その後にのみ、Git にコミットします。Git はあなたのセーブポイントです。もし AI がステップ 4 で幻覚を見たら、git reset --hard を行い、再試行します。
「反重力」の利点: モデルアービトラージ
元のガイドは一つのツールを選ぶことを提案していますが、私は反対です。
モデルアービトラージを使用してください:
- 計画 (アーキテクト):使用するのはOpus 4.5です。それはエッジケースについて深く考え、堅牢な Codex を作成します。
- コーディング (スクライブ):使用するのはSonnet 4.5です。それは指示に従い、コストが安いです。
- リファクタリング (ライブラリアン):使用するのはGemini 3 Proです。それは全体のコードベースを一度に読むための大きなコンテキストウィンドウを持っています。
結論: "バイブ" から "ビジョン" へ
"バイブコーディング" は、AI が作業している間にただリラックスできることを意味します。それは誤りです。
このワークフローは、あなたの努力をタイピングからガバナンスへとシフトさせます。
- あなたはもはやレンガ職人ではありません。
- あなたはCodexの守護者です。
あなたの仕事は、Codexが清潔であることを確保することです。architecture.md が混乱すると、コードも混乱します。implementation-plan.md が曖昧であると、AI は行き詰まります。
Codex をマスターすれば、あなたは一人でエンタープライズグレードのソフトウェアを構築できます。無視すれば、壊れたスクリプトが詰まったフォルダしか得られません。
マーキュリーテクノロジーソリューション: デジタリティを加速させる。
