English | 简体中文 | 日本語 | 한국어 | Tiếng Việt | Português | Español | Deutsch | Français | हिंदी

Flowser *世界トップクラスのエンジニアが、バイブコーダーのために開発*
*[flowser.ai](https://flowser.ai) — GTM向けコンピュータ付きAIエージェント*
# vibecode-pro-max-kit

Flow like water

「全集中——スペックの呼吸 拾ノ型・ヴァイブの流れは決して途切れない。」
——竈門炭治郎

*プロジェクトにドロップするだけ。AIエージェントが完全なプラン優先の開発プロセスを手に入れます——7つのゲート付きフェーズ、自己修復チェックループ、最初から最後まで場所を失わずに動くオートパイロット。*
📦 ワンコマンドインストール
1行のcurlでどんなプロジェクトにも導入できます。新規・既存ユーザーを自動判別し、既存ファイルを上書きしません。		 🌐 どこでも動作
あらゆるテックスタック、あらゆる言語、あらゆるAIコーディングエージェント——Claude Code、Codex、Cursor、Windsurf、Copilotなど。
🧭 RIPER-5 プラン優先ワークフロー
7つのゲート付きフェーズ（Research → Spec → Innovate → Plan → Validate → Execute → Update-Process）でエージェントが即コードに飛びつくのを防ぎます。		 🚀 オートパイロットモード（quick / fast / full）
1つのフレーズでどのフェーズからでもハンズフリー実行を開始できます。3つのレーンでリスクに合わせた手順を選択。
🎯 /goal ——完了まで走り続けるトークン
1つのコピペ可能なブロックで、エージェントがフェーズをまたいで止まらず走り続けます——新しいセッションでも再開できます。		 🔁 PVL + EVL 自己修復ループ
プランチェックと修正、テストチェックと修正のループが自動でギャップを見つけて修正し、再確認します——それぞれ最大10サイクル。
🔍 vc-autoresearch
プラン、テスト、スペック、ドキュメント、評価に向けられる再利用可能なギャップ発見→修正→繰り返しループ。		 🧪 フィージビリティプローブ
エージェントが設計アプローチを確定する前に、実装前検証（VIABLE / NOT-VIABLE）を行います。
🎛️ スマート戦略選択
各フェーズ前に、1エージェントか複数か協調チームかをコスト見積もり付きで比較し、最安値の適切な選択をします。		 🧮 スマートなモデル活用
高コストモデルはコード作成のみ。それ以外はすべて安価なモデルが担当。コストを下げつつ品質を維持。
🤔 インテント明確化
リクエストが曖昧な場合、エージェントは推測して間違ったものを作る代わりに、事前にいくつかの的確な質問をします。		 🛡️ 36バリデーター
意見ではなく機械的な正確性チェック——キット自体の構造を守り、問題が出荷前にドリフトを検出します。
🏗️ フェーズプログラム
大規模プロジェクトを品質ゲート付きの独立フェーズに分割するので、大きな作業が途中で崩壊しません。		 🔀 学びながら自己再構成するプログラム
学習しながら、エージェントが新フェーズを挿入し、作業を並べ替え、ブロックされたステップをスキップします——プランは動的に適応します。
🧠 場所を失わない
進捗はフェーズごとにディスクに書き込まれるので、メモリリセットが起きても実行が継続し、正確に中断した場所から再開します。		 📚 自己改善型プロジェクトメモリ
セットアップ時にコードベースを学習し、機能をリリースするたびに共有メモを最新状態に保ちます。ドキュメントが古くなりません。
⚡ Quick Fix + Fast Mode
小さな変更向けの軽量レーン。1行の修正は1行のままで済みます。		 🧱 レイヤー化された自動発見スキル
スキルは明確なレイヤーに整理され、自動的に発見されます——エージェントは常にそのステップに適切なツールを見つけます。
🤖 15エージェント · 33スキル · 10フック
専門化されたエージェント、再利用可能なスキル、セーフティフックのフルチームが最初からすべて連携済み。		 🔄 フルキットライフサイクル
インストール、セットアップ、アップデート、パブリッシュがそれぞれ1コマンド——すべてのプロジェクトを安全に最新キットで維持。
📝 SPEC——平易な言葉での合意
設計の前に、シンプルなユーザーストーリーで何を作るかを明記します——誤解を最も安くキャッチできる場所。		 🎯 常にインテントを確認
後続のすべてのフェーズがSPECに照らし合わせます：作っているものは本当に求められているものか？

Stars Forks License Contributors CI Version Agents Skills Hooks 7 Tools

最もシンプルで、最も柔軟で、チームフレンドリーなコーディングキット

Claude Code  Codex CLI  Cursor  Windsurf
Antigravity  OpenCode  GitHub Copilot

あらゆるテックスタック、あらゆる言語、あらゆるプロジェクトで動作

Tech Stack Row 1
Tech Stack Row 2
Tech Stack Row 3

デコレーションではありません。vc-setupを実行すると、エージェントがコードベースをスキャンし、
スタックを検出して、すべてのスキルが動作前に参照するプロジェクト固有のナレッジグループを構築します。
他のハーネスはエージェントを1言語にロックします——rust-review-agent、python-linter——他では役に立ちません。
このキットは上記のあらゆる組み合わせに適応し、機能をリリースするたびに知識を蓄積します。

--- ## ⚡ はじめる——1コマンド、30秒 > **前提条件：** Node.js ≥ 22、git、bash（macOS / Linux / WSL；Alpineの場合：`apk add bash`）。 **コマンドは1つだけで、誰でも同じです。** プロジェクトフォルダー内で実行してください。新規か既存ユーザーかを自動検出し、ファイルを上書きせずに安全にインストールし、*次に何を言えばいいかを正確に教えてくれます。* ```bash curl -fsSL https://raw.githubusercontent.com/withkynam/vibecode-pro-max-kit/main/install.sh | bash ``` 完了したら2つのメッセージのいずれかが表示されます——**出力の最後を読んで、そこに書いてある通りにしてください：**

🆕 新規プロジェクト

インストーラーがハーネスを検出せず、次のように表示します：

Next: Run: claude → Say: "Run vc-setup"

→ エージェントを開いて Run vc-setup と言ってください

vc-setupがテックスタックを検出し、process/フォルダーを作成し、コードベースをスキャンして、実際のアーキテクチャ、規約、テストコマンドを書き込みます——チェックリストではなく会話です。

🔄 既存ハーネス（アップグレード）

インストーラーが以前のインストールを検出し、次のように表示します：

Next (upgrade detected): Run: claude → Say: "Run vc-update"

→ エージェントを開いて Run vc-update と言ってください

vc-updateが最新バージョンを取得し、古いフォーマットのプランやフォルダーが見つかれば、データ損失ゼロで移行するための貼り付け可能なプロンプトを提供します。process/には一切触れません。
> 💡 **コマンドを推測する必要はありません。** `install.sh`がルーティングします：新規 → `vc-setup`、アップグレード → `vc-update`。インストールを再実行しても常に安全です——何も壊しません。**Codexユーザー：** チャットで言う代わりに `/vc-setup`（または `/vc-update`）を実行してください。
📦 インストールがディスクに置くもの（非破壊的）
``` your-project/ ├── .claude/ │ ├── agents/ # 🤖 15のエージェント定義（.md） │ ├── skills/ # ⚡ 33のスキル（各ディレクトリにSKILL.md） │ └── hooks/ # 🪝 10のライフサイクルフック（.cjs / .mjs） ├── .codex/agents/ # 🔄 Codex用ミラーエージェント ├── .agents/skills → # 🔗 .claude/skillsへのシンボリックリンク（Codex発見用） ├── CLAUDE.md # 📋 オーケストレーター＋ルーティングルール ├── AGENTS.md # 📖 エージェント＋スキルレジストリ（クロスツール） └── process/ └── development-protocols/ # 📜 22の共有ワークフロードキュメント（installで配置） # context/、プラン、フィーチャー → vc-setupで構築 ``` - **非破壊的。** 既存の`.claude/skills/`、`.claude/agents/`、`process/`、`settings.json`は一切削除されません。キット所有のファイルのみ書き込み・更新されます。 - **既存の設定がある？** `.vibecode-backup/`にバックアップされ、`settings.json`はその後復元されます。 - **既存の`CLAUDE.md`がある？** `CLAUDE.md.pre-vibecode`としてバックアップされます。 - **既存の`process/`がある？** installは一切触れません——`vc-setup` / `vc-update`が差分を先に見せた上でインタラクティブに移行します。 > **初回インストール時の注意：** `vc-`で始まる（キット予約済みネームスペース）カスタムスキル/エージェントがあり、今まで一度もインストールしたことがない場合、古いファイルの削除ステップでフラグが立つことがあります。インストール後、`ls .claude/skills/ .claude/agents/`で確認してください。独自追加には`my-`、`team-`、`proj-`プレフィックスを使えば完全に回避できます。
🤖 エージェントからセットアップしたい方向け（フルプロンプト）
> **プロジェクトフォルダーを作業ディレクトリにしてClaude CodeまたはCodexを開き**、次を貼り付けてください： ``` First, install the vibecode-pro-max-kit agent harness by running this command: curl -fsSL https://raw.githubusercontent.com/withkynam/vibecode-pro-max-kit/main/install.sh | bash After install completes, run vc-setup and follow the full interactive flow: 1. DETECT — Read package.json (or go.mod, Cargo.toml, pyproject.toml, etc.), detect my stack: framework, package manager, monorepo structure, test framework, database, auth. Also check for any existing .claude/, process/, or context files. 2. SHOW ME WHAT YOU FOUND — Summarize detection and wait for me to confirm. If this is an existing project, tell me what looks good vs what could be improved. 3. ASK ME ABOUT THE PROJECT — Have a real conversation. Ask follow-ups, probe anything vague, keep going until you genuinely understand it. Summarize back and confirm. 4. SCAFFOLD — Create the process/ directory. If process/ already exists, show me the plan and wait for approval. Never silently move or delete my files. 5. STUDY — Deep-scan and populate process/context/all-context.md with REAL content: repo structure, stack + versions, patterns, import aliases, env vars, routes, schema, tests. No placeholder text. 6. VALIDATE — Run all validation checks to confirm everything is wired correctly. Rules: read and preserve good existing context; show me a summary before each major change and wait for my OK; never create empty placeholder files; ask before reorganizing. ```
目次 - [一目でわかる概要](#-一目でわかる概要) · [課題](#-課題) · [解決策](#️-解決策) - [バイブコーディング革命](#バイブコーディング革命) · [誰のためのツール？](#誰のためのツール) · [比較](#比較) · [何が違うのか](#-何が違うのか) - [仕組み：コーディネーター](#-仕組みコーディネーター) · [RIPER-5ライフサイクル](#-riper-5ライフサイクル) · [インテント明確化](#-インテント明確化) - [2つの品質ループ（PVL + EVL）](#-2つの品質ループpvl--evl) · [戦略比較＋モデルポリシー](#-戦略比較モデルポリシー) · [オートパイロットモード](#-オートパイロットモードハンズフリーriper-5) · [フィージビリティプローブ＋バリデーター](#-フィージビリティプローブバリデーターセーフティネット) - [組み込みセーフティシステム](#️-組み込みセーフティシステム) · [実装前インテリジェンス](#-実装前インテリジェンス) · [品質パイプライン](#-品質パイプライン実行に組み込み済み) - [プランライフサイクル](#-プランライフサイクル) · [フェーズプログラム](#️-フェーズプログラム崩壊しない大規模プロジェクト) · [コンテキストグループ](#-コンテキストグループ) · [フィーチャーフォルダー](#-フィーチャーフォルダー) · [スキルレイヤー](#-スキルレイヤー) · [自己改善型プロジェクトメモリ](#-自己改善型プロジェクトメモリ) - [中身の紹介](#-中身の紹介) · [Quick Fix + Fast Mode](#-quick-fix--fast-mode) · [キットライフサイクル](#-キットライフサイクルinstall--setup--update--publish) · [コントリビュート](#コントリビュート)
--- ## 🎁 一目でわかる概要

🤖

15

エージェント
フェーズごとに1つ＋6つの専門エージェント

⚡

33

スキル
20のワークフロー＋13のヘルパー、キーワードマッチング

🪝

10

フック
セーフティレール＋自動コンテキスト読み込み

📜

22

プロトコル
全エージェントが従う共有ルール

🛡️

36

バリデーター
出荷前にエラーを検出する自動チェック

🔧

7

ツール
Claude Code · Codex · Cursor · Windsurf · Antigravity · OpenCode · Copilot

🌍

10

言語
EN · 中文 · 日本語 · 한국어 · VI · PT · DE · FR · ES · हिन्दी

⚡

30s

インストール
1コマンド、あとはエージェントが案内

🛩️

オートパイロット
3レーン（quick / fast / full）——どのフェーズからでも開始、止まらずに最後まで走る

📌

/goal ブロック
リセット後でもハンズフリー実行をセッションをまたいで再開できる短いコピペテキスト

🔁

vc-autoresearch
ギャップ発見→修正→繰り返しループ（プラン、テスト、評価の共有ツール）

🔬

フィージビリティプローブ
設計を確定する前の実装前検証（VIABLE / NOT-VIABLE）
--- ## 🔥 課題 Claudeに「Webhook対応を追加して」と頼むと、すぐにコードを書き始めます。アーキテクチャについて質問もしない。既存パターンのチェックもしない。プランもなし。コードベースに合わない400行ができあがって、修正に1時間かかります。 **でもこれは表面的な問題に過ぎません。** より深い問題が重くのしかかります：

🧠

セッションごとにコンテキストが消える

エージェントは学んだことを全部忘れます。毎回同じミス、同じ質問。記憶もなく、知識の蓄積もありません。

📄

ドキュメントが一瞬で古くなる

先週いいコンテキストドキュメントを書いたのに、もう古くなっています。コードベースの変化に合わせて自動更新する仕組みがありません。

💥

大きなタスクが途中で破綻する

コンテキストウィンドウがいっぱいになり、状態が失われ、エージェントがハルシネーションを始めます。3時間目にゼロからやり直しです。

🤝

スペックもレビューもコラボレーションもない

PMがエージェントのビルド内容をレビューできません。コードを書く前に共有・議論・承認できる成果物がありません。

🎭

アーキテクチャの判断がハルシネーションされる

エージェントは他のコードベースがどう解決したかを調べずに、パターンをでっち上げます。

🚀

「完了」を証明するものがない

エージェントは「すべてのテストがパス」と言います——でも独立してテストを再実行したわけではありません。本番で発覚します。
**あなたのエージェントには知性があっても、プロセスも記憶もチームとのコラボレーション手段もないのです。** 開発者であれ、PMであれ、バイブコーディングを始めたばかりのCEOであれ——この問題は誰にとっても同じです。解決策も同じです：**エージェントに本物の開発プロセスを与えること。** --- ## 🛠️ 解決策 このキットは単なる`CLAUDE.md`ではなく、**15の専門エージェント、33のスキル、10のフック、22のプロトコル**という完全な開発システムをプロジェクトにインストールします——エージェントが**理解してからビルドし、証明してから出荷する**ステップロック型ワークフロー付きで。

📋

プラン優先アプローチ

コードを一行も書く前に、PMと開発者が同じ成文化されたプランをレビューします

🔄

自己改善型ナレッジ

機能リリースのたびに自動更新——ドキュメントが古くなりません

⚡

ハンズフリー実行

セッションリセットを生き延びます——分単位ではなく時間単位で動きます

🧬

アーキテクチャリサーチ

設計判断の前に実際のコードベースを調査します

✅

2つの品質チェック

コード作成前にプランを確認し、作成後に独立してテストを再実行します

🧭

スマートナレッジルーティング

毎回ナレッジベース全体ではなく、関連するものだけを読み込みます

### フルRIPER-5フロー——7フェーズ、すべてのステップにゲート ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD R["RESEARCH\nリードオンリーのファクト収集"] S["SPEC\n要件ドキュメント"] I["INNOVATE\n2〜3のアプローチ"] P["PLAN\n詳細チェックリスト"] V["VALIDATE\nプラン→コントラクト\n（PVLループ）"] E["EXECUTE\n実装\n（EVLループ）"] U["UPDATE PROCESS\nキャプチャ＋アーカイブ"] R -->|"go"| S S -->|"go"| I I -->|"go"| P P -->|"ENTER VALIDATE"| V V -->|"Gate: PASS"| E E -->|"gates green"| U style R fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style S fill:#0277BD,stroke:#01579B,color:#FFFFFF style I fill:#E65100,stroke:#BF360C,color:#FFFFFF style P fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style V fill:#558B2F,stroke:#33691E,color:#FFFFFF style E fill:#C62828,stroke:#B71C1C,color:#FFFFFF style U fill:#00695C,stroke:#004D40,color:#FFFFFF ``` **インタラクティブモード**では、各フェーズが「go」を待ってから次に進みます——あなたはすべてのステップでループに入っています。**オートパイロットまたは /goal モード**では、最初に1回承認すれば、システムが完了まで自動で動かします。以下の3つの特定のハードストップのみで止まります。**VALIDATE**と実行後の再テストは省略不可能で——バグ作業が出荷されるのを防ぐハードゲートです——どちらのモードでも自動実行されます。 --- ## バイブコーディング革命

「最もホットな新しいプログラミング言語は英語だ。」

——Andrej Karpathy

**バイブコーディングはソフトウェアを作れる人を変えました。プラン優先開発は出荷できるものを変えます。**

63%

のバイブコーディングユーザーは開発者ではありません

16.2M

人のシチズンデベロッパーが世界中に
（前年比38%成長）

$4.7B

のバイブコーディング市場
年38%成長中

25%

のYC W25スタートアップがAI生成コード95%以上
ほとんどのツールはプロジェクトの開始を助けます。このキットは**完成させる**ことを助けます——チームがレビューできるプラン、古くならないナレッジ、ミスが出荷される前にキャッチするセーフティチェックとともに。 --- ## 誰のためのツール？

「重要なのは誰がタイプしたかじゃない。何が出荷されたかだ。」

——Garry Tan, YC

🧑‍💼

CEO / 創業者

「認証、課金、ランディングページ付きのSaaSを作って」

エージェントがスタックを調査し、レビュー可能なアーキテクチャプランを書き、テスト付きで実装し、後から技術共同創業者が監査できるようにすべての判断を記録します。

📊

プロダクトマネージャー

「MRR、チャーン率、成長指標を表示するダッシュボードを作って」

PRDスタイルのSPECを生成し、コードを書く前にあなたの承認を得て、スペック通りに実装し、検索可能なプロジェクト履歴としてプランをアーカイブします。

🎨

デザイナー

「このFigmaスクリーンショットをピクセルパーフェクトに再現して」

デザイン対応エージェントがモックアップを分析し、デザイントークンを使ってコンポーネントごとに実装し、ビジュアル比較チェックを起動します。

⚙️

エンジニア

「認証モジュールをゼロダウンタイムでRBAC対応にリファクタして」

現在の認証コードと他のコードベースがRBACをどう解決したかを調査し、影響ファイルをマッピングしたマイグレーションプランを作成し、ロールバックノート付きで安全に実装します。
--- ## 比較 | 機能 | vibecode-pro-max-kit | Superpowers | GSD | gstack | |---------|---------------------|-------------|-----|--------| | プラン優先ライフサイクル | フルRIPER-5（research → spec → innovate → plan → validate → execute → update） | 必須ワークフロー | コンテキスト腐敗の修正 | 部分的 | | ステップロック安全性 | フェーズごとのツール制限（リードオンリーリサーチ、innovateでは書き込み不可） | スキルベース制約 | フェーズ分離 | なし | | 品質チェックループ | **2つ**——PVL（プランを確認）＋EVL（テストを独立して再実行） | スキルごと | 自動なし | なし | | マルチツール対応 | `AGENTS.md`＋`SKILL.md`オープン標準で7ツール | Claude Codeプラグイン | 14ランタイム | 1ツール | | 自動改善ナレッジ | トピックグループ化されたナレッジ、機能完了ごとに更新 | プラグインメモリ | ディスク永続状態 | 手動 | | チームコラボレーション | 共有プラン、スペック、レビューファイル | ソロ | ソロ | ソロ | | スキルシステム | 33の自動発見、毎プロンプトでキーワードマッチング | 86の合成可能スキル | メタプロンプティング | 23のロールツール | | 大規模マルチフェーズプロジェクト | アンブレラプラン＋フェーズごとのインナーループとリグレッションチェック | シングルタスク | シングルタスク | シングルタスク | | ハンズフリーモード | オートパイロット（3レーン）＋スタンディング `/goal` 同意 | 手動 | 手動 | 手動 | | インストール | 30秒の`curl`＋自動ルーティングセットアップ | プラグインマーケットプレイス | npxワンライナー | git clone | > **ランタイムの幅について：** GSDは14ランタイムをサポートしています。私たちは7つを深くサポートします——すべてのプラットフォームにフルエージェントハーネス、スキル発見、ライフサイクルフックを備えています。幅 vs 深さ：あなたの選択です。 --- ## ⚡ 何が違うのか

🔒

ステップロック型ツール制限

エージェントはリサーチ中に文字通りコードを書くことができません。RESEARCHはリードオンリー、INNOVATEはWriteなし、PLAN/VALIDATEはprocess/のみ書き込み可能。実際の能力制限であり、単なる提案ではありません。

🎯

リードエージェントはコードに触れない

コーディネーターはルーティング、監視、ループ駆動を行います——ソースファイルの編集もテストの実行も自分では行いません。すべての編集とテスト実行は専用のサブエージェント内で行われます。隠れた作業はありません。

🔍

自動スキル発見

リクエストを処理する前に33のスキルをスキャンしてキーワードをマッチング。「add webhook support」と言えば`vc-security`＋`vc-scenario`が自動的にサーフェスされます。

💾

セッションリセットを生き延びる

プラン、レポート、ナレッジドキュメント、学びはすべてディスクに保存。スタートアップフックがセッションリセット後に承認ゲートを復元します。何も失われません。

🛡️

自己監視型ステップガード

エージェントが必須ステップをスキップしようとすると、自ら止まります：「PHASE JUMPING PREVENTED」。ショートカットへの組み込みガードです。

🔄

7つのAIコーディングツールで動作

2つのオープン標準——AGENTS.mdとSKILL.md——により、アダプターもプラグインもゼロ。Claude Codeで始めて、Cursorに切り替え、Codexで続行。
--- ## 🧭 仕組み：コーディネーター メインセッションは**コーディネーター**（オーケストレーターとも呼ばれます）であり、ワーカーではありません。4つのことのみを行います： ``` Your request → Step 0: Skill Discovery (scan 33 skills, match keywords, attach candidates) → Detect intent (feature / bug / question / refactor / UI) + score ambiguity → Route to the right agent in a fresh context window → Monitor: step compliance, status codes, loop driving ```

🧑‍✈️

委任するが、実装しない

Research → vc-research-agent。Plan → vc-plan-agent。Code → vc-execute-agent。コーディネーターは適切なコンテキストを渡して待ちます——実際の作業は自分では行いません。

🚫

隠れた実行は一切なし

合意済みチェックリスト付きのプランが存在する瞬間、「ENTER EXECUTE MODE」は常にvc-execute-agentを起動します。1行の修正でもそれを経由します。テストは専用のvc-tester内でのみ実行されます。変更の大きさにかかわらず同様です。

📨

明確なステータスコード、曖昧なシグナルではない

すべてのサブエージェントは次のいずれかで終わります：DONE · DONE_WITH_CONCERNS · BLOCKED · NEEDS_CONTEXT。コーディネーターはブロッカーを無視せず、同じブロックされたアプローチを3回繰り返しません。

🔁

修正ループを駆動する

サブエージェントは1回実行して結果を報告して止まります。コーディネーターのみが再起動します。PVL（プラン確認修正）とEVL（テスト確認修正）の両ループを駆動し、すべてのトラッキングを所有します。
```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD REQ["User request"] SD["Step 0: Skill Discovery\nscan 33 skills, match keywords"] INT{"Detect intent\n+ score ambiguity"} RES["vc-research-agent\n(feature / question)"] PLN["vc-plan-agent\n(after INNOVATE)"] VAL["vc-validate-agent\n(PVL loop)"] EXE["vc-execute-agent\n(EXECUTE)"] TST["vc-tester\n(EVL loop)"] UPD["vc-update-process-agent\n(closeout)"] MON["Monitor\nstatus codes · loop driving\nno inline execution ever"] REQ --> SD --> INT INT -->|"feature / research"| RES INT -->|"plan phase"| PLN INT -->|"validate phase"| VAL INT -->|"execute phase"| EXE EXE -.->|"EVL"| TST INT -->|"update phase"| UPD RES --> MON PLN --> MON VAL --> MON TST --> MON UPD --> MON style REQ fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style SD fill:#0277BD,stroke:#01579B,color:#FFFFFF style INT fill:#E65100,stroke:#BF360C,color:#FFFFFF style RES fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style PLN fill:#558B2F,stroke:#33691E,color:#FFFFFF style VAL fill:#558B2F,stroke:#33691E,color:#FFFFFF style EXE fill:#C62828,stroke:#B71C1C,color:#FFFFFF style TST fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style UPD fill:#00695C,stroke:#004D40,color:#FFFFFF style MON fill:#37474F,stroke:#263238,color:#FFFFFF ``` > **なぜこれが重要か：** 決定も秘密の編集もできるエージェントはプランをスキップする方法を見つけます。コーディネーターとワーカー（サブエージェント）を分離することで、プロセスが構造的に正直になります——コードを書く唯一の方法は必須ステップを経由することです。 --- ## 📊 RIPER-5ライフサイクル | フェーズ | 何が起きるか | エージェント | あなたが言うこと | |-------|-------------|-------|---------| | 🔍 **RESEARCH** | リードオンリーのファクト収集——コードベース＋Web。ファイルを変更しません。 | `vc-research-agent` | *（機能リクエスト時に自動）* | | 📝 **SPEC** | プロダクトディスカバリー要件ドキュメント——ユーザーストーリー、受け入れ基準、スコープ外——**設計前にあなたがレビュー**。 | `vc-spec-agent` | `go` / `ENTER SPEC MODE` | | 💡 **INNOVATE** | トレードオフ付きで2〜3のアプローチを探索。意思決定サマリー（選択・却下・理由）。 | `vc-innovate-agent` | `go` | | 📋 **PLAN** | 詳細スペックを作成：タッチポイント、パブリックコントラクト、触れるファイル、検証エビデンス、再開ハンドオフ。 | `vc-plan-agent` | `go` | | ✅ **VALIDATE** | プランを合意済みチェックリストに変換（V1〜V7チェックポイント）。判定：**PASS / CONDITIONAL / BLOCKED**。PVLループを実行。 | `vc-validate-agent` | `ENTER VALIDATE MODE` | | ⚡ **EXECUTE** | プラン*通りに*実装。フェーズレポートへの進捗ノート、逸脱プロトコル、セルフレビュー。その後EVLループがチェックポイントを再実行。 | `vc-execute-agent` | `ENTER EXECUTE MODE` | | 🧠 **UPDATE PROCESS** | 学びをキャプチャ、コンテキスト更新、プランアーカイブ、クローズアウトパケット作成。 | `vc-update-process-agent` | *（重要な作業の後に推奨）* | > 📝 **SPECが独自フェーズである理由：** ほとんどのハーネスは「理解」から「設計」へ直接ジャンプします。プロダクトディスカバリーSPECステップを挿入することで、エージェントが**どのように**作るかを議論する*前*に、*あなた*（またはPM）が**何を**作るかを——シンプルなユーザーストーリーと受け入れ基準で——承認できます。誤解をキャッチする最も安価な場所です。（フェーズプログラムのインナーループでは、SPECはスキップされます——アンブレラSPECが全フェーズを管轄します。） > > **SPECは測定基準です。** 1分でスキャンできるシンプルな言葉で期待される動作を示します。その後のすべてのフェーズ——Innovate、Plan、Validate、Execute——が照らし合わせて同じ質問をします：*作っているものは本当に求められているものか？* 作業がずれ始めたとき、SPECがそれを検出します。 ```mermaid flowchart TD U["You: what I really want
(plain words)"] --> S["📝 SPEC
expected behavior + acceptance
criteria — you approve"] S --> I["💡 INNOVATE"] S --> P["📋 PLAN"] S --> V["✅ VALIDATE"] S --> E["⚡ EXECUTE"] I -.->|"check back"| Q{"Is this what
you asked for?"} P -.->|"check back"| Q V -.->|"check back"| Q E -.->|"check back"| Q Q -->|yes| GO["keep building"] Q -->|no| S ```
### 💻 セッション例 ``` # 🆕 Feature request You: "add webhook support to the API" → Skill discovery surfaces: vc-scenario, vc-security → research-agent gathers context (read-only, can't touch code) → "go" → spec-agent writes requirements doc → you approve → "go" → innovate-agent compares approaches → decision summary → "go" → plan-agent writes the plan, listing which files it will touch → "ENTER VALIDATE MODE" → validate-agent gates the plan (PVL loop) → Gate: PASS → "ENTER EXECUTE MODE" → execute-agent implements → tester re-runs gates (EVL) → reviewer → git-manager → Closeout packet: what changed, what's verified, recommended next step ``` ``` # 🐛 Bug fix You: "login redirect is broken" → Routes to vc-debugger → gathers evidence FIRST → 2-3 competing hypotheses → Systematically eliminates each → root cause with proof chain → execute-agent implements the fix → EVL re-test → quality pipeline ``` ``` # ⏩ Fast mode You: "ENTER FAST MODE - add rate limiting middleware" → Compressed RESEARCH + SPEC + INNOVATE + PLAN + VALIDATE in one pass → Mandatory safety pause after VALIDATE → you review → "ENTER EXECUTE MODE" ``` ``` # 🤖 Autopilot (hands-free) You: "autopilot full: build a notifications system" → ONE consolidated clarification round → provisional /goal block (standing consent) → Drives the full RIPER-5 sequence autonomously, pausing only on hard stops ``` ``` # 🏗️ Large program You: "build a full testing platform" → Umbrella plan + phase plans in a feature folder → Each phase inner loop: research → innovate → plan → PVL → execute → EVL → update → Progress survives context compaction — durable reports on disk ``` --- ## 🎯 インテント明確化 ルーティング前に、リードエージェントはリクエストの曖昧さを**4つの2値シグナル（0〜4）**でスコアリングし、層を選択します。実際に何をするかが変わる場合のみ質問します。 | 層 | いつ | 動作 | |---|---|---| | **層0** ——サイレント自動ルーティング | スコア0〜1、または「go」/「just do it」と言った、またはプランを再開中 | 即座にルーティング、質問なし | | **層1** ——インラインサマリー | スコア2 | 理解を1行で述べて選択したルートを示してから進む | | **層2** ——質問 | スコア3以上 | ルーティング前に集中した選択式の質問をする | > 🧠 **最大2ラウンド。** 層2の後もまだ不明な場合、最後に1つの平易な質問をして、最も狭い合理的なスコープのリサーチにデフォルトします。明確化を永遠にループしません。RESEARCH後、インテントを再確認します——リサーチが当初の想定と異なることを示した場合は再提示し、確認された場合は再質問せずに進みます。 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD REQ["User request"] SCORE{"ambiguity score\n0–4 binary signals"} AUTO["Auto-skip conditions\n(go / continue / mid-phase\n/ trivial / explicit mode\n/ resuming plan / pure info)"] T0["Tier 0\nsilent auto-route\n(score 0–1 OR auto-skip)"] T1["Tier 1\ninline summary\n(score 2)"] T2["Tier 2\nask focused questions\n(score 3+)"] ROUTE["Route to matching agent\n(research / plan / execute / …)"] STILL{"still unclear\nafter Tier 2?"} FINAL["One final plain question\n(max 2 clarification rounds)"] NARROW["Default: vc-research-agent\nnarrowest reasonable scope"] REQ --> AUTO AUTO -->|"auto-skip matches"| T0 AUTO -->|"no auto-skip"| SCORE SCORE -->|"0–1"| T0 SCORE -->|"2"| T1 SCORE -->|"3+"| T2 T0 --> ROUTE T1 --> ROUTE T2 --> STILL STILL -->|"resolved"| ROUTE STILL -->|"still unclear"| FINAL --> NARROW style REQ fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style AUTO fill:#0277BD,stroke:#01579B,color:#FFFFFF style SCORE fill:#E65100,stroke:#BF360C,color:#FFFFFF style T0 fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style T1 fill:#558B2F,stroke:#33691E,color:#FFFFFF style T2 fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style ROUTE fill:#C62828,stroke:#B71C1C,color:#FFFFFF style STILL fill:#F57F17,stroke:#F9A825,color:#000000 style FINAL fill:#AD1457,stroke:#880E4F,color:#FFFFFF style NARROW fill:#00695C,stroke:#004D40,color:#FFFFFF ``` --- ## ✅ 2つの品質ループ——PVL + EVL ほとんどのハーネスは1回だけ確認します（あっても）。このキットはEXECUTEを**2つの独立したループ**で囲みます——1つはコードを書く前、もう1つは後。 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '15px', 'lineColor': '#8888AA'}} }%% flowchart TD PLAN["📋 PLAN written"] PVL{"✅ PVL\nValidate the plan\nV1–V7 gates"} PASS["Gate: PASS"] SUPP["📝 plan-agent supplements\n(addresses gaps)"] EXEC["⚡ EXECUTE\nimplement the plan"] EVL{"🧪 EVL\ntester re-runs the\nvalidate-contract gates"} FIX["⚡ execute-agent\nsupplement (fix gate)"] DONE["🧠 UPDATE PROCESS"] PLAN --> PVL PVL -->|"CONDITIONAL / BLOCKED"| SUPP SUPP -->|"re-run from V1"| PVL PVL -->|"PASS"| PASS PASS -->|"ENTER EXECUTE"| EXEC EXEC --> EVL EVL -->|"gate fails"| FIX FIX -->|"re-run"| EVL EVL -->|"all gates green"| DONE style PLAN fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style PVL fill:#558B2F,stroke:#33691E,color:#FFFFFF style PASS fill:#00695C,stroke:#004D40,color:#FFFFFF style SUPP fill:#E65100,stroke:#BF360C,color:#FFFFFF style EXEC fill:#C62828,stroke:#B71C1C,color:#FFFFFF style EVL fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style FIX fill:#AD1457,stroke:#880E4F,color:#FFFFFF style DONE fill:#00695C,stroke:#004D40,color:#FFFFFF ```

📋 PVL——Plan-Validate-Fix

EXECUTE前にvc-validate-agentがプランをV1〜V7チェックポイントに通します——インフラ、テストカバレッジ、破壊的変更、セキュリティ、各セクションのフィージビリティをカバーするために複数のエージェントに分割します。初回パスのCONDITIONALまたはBLOCKEDは終わりではありません——vc-plan-agentに戻ってプランを更新し、V1から再確認します。

vc-autoresearch（domain: plan）によって追跡——ギャップ発見・修正ループ。10サイクル上限。プラトー検出。Gate: PASS（または明示的に受け入れたCONDITIONAL）のみがEXECUTEのロックを解除します。

🧪 EVL——Execute-Validate-Fix

EXECUTEが完了を報告した後——すべてのチェックポイントがグリーンと主張している場合でも——リードエージェントは常にvc-testerを起動して、合意済みチェックリストのテストコマンドを独立して再実行します。失敗したチェックポイントはスコープを絞ったvc-execute-agent修正にルーティングされ、その後再テストされます。

vc-autoresearch（domain: tests）によって追跡。10サイクル上限。execute-agent自身の内部「グリーンになるまで繰り返す」ループは、この独立した確認の代替にはなりません。
> 💎 **判定ラダー：** **PASS** → 続行 · **CONDITIONAL** → 修正可能なギャップ；ループが起動（またはあなたが記録上受け入れる） · **BLOCKED** → より深い問題；PLANに戻る（オートパイロット下：ギャップはバックログに入り実行は継続）。 ### 🔁 vc-autoresearch——共有ループエンジン PVLとEVLは同じトラッキングレイヤーを使用します：**`vc-autoresearch`**——ギャップ発見→修正→繰り返しループ。リードエージェントがループを駆動します——ラウンドカウンター、ラウンドごとのレポート、TSVログ、プラトー/上限/リグレッションチェックを所有します。ワーカーエージェントはファイア・アンド・フォーゲット：結果を返して止まります。エージェントが自分自身を再起動したり別のフェーズエージェントを起動したりすることはありません。 同じエンジンを単独でも使えます：「このスペックを強化して」、「すべてのリントを修正して」、「テストカバレッジを改善して」、「これらのドキュメントを改善して」——6つのドメイン（spec · tests · ux · docs · plan · errors）にわたるあらゆる繰り返しギャップ発見・修正タスク。 ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD START["Start loop\n(orchestrator init results.tsv\nheader + baseline row)"] FIND["Find gaps\n(validate-agent / tester\nreturns gap list)"] RPT["Write iteration report\n{slug}-iteration-{NNN}_REPORT_{dd-mm-yy}.md"] TSV["Append results.tsv row\n(cycle N, gap count)"] FIX["Fix gaps\n(plan-agent supplement\nOR execute-agent supplement)"] CHK["Guard checks\nplateau? cap hit? regression?"] RECHECK["Re-check\n(re-run validate / tester)"] SUCC["SUCCESS\nall-clear 2 consecutive rounds"] HALT["HALT\nplateau / 10-cycle cap / regression"] START --> FIND --> RPT --> TSV --> FIX --> CHK CHK -->|"safe to continue"| RECHECK RECHECK --> FIND CHK -->|"plateau / cap / regression"| HALT FIND -->|"no gaps found (×2)"| SUCC style START fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style FIND fill:#E65100,stroke:#BF360C,color:#FFFFFF style RPT fill:#558B2F,stroke:#33691E,color:#FFFFFF style TSV fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style FIX fill:#C62828,stroke:#B71C1C,color:#FFFFFF style CHK fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style RECHECK fill:#0277BD,stroke:#01579B,color:#FFFFFF style SUCC fill:#00695C,stroke:#004D40,color:#FFFFFF style HALT fill:#B71C1C,stroke:#7F0000,color:#FFFFFF ``` | モード | 何をするか | いつ停止するか | |---|---|---| | `vc-autoresearch`（コア） | ギャップ発見→修正→繰り返し | ギャップなし または メトリクスゴール達成 | | `vc-autoresearch:probe` | 8ペルソナがコーパスを飽和まで尋問 | 3ラウンド新しい制約なし | | `vc-autoresearch:reason` | ブラインドジャッジとの敵対的ディベート | ジャッジ収束または繰り返し上限 | | `vc-autoresearch:evals` | TSV結果を分析——トレンド、プラトー、推奨事項 | 分析のみ | **停止条件：** SUCCESS（2ラウンド連続オールクリア）· HALT_PLATEAU（3ラウンド進捗なし）· HALT_CAP（10ラウンドのハードリミット）· HALT_REGRESSION（以前パスしていたチェックが失敗）。 --- ## 👥 戦略比較＋モデルポリシー **すべてのフェーズ遷移時**に、リードエージェントは`vc-agent-strategy-compare`を呼び出して、コスト見積もり付きで次のフェーズの実行方法を推奨します。 | 戦略 | いつ | 調整 | |---|---|---| | **Sequential** | 作業が前の出力に依存する場合 | 1度に1エージェント | | **Parallel subagents** | 独立した次元、ファイア・アンド・フォーゲット | なし——リードエージェントが結果を収集・統合 | | **Workflow** | リストにわたる作業の予測可能な分割 | スクリプト化されたステップ | | **Agent team** | エージェントが実行中に互いに話す必要がある場合（例：3つ以上のフェーズプランにわたってそれぞれ別のファイルを担当する） | TeamCreate＋共有タスクリスト＋SendMessage | ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD SS["vc-agent-strategy-compare\n(every phase transition)"] SC{"signal score\n0–7"} SEQ["Sequential\none agent at a time\n(output feeds next)"] PAR["Parallel subagents\nfire-and-forget\n(independent dimensions)"] WF["Workflow\nscripted steps\nacross a list"] TEAM["Agent team\nTeamCreate + TaskCreate\n+ SendMessage\n(must coordinate mid-run)"] MC{"which phase?"} OPUS["🔴 opus\n(EXECUTE only)"] SONNET["🔵 sonnet\n(every other phase)"] SS --> SC SC -->|"low / dependent"| SEQ SC -->|"mid / independent"| PAR SC -->|"predictable split"| WF SC -->|"high / must coordinate\nor 3+ phase plans"| TEAM SS --> MC MC -->|"EXECUTE / fast-mode\nquick-fix (real code)"| OPUS MC -->|"Research / Spec\nInnovate / Plan\nValidate / Update\nall reviewers"| SONNET style SS fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style SC fill:#E65100,stroke:#BF360C,color:#FFFFFF style SEQ fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style PAR fill:#558B2F,stroke:#33691E,color:#FFFFFF style WF fill:#00695C,stroke:#004D40,color:#FFFFFF style TEAM fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style MC fill:#0277BD,stroke:#01579B,color:#FFFFFF style OPUS fill:#C62828,stroke:#B71C1C,color:#FFFFFF style SONNET fill:#37474F,stroke:#263238,color:#FFFFFF ``` > ⚠️ **「エージェントチーム」は本物の機構を意味します**——名前付きのチームメイト、共有タスクリスト、エージェント間メッセージング——単に「チーム」と呼んだ並列エージェントではありません。3つ以上のフェーズプランの作成と、エージェントがそれぞれ自分のファイルに留まる必要があるマルチファイル編集には**必須**（オプションではない）です。真のチームのみが実行中に通信できます。 ### 🧮 モデル選択ポリシー | フェーズ | モデル | 理由 | |---|---|---| | **EXECUTE**（＋fast-mode、実際のコードを書くquick-fix） | 🔴 **opus** | 実際のソース編集、ビルド、マイグレーション | | Research · Spec · Innovate · Plan · Validate · Update · すべてのレビュアー/リサーチャー | 🔵 **sonnet** | プランニングと分析——安価で十分な能力 | > 作業を複数のエージェントに分割する場合、*コーディング*エージェントのみがopusを使用します。すべてのレビュアー、リサーチャー、バリデーター、プランナーはsonnetを使用します。リードエージェントはワーカーを起動するたびにモデルを明示します。 --- ## 🤖 オートパイロットモード——ハンズフリーRIPER-5 **`autopilot [task]`**（または`run autopilot`、`autonomous mode`、`ENTER AUTOPILOT MODE`）と言えば、エージェントが残りのRIPER-5シーケンス*全体*を最初に**1回**の明確化ラウンドで実行し——完了するまで一時停止しません。 **どこからでもトリガー：** オートパイロットはセッションの開始時*または*途中のどの時点からでも開始できます。トリガー時、リードエージェントはディスクに保存されたファイルを読み取って、すでにどのRIPER-5フェーズにいるかを把握し、そこから引き継いで残りを自律的に進めます。 | ディスク上の状態 | エントリーフェーズ | |---|---| | SPECファイルなし | RESEARCHから開始 | | SPECファイルあり | SPEC後（INNOVATE）にスキップ | | プランファイルあり | PLAN後（VALIDATE）にスキップ | | PASS/CONDITIONAL付きvalidate-contract | EXECUTEにスキップ | ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD TRG["autopilot trigger phrase\n(anywhere in session)"] DISK["Read saved files on disk\ndetect current phase"] CLR["ONE consolidated\nclarification round"] GOAL["Emit provisional /goal block\n(≤4000 chars, copy-pasteable\nstanding EXECUTE consent)"] ACT["AUTOPILOT_ACTIVATED\nautonomous run begins"] PHASES["Drive remaining phases\nRESEARCH → … → UPDATE PROCESS\n(no user pauses)"] HS1["🛑 Irreversible / outward action\nnot pre-approved"] HS2["⛔ Cascade BLOCKED\n(several phases stuck)"] HS3["💸 Live-provider billed probe\n(double opt-in required)"] DONE["Run complete\nautopilot deactivates"] TRG --> DISK --> CLR --> GOAL --> ACT --> PHASES PHASES -->|"hard stop 1"| HS1 PHASES -->|"hard stop 2"| HS2 PHASES -->|"hard stop 3"| HS3 PHASES -->|"all phases done"| DONE style TRG fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style DISK fill:#0277BD,stroke:#01579B,color:#FFFFFF style CLR fill:#E65100,stroke:#BF360C,color:#FFFFFF style GOAL fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style ACT fill:#558B2F,stroke:#33691E,color:#FFFFFF style PHASES fill:#C62828,stroke:#B71C1C,color:#FFFFFF style HS1 fill:#B71C1C,stroke:#7F0000,color:#FFFFFF style HS2 fill:#B71C1C,stroke:#7F0000,color:#FFFFFF style HS3 fill:#B71C1C,stroke:#7F0000,color:#FFFFFF style DONE fill:#00695C,stroke:#004D40,color:#FFFFFF ``` ``` You: "autopilot full: add team invitations with email + role management" → Reads saved files → detects current phase → enters there → ONE consolidated clarification round (scope, hard stops, autonomy boundaries, first-phase strategy) → Provisional /goal block emitted (≤4000 chars, copy-pasteable, standing EXECUTE consent) → AUTOPILOT_ACTIVATED → drives remaining phases on its own → Stops ONLY for hard stops ``` ### 3つのレーン——リスクに合わせた手順 | レーン | トリガー | フロー | |---|---|---| | 🟢 **quick** | `autopilot quick: [task]` | スカウト→編集→スコープ内チェック。プランなし、コントラクトなし、EVLなし。 | | 🟡 **fast** | `autopilot fast: [task]` | 圧縮R→S→I→P→V→EXECUTE＋EVL。 | | 🔴 **full** | `autopilot [task]` / `autopilot full:` | 完全なRIPER-5（デフォルト）。 | ### 🌙 ハンズフリー：1フレーズで、寝ている間に構築 `autopilot full: [task]`と言う——または`/goal`ブロックを貼り付ける——と、次のすべてが**ゼロの人間入力**で起こります： - **プランチェック・修正ループ**——プランのギャップを見つけ、修正し、再確認。自力で最大10ラウンド。 - **ビルド・テスト・修正ループ**——コードを書き、テストを実行し、失敗を修正し、再実行。自力で最大10ラウンド。自分の「オールグリーン」を信頼しません——別のチェッカー（vc-tester）がすべてのテストを独立して再実行して確認します。 - **フェーズ間の自動進行**——リサーチからプラン、コード、完了まであなたを待たずに進みます。 - **メモリリセット後も再開**——プラン、レポート、進捗はすべてディスク上のファイルとして保存されています。コンパクション後（AIの短期記憶がクリアされた後）、次のセッションがそれらのファイルを読み込んで、中断した正確な場所から続行します。 - **詰まった機能を脇に置いて続行**——1つのフェーズが解決できない場合、エージェントはバックログノートを書いて次の機能に進みます。1つのブロッカーがすべてを止めることなく、複数の機能を並行して実行できます。 - **並列機能のエージェントチーム**——複数のエージェントが同時に別々の機能を構築でき、それぞれが自分のファイルにロックされているので衝突しません。詰まった機能は停車されますが、残りのブロッカーにはなりません。 ### ハードストップは常にサーフェスされます（オートパイロット中でも） **止まってあなたに尋ねる唯一の3回：** - 🛑 取り消せないもの、または事前承認なしに外の世界に達するもの（本番公開、実際のメッセージ送信、課金） - ⛔ 複数のフェーズが連続して行き詰まり進捗なし——本物の行き詰まりで目を向ける価値がある - 💸 有料の外部サービスに実際のお金を使うテスト——実行前に確認を求めます --- ### 🎯 /goal——自律実行トークン **必須、飾りではありません：** すべてのVALIDATEフェーズが完了した後、リードエージェントはEXECUTE開始前にコピペ可能な`/goal`ブロックを*必ず*出力しなければなりません。これは必須のハンドオフファイルです——オプションのコメントではありません。 **フォーマット制約：** | ブロックタイプ | 必須フィールド | ハードリミット | |---|---|---| | VALIDATE後ブロック | SESSION GOAL · Charter+umbrella plan · Autonomy · Hard stop conditions · Next phase · Validate contract · Execute start | ≤ 4000 chars | | プロビジョナル（オートパイロット）ブロック | SESSION GOAL · ENTRY PHASE · REMAINING PHASES · CLARIFICATIONS LOCKED · EXECUTE CONSENT · DECISION POLICY · HARD STOPS · TEST GATES · START（＋オプションLANE） | ≤ 4000 chars | `/goal`コマンドは4000文字を超えるブロックを拒否します。短く保ちましょう——必須フィールドを構造として使い、散文のエッセイにしないでください。 **スタンドアロン /goal モード：** 新しいセッションに`/goal`ブロックを貼り付けると、`START`に名前付きのフェーズから実行が再開されます。明確化と決定ルールはすでに設定されています——新しい明確化ラウンドはありません。スタンディング`/goal`下では、エージェントはすべての可逆的なステップで自律的に決定し、BLOCKEDアイテムをバックログに送り、自分でレポートを書きます——しかし**ワーカーエージェントの委任は必須のまま**です。オートパイロットが削除するのは*承認一時停止*のみで、インライン実行禁止ルールは削除しません。 `validate-autopilot-goal-block.mjs`で検証されます。 --- ## 🔬 フィージビリティプローブ＋バリデーターセーフティネット ### 🔬 フィージビリティプローブ——構築前に前提をテストする SPEC、INNOVATE、またはVALIDATEが読み取りだけでは確認できない重要な前提に当たったとき、`VC-FEASIBILITY-PROBE-NEEDED`を出力して停止します。リードエージェントが`vc-debugger`を起動して実際のテストを実行し、**VERDICT**を書き込みます： | 判定 | 意味 | |---|---| | ✅ **VIABLE** | 前提が成立——設計はこれに依拠できる | | ❌ **NOT-VIABLE** | 前提が誤り——そのアプローチは禁止 | | ❓ **INCONCLUSIVE** | 証明できなかった——既知のギャップとして繰り越し | 各判定には3部構成の設計ノートが付きます：**結果が許可するもの · 禁止するもの · まだ不確かなもの**——一字一句そのまま一時停止したフェーズに戻されます。プローブは**コストクラス分け**されています（`cheap-local` / `needs-container` / `needs-live-provider` → ダブルオプトイン / `needs-browser` / `needs-cf`）ので、有料または共有リソースのプローブが無音で実行されることはありません。 ### 🛡️ 36バリデーター——機械的な正確性、意見ではない このキットには**36のバリデータースクリプト**が付属し、「エージェントはルールに従ったか？」を明確なパス/フェイル結果に変えます。ハーネスファイルに触れるあらゆるフェーズの後、およびUPDATE PROCESSの必須チェックポイントとして実行されます： | バリデーターファミリー | チェック内容 | |---|---| | `vc-audit-vc` | エージェントパリティ（Claude/Codex）、スキルレジストリ、キットポータビリティ、エージェントフロントマター | | `vc-audit-context` | コンテキストルーティング、発見フロントマター、スキルキーワード | | `vc-audit-plans` | プラン目録、アンブレラ状態、フェーズ完全性、フェーズレポート、バックログノート | | 14のVC-systemビヘイビアーバリデーター | 各々パス/フェイルフィクスチャペアを所有——戦略比較出力、クローズアウト、インテント明確化、フィージビリティ判定、autoresearchログなど | --- ## 🛡️ 組み込みセーフティシステム これらはガイドラインではありません——すべてのエージェントに組み込まれた**ハードルール**です。

📝

実行中断なしの進捗ノート

コーディング中、エージェントは作業しながらフェーズレポートファイルに進捗ノートを書きます。実行中断なし、「続行か戻るか？」プロンプトなし。プラン変更が必要な問題に当たったら、停止してPLANに戻ります。それ以外は続行します。

🚫

黙って逸脱しない

コーディングでプラン変更が必要な問題に当たったら、エージェントは即座に停止して説明し、PLANに戻ります。黙ったアドリブはありません。

🔐

プライバシーガードレールフック

エージェントは明示的な承認なしに.env、クレデンシャル、SSHキー、.pemファイルの読み取りをブロックされます。

⚠️

ハイリスクエビデンスパック

認証、課金、スキーママイグレーション、パブリックAPI変更では、作業を「完了」と呼ぶ前に正式な5ファイルエビデンスパックが必要です——常に手動で、自動バイパスは絶対にありません。

📨

ステータスコードの規律

ワーカーエージェントはDONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXTのいずれかで終了しなければなりません。ブロッカーは無視されず、正確性に関する懸念はアクションアイテムになります。

📊

クローズアウト＋ドリフトスコアリング

コーディング後、クローズアウトパケットが緊急度をスコアリングします：LOW（軽いタッチ）→ MEDIUM（重大）→ HIGH（ハーネス/プロトコルファイルに触れた）、そして次の安全なステップを推奨します。
--- ## 🔍 実装前インテリジェンス コードを1行も書く前に、3つの専門スキルが問題をキャッチできます：

🎭

5ペルソナディベート——vc-predict

アーキテクト、セキュリティ、パフォーマンス、UX、デビルズアドボケイトがあなたのプランをディベートします。1行書く前にGO / CAUTION / STOPの判定を出します。

🎲

12次元エッジケース——vc-scenario

機能を12次元で分解します（ユーザータイプ、入力の極端値、タイミング、スケール、状態、環境、エラー、認証、データ、インテグレーション、コンプライアンス、ビジネスロジック）。出力はそのままテストスペックとして使用可能。

🔐

STRIDE + OWASPセキュリティ監査——vc-security

デュアルメソドロジーのセキュリティ監査。依存関係監査、シークレット検出、重大度順にソートしてCriticalから修正する自動修正モード付き（リグレッションガード付き）。

🔬

エビデンスファーストデバッグ——vc-debugger

証拠を収集→2〜3の対立仮説を立てる→各仮説をテストする→除外パスをドキュメント化。推測しない——証明します。
--- ## ✅ 品質パイプライン——実行に組み込み済み **テスト優先、その後コード。** 合意済みチェックリスト（コードに触れる前に作成）が通過しなければならない正確なテストを定義します。execute-agentはそれらのテストがグリーンになるまでコードを書きます。その後、別のチェッカー——`vc-tester`——がすべてのテストを独立して再実行して確認します。execute-agent自身の「オールグリーン」は額面通りに受け取られません。最後に、レビュアーが新しい部分だけでなく、プロジェクト全体がまだ一緒に動作することを確認します。 execute-agentはコードを書いて終わりではありません。**品質パイプライン**を自動的に経由します：
```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '16px', 'lineColor': '#8888AA'}} }%% flowchart TD E["⚡ Execute-Agent\nImplements the plan"] SR["🔎 Self-Review\nLine-by-line check\nagainst plan"] T["🧪 Tester (EVL)\nDiff-aware — re-runs\nthe contract gates"] CR["🔍 Code Reviewer\nEdge case scout\n+ adversarial review"] CS["✨ Code Simplifier\nClarity refactoring"] GM["📦 Git Manager\nLogical commit splitting\nfrom touched_files"] E --> SR --> T --> CR --> CS --> GM style E fill:#C62828,stroke:#B71C1C,color:#FFFFFF style SR fill:#AD1457,stroke:#880E4F,color:#FFFFFF style T fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style CR fill:#283593,stroke:#1A237E,color:#FFFFFF style CS fill:#00695C,stroke:#004D40,color:#FFFFFF style GM fill:#37474F,stroke:#263238,color:#FFFFFF ``` | ステップ | 何をするか | |---|---| | 🔎 **セルフレビュー** | プランに対してすべてのチェックリスト項目を確認し、逸脱を記録 | | 🧪 **テスター（EVL）** | 合意済みチェックリストのテストを独立して再実行；変更ファイル→テストファイルにマッピング、70%以上マッピング時はフルスイートにエスカレーション | | 🔍 **コードレビュアー** | レビュー前にエッジケーススカウトを送る；N+1クエリ、認証パス、データリークを確認 | | ✨ **シンプリファイアー** | レビュー後にわかりやすさのためにコードを整理——動作変更なし | | 📦 **Gitマネージャー** | `touched_files`を受け取り、論理的なconventional commitsに分割し、不明なファイルを拒否 | --- ## 📋 プランライフサイクル すべての重要な機能は**プランライフサイクル**に従います——作成され、レビューされ、その通りに構築され、永続的なプロジェクト履歴としてアーカイブされる成文化されたスペック。
```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '16px', 'lineColor': '#8888AA'}} }%% flowchart TD A["🆕 Feature Request"] B["📝 Plan Created\nin active/{slug}_{date}/"] C{"👀 User Reviews\nthe Plan"} D["✅ VALIDATE\n(PVL gates)"] E["⚡ Execute + EVL"] F["📦 Plan Archived\nto completed/"] G["🧠 Learnings →\nall-context.md"] H["🔄 Next Feature\nStarts Smarter"] A --> B --> C C -->|"✏️ Needs Changes"| B C -->|"✅ Approved"| D --> E --> F --> G --> H H -.->|"context compounds"| A style A fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style B fill:#E65100,stroke:#BF360C,color:#FFFFFF style C fill:#F57F17,stroke:#F9A825,color:#000000 style D fill:#558B2F,stroke:#33691E,color:#FFFFFF style E fill:#C62828,stroke:#B71C1C,color:#FFFFFF style F fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style G fill:#00695C,stroke:#004D40,color:#FFFFFF style H fill:#1565C0,stroke:#0D47A1,color:#FFFFFF ``` > 💡 6ヶ月後に誰かが*「なんでこの認証方式にしたんだっけ？」*と聞いた時、答えは`completed/`にあります。Slackのスレッドに埋もれてはいません。 **プランの保存場所——タスクフォルダー規約：** ``` process/ ├── general-plans/ │ ├── active/ │ │ └── webhooks_28-05-26/ # 📋 タスクフォルダー：プラン＋コロケートされたレポート/refs │ │ └── webhooks_PLAN_28-05-26.md │ ├── completed/ # ✅ アーカイブ済み（検索可能な履歴） │ └── backlog/ # 📌 延期された作業 └── features/ └── billing/ # 🏷️ フィーチャースコープ（5以上のアーティファクト） ├── active/{slug}_{date}/ ├── completed/ └── backlog/ ``` ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD PC["vc-plan-agent creates task folder\nprocess/general-plans/active/{slug}_{date}/\nOR features/{feature}/active/{slug}_{date}/"] PLAN["{slug}_PLAN_{dd-mm-yy}.md\n— plan file\n— Validate Contract appended here"] REF["{slug}_REF_{dd-mm-yy}.md\n— optional references"] RPT["{slug}-iteration-{NNN}_REPORT_{dd-mm-yy}.md\n— per PVL/EVL cycle report"] TSV["results.tsv\n— rolling loop log\n(header + baseline + cycle rows)"] PP["PHASE PROGRAM extras"] UMB["umbrella_PLAN_{dd-mm-yy}.md\n— Program Goal Charter\n— /goal block"] PHN["phase-N_PLAN_{dd-mm-yy}.md\n— one file per phase"] REG["phase-blast-radius-registry.md\n— per-phase file ownership"] PC --> PLAN PC --> REF PC --> RPT PC --> TSV PC --> PP PP --> UMB PP --> PHN PP --> REG style PC fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style PLAN fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style REF fill:#558B2F,stroke:#33691E,color:#FFFFFF style RPT fill:#E65100,stroke:#BF360C,color:#FFFFFF style TSV fill:#C62828,stroke:#B71C1C,color:#FFFFFF style PP fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style UMB fill:#00695C,stroke:#004D40,color:#FFFFFF style PHN fill:#00695C,stroke:#004D40,color:#FFFFFF style REG fill:#37474F,stroke:#263238,color:#FFFFFF ``` > すべてのプランには次が含まれます：📍 **タッチポイント**（作成・変更されるファイル）· 📜 **パブリックコントラクト** · 💥 **触れるファイル**（何が壊れる可能性があるか、何をテストするか）· ✅ **検証エビデンス** · 🔄 **再開ハンドオフ**。`vc-plan-discovery`が再開する適切なプランを見つけ、`post-write-plan-check`フックがすべてのプラン書き込み時にプラン構造を確認します。 --- ## 🏗️ フェーズプログラム——崩壊しない大規模プロジェクト 通常の機能は1つのプランを使います。**大規模なマルチフェーズプロジェクト**はフェーズプログラムを使います——アンブレラプランとフェーズごとのプラン、それぞれ独自のチェックポイントと保存されたレポートを持つ**7ステップのインナーループ**全体を実行します。
```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD UP["🎯 Umbrella Plan\nProgram Goal Charter\n(north star · done · scope tiers)"] P1["📋 Phase 1"] P2["📋 Phase 2 ..."] subgraph LOOP["🔁 Per-phase inner loop (skips SPEC)"] direction TB R["🔍 Research"] I["💡 Innovate"] PL["📋 Plan-supplement"] PVL["✅ PVL"] EX["⚡ Execute"] EVL["🧪 EVL"] UPD["🧠 Update"] R --> I --> PL --> PVL --> EX --> EVL --> UPD end UP --> P1 --> LOOP LOOP -.->|"learnings feed\nnext phase"| P2 style UP fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style P1 fill:#E65100,stroke:#BF360C,color:#FFFFFF style P2 fill:#E65100,stroke:#BF360C,color:#FFFFFF style R fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style I fill:#E65100,stroke:#BF360C,color:#FFFFFF style PL fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style PVL fill:#558B2F,stroke:#33691E,color:#FFFFFF style EX fill:#C62828,stroke:#B71C1C,color:#FFFFFF style EVL fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style UPD fill:#00695C,stroke:#004D40,color:#FFFFFF ``` | | 機能 | なぜ重要か | |---|---|---| | 🔄 | **フェーズごとに再リサーチ** | コードドリフトを確認し、最新レポートを読み、前提を更新 | | ✅ | **フェーズごとのチェックポイント** | エビデンスが証明するまでフェーズは完了しません。正直なステータス：`PLANNED → CODE DONE → TESTING → VERIFIED`または`BLOCKED` | | 📄 | **保存されたレポート** | 各フェーズがディスクに結果を書き込みます——進捗はメモリリセットを生き延びます | | 🧠 | **学びが前進する** | フェーズ1の発見がコーディング開始前にフェーズ2のプランを更新 | | 🏗️ | **基盤 vs 拡張** | 「アーキテクチャを証明する」と「すべてを実装する」を明示的に分離 | | 🚧 | **正直なブロッカー処理** | 詰まったフェーズはエビデンス付きで`BLOCKED`のまま。グリーンステータスを偽らない |
### 🔀 学びながらプログラムが自己再構成する 最初に書いたプランは粗削りな地図であり、固定のコントラクトではありません。プログラムが実行されるにつれ、調整します——すべてのステップを事前に予測する必要はありません。 **実行の途中に新しいフェーズを追加できます。** 作業中、エージェントが欠けているステップを発見することがあります——次のフェーズが進む前に行わなければならないこと。その場合、そこに新しいフェーズを挿入し、残りの番号を付け直して続行します。人間の介入は不要です。（内部シグナル：`MID_PROGRAM_PLAN_CREATED`——新しいプランがディスクに書き込まれ、自動的にレジストリに追加されます。） **フェーズを並べ替えることができます。** リサーチで計画した順序が間違っていることが判明する場合があります——例えば、フェーズ3がフェーズ4が生成するものに依存している場合など。エージェントは残りのフェーズを並べ替えて理由を記録します。（内部シグナル：`PHASE_RESTRUCTURE_NOTICE`——監査証跡としてフェーズレポートに保存され、ブロッカーにはなりません。） **各フェーズのプランをコーディング直前に更新します。** フェーズのコーディングが始まる前に、クイックリサーチパスがプログラムがこれまでに学んだことを確認します。その後、そのフェーズのチェックリストを新しい発見で更新します。これは**プランサプリメント**ステップと呼ばれます。プランは固定されません——前のフェーズからの新しい事実を吸収します。 **まだ開始できない作業をスキップします。** フェーズがまだ準備できていないものに依存している場合——まだ構築されていないサービス、まだ決定されていない決定——エージェントそのフェーズを依存関係ブロックとしてマークし、脇に置いて次に進みます。1つのフェーズが待っているためにプログラム全体が止まることはありません。 **いつ停止して質問すべきかを知っています。** 詰まった1つのフェーズはバックログに入れられてプログラムが続行します。しかし複数のフェーズが連続して壁にぶつかり進捗がない場合、エージェントはそれを本物の行き詰まり——**カスケードストップ**——として扱い、何が起きたかを示して一時停止します。1つの詰まったフェーズは正常です。連続して複数が詰まると構造的な問題を示します。 **ライブスコアボードを維持します。** すべてのプログラムには、アンブレラプランに1ページのステータスセクションがあり、どのフェーズが現在進行中か、完了しているか、レポートがどこにあるかを示します。誰でも——またはメモリリセット後のエージェント自身でも——読んでどこにいるかを正確に把握できます。また、同時に作業している2つのフェーズが同じファイルを編集しないようにシンプルなファイルレジストリも維持します。 **最後に1つの大きな最終チェック。** プログラム全体の終わりに、エージェントがプロジェクト全体がまだ一緒に動作するエンドツーエンドテストを実行します——各部品が単独でではなく。個々のフェーズチェックポイントが各部品が動作することを証明し、この最終チェックが部品が全体として動作することを証明します。 --- ### 🧠 場所を失わない（メモリリセットを生き延びる） 長い仕事は正確に完了します——AIのメモリが途中でリセットされても。プラン、進捗、証拠はすべてディスク上のファイルに保存され、エージェントの頭の中だけにあるわけではありません。 AIエージェントには限られたワーキングメモリがあります。長い仕事ではそのメモリが埋まり圧縮されます——詳細がぼやけることがあります。新しいセッションが始まったとき（またはメモリがクリアされたとき）、エージェントはどこで止まったかを推測しません。ファイルを読みます。 正確にこう動作します： **1. フェーズごとに短いレポートを書きます。** フェーズが完了したら、レポートファイルがディスクに書き込まれます。進捗はエージェントの頭の中だけでなく、プロジェクトフォルダーに保存されます。メモリ圧縮でファイルは消えません。 **2. どのステップが完了したかのチェックリストを維持します。** 各フェーズプランには**Phase Loop Progress**リスト——すべてのステップ（リサーチ、プランチェック、ビルド、テスト、学びのキャプチャ）のチェックボックスがあります。リセット後、エージェントはそれらのボックスを読んで正確な次のステップを把握します。追いつかせる必要はありません。 **3. 各フェーズの開始時に短い「エンベロープ」。** すべてのワーカーエージェント（作業の1フェーズを担う集中したヘルパー）は**Context Envelope**——10フィールドのノート：どの機能、どのフェーズ、どのブランチ、どのプランファイル、どのテストを実行するか——を出力することから始めます。読むのに数秒かかります。エージェントは何かする前に準備完了です。 **4. 自分のメモリよりファイルを信頼します。** 再開時、エージェントはコードとgit履歴に実際に何があるかをプランが言うことと照合します。実際の状態が勝ちます。古くなったプランはエージェントを誤って作業を繰り返させたりステップをスキップさせたりすることができません。 **5. 実行中のスコアボードとラウンドごとのレポート。** すべての修正ループ（プランチェックループとビルドテストループ）は`results.tsv`スコアボードファイルを維持します——残っている問題数を追跡するラウンドごとの行。セッションがループの途中で終了したとき、次のセッションがカウントを読み、適切なラウンドから再開し、続行します。ラウンドは失われません。 **6. 再開時にリマインダーを再注入します。** メモリが圧縮されたとき、システムは自動的に最新のステータスノートを新しいセッションにリロードします。承認待ちがあった場合——例えば、先に進む前に「はい」が必要なチェックポイント——リマインダーがそれをフラグします。何も黙ってスキップされません。 > 💡 要するに：オートパイロット実行を開始し、ラップトップを閉じて、数時間後に戻ることができます。エージェントはあるべき場所に正確にいるか——または最後に保存されたチェックポイントから再開し、ディスク上の証拠でそれを証明します。 --- ## 🧠 コンテキストグループ プロジェクトの知識は**コンテキストグループ**に整理されます——安定したナレッジエリアで、それぞれにエージェントに何をいつ読むべきかを指示する`all-{group}.md`ルーターファイルがあります。エージェントはルーターに従い、毎回ナレッジベース全体ではなく関連するものだけを読み込みます。
``` process/context/ ├── all-context.md # 🧭 ルートルーター——アーキテクチャ、スタック、パターン、規約 ├── tests/all-tests.md # 🧪 テストランナー、コマンド、デバッグ手順 ├── container/all-container.md # 🐳 Docker、デプロイ、インフラ手順 ├── uxui/all-uxui.md # 🎨 コンポーネント、デザイントークン、パターン ├── infra/all-infra.md # 🖥️ サーバーインフラ、デプロイ └── {your-domain}/all-{domain}.md # 📚 3つ以上の永続ドキュメントがあるドメイン（自動昇格） ``` | | 仕組み | |---|---| | 🧭 **ルーターパターン** | エージェントはタスクに関連するものだけを読む | | 📏 **自動昇格** | 3つ以上のドキュメント（または単一ファイルが大きくなりすぎた場合）を持つトピックが独自のグループを取得 | | 🔄 **常に最新** | 重要な機能ごとに`vc-update-process-agent`によって更新 | | 🧪 **監査可能** | `vc-audit-context`がルーティング、発見フロントマター、一貫性を確認 | | 📨 **Context Envelope** | すべてのインナーループエージェントが開始時に10フィールドのノートを出力（feature → phase → session-goal → branch → worktree → context-group → blast-radius-packages → active-plan → test-runner → validate-contract）し、新しいワーカーエージェントが自分の立場を正確に把握できる | > キットはプロトコルシードのみを提供します——コンテキストグループは`vc-setup`によって**あなたのプロジェクト向けに構築されます**（実際のコードをスキャン）。これらはパターンであり、固定リストではありません。 --- ## 📁 フィーチャーフォルダー トピックが5つ以上のファイルを積み重ねると、独自の**フィーチャーフォルダー**が付与されます——完全なライフサイクルコンテナです。 ``` process/features/{feature}/ ├── active/{slug}_{date}/ # 📋 作業中のプラン（レポート/refsがコロケート） ├── completed/ # ✅ アーカイブ済みプラン（検索可能な意思決定履歴） └── backlog/ # 📌 延期された作業（エージェントが重複作成前にチェック） ``` | | 何が起きるか | |---|---| | 🆕 | 新しい作業は`active/`で開始→レポートが蓄積→プランが`completed/`にアーカイブ | | 📌 | 延期された作業は`backlog/`へ——エージェントは重複プラン作成前にチェック | | 📦 | 一般アーティファクトが5以上に達すると自動的にフィーチャー昇格 | | 🔍 | すべてのフィーチャーに完全で自己完結した履歴——プラン、決定、レポート、リサーチ | --- ## 🧱 スキルレイヤー 33のスキルは3つのレイヤーに分類されます。すべての`SKILL.md`がフロントマターで`layer`と`trigger_keywords`を宣言し、生成されたカタログが発見を高速化します。

🎭

アクターエージェント

フェーズまたはロールを所有します。.claude/agents/に保存——これらは15のエージェントであり、スキルではありません。

📜

コントラクトスキル（20）

それぞれが特定のファイルまたは合意された出力を生成します——vc-generate-plan、vc-validate-findings、vc-autopilot、監査。結果は確認できます。

🛠️

ヘルパースキル（13）

エージェントの*動き方*を改善し、独自のファイルを生成しません——vc-scout、vc-sequential-thinking、vc-problem-solving、vc-docs-seeker。
--- ## 🧠 自己改善型プロジェクトメモリ 完了したすべての機能が学びをコンテキストシステムにフィードバックします——**ナレッジは積み重なり、リセットされません。** AIアシスト型コードベースのほとんどは逆の特性を持ちます：新しいセッションはコールドスタートします。エージェントは同じファイルを再読し、同じパターンを再発見し、同じ決定を再び行います——前のセッションの洞察がチャットウィンドウにしか存在しなかったから。キットの答えはプロンプトのトリックではありません。**永続的なコンテキストファイルシステム**（`process/context/`）——すべてのエージェントがセッション開始時に読み、すべてのバリデーターが保護し、すべての完了した機能が豊かにする——です。 6ヶ月後、多くのメモリリセットを経ても、エージェントは*なぜ*認証がそのように機能するかを知っています——その知識がディスクに、ルーティングされた形で、監査可能な形でオンディスクにあるから、死んだセッションに閉じ込められているのではなく。
```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD FEAT["Feature ships\n(EXECUTE + EVL complete)"] UP["UPDATE PROCESS phase\nvc-update-process-agent"] CTX["process/context/ updated\nsmallest relevant file\n+ all-context.md router"] AGENT["Next agent spawned\nreads context router\n→ routes to correct group file"] BETTER["Better next feature\nno re-discovery, no stale patterns"] FEAT --> UP --> CTX --> AGENT --> BETTER BETTER -.->|"compounds each feature"| FEAT style FEAT fill:#C62828,stroke:#B71C1C,color:#FFFFFF style UP fill:#00695C,stroke:#004D40,color:#FFFFFF style CTX fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style AGENT fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style BETTER fill:#E65100,stroke:#BF360C,color:#FFFFFF ``` ### 核となるメカニズム：ポータブルな共有メモリとしての`process/context/` `process/context/`はトピックグループに整理された構造化されたナレッジを保持します——アーキテクチャの決定、コーディング規約、デプロイ手順、テストパターン、インフラの事実。チャット履歴とは異なり、このナレッジは： - **すべてのワーカーエージェントに伝わります**——`vc-context-discovery`が起動された各エージェントをタスクに適した`all-{group}.md`ルーターに、そして最小の関連するディープファイルにルーティングします。リサーチエージェント、プランエージェント、コーディングエージェントがすべて同じ共有理解でスタートします - **メモリリセットを生き延びます**——コンテキストウィンドウではなくディスクにあります；圧縮されたセッションはそれを失いません - **ClaudeとCodexの両方で読めます**——`.agents/skills`は`.claude/skills/`へのショートカットリンクであり、同じコンテキストシステムが重複なく両方のエージェントに機能します ルートルーター（`all-context.md`）がグループルーター（`all-{group}.md`）を指し、グループルーターが最小の関連するディープファイルにルーティングします。エージェントはルーターに従います——ファイルパスをハードコードしません。これはリネームやグループ分割にルーターの編集のみが必要で、コードベース全体の検索は不要になることを意味します。 ``` process/context/ ├── all-context.md ← ルートルーター（アーキテクチャ、スタック、パターン） ├── tests/all-tests.md ← テストランナー、デバッグ、コマンド ├── container/all-container.md ← Docker、デプロイ、インフラ手順 ├── uxui/all-uxui.md ← コンポーネント、デザイントークン、ビジュアル規約 └── {domain}/all-{domain}.md ← 3つ以上の永続ドキュメントがあるドメイン（自動昇格） ```
### 自己改善する理由（単なる「リビングドキュメント」ではない） 「リビングドキュメント」というフレーズは通常「更新し続けるつもりだが大抵忘れるドキュメント」を意味します。このシステムは意図を機械的に強制します。 **UPDATE PROCESSフェーズは、終了する前にファイルごとのコンテキストレビューを必要とします。** `vc-update-process-agent`は、潜在的に影響を受けるすべてのコンテキストファイルをファイルごとに具体的な理由でレビューするまでフェーズを終了できません。「更新不要」は許可されます——しかしレビューした各ファイルを名前を挙げて理由を説明しなければなりません。曖昧な理由は拒否されます。チェックポイントは二値：レビューを記録するか、フェーズは終了しないかです。 完了した機能ごとのフルフィードバックループ： | ステップ | 所有者 | 何が起きるか | |------|-------|-------------| | 1. git差分分析 | `vc-scout` | 変更されたファイル→影響を受けるコンテキストエリアをマッピング | | 2. ファイルごとのレビュー | `vc-update-process-agent` | 各コンテキストファイルを名前を挙げ、更新または明示的な「変更なし＋理由」を述べる | | 3. 更新の適用 | 並列ワーカーエージェント | 各エリアのコンテキストファイルを新しいパターン、決定、学びで更新 | | 4. ルーティング検証 | `validate-context-discovery.mjs` | すべてのドキュメントがインデックスされ、ルーターが一貫していることを確認 | | 5. 発見確認 | `validate-all-context.mjs` | `all-context.md`とグループルーターがディスク上の現在のファイルと一致することを確認 | 100番目の機能は最初の99で学んだすべてから恩恵を受けます——願望ではなく、機械的な保証として。
### 前進プレビュー：学びは後ろだけでなく前にも伝わる すべてのフェーズレポートには、*次の*フェーズのエージェントのために書かれた`## Forward Preview`セクションがあります。グリーンを維持するための正確なコマンド、依存関係の変更、フェーズ途中に見つかったファイルスコープの変更を提供します。フェーズ3を引き継ぐエージェントはフェーズ2の出力を再読して何が重要かを推測する必要はありません。集中したブリーフが手渡されます。 これはコンテキストドキュメントとは異なります：コンテキストドキュメントは*永続的な*ナレッジ（機能をまたいで真実であり続ける決定）を保持し；Forward Previewは*一時的な*ハンドオフ状態（次の作業セッションが今すぐ知る必要があること）を保持します。
### バリデータースイートが腐敗を防ぐ 永続的なナレッジは誰も確認しないと古くなります。キットはすべてのフェーズクローズアウトの一部として実行されるバリデーターを提供します： | バリデーター | 何を検出するか | |-----------|----------------| | `validate-context-discovery.mjs` | どのルーターにもインデックスされていないドキュメント；壊れたリンク；欠落したフロントマター | | `validate-all-context.mjs` | `all-context.md`がディスク上の実際のファイルと非同期 | | `validate-skill-keywords.mjs` | `trigger_keywords`または`layer`フィールドが欠落しているスキル（ルーティングStep 0を壊す） | | `validate-protocol-discovery.mjs` | `process/development-protocols/`内のプロトコルファイルに発見フロントマターが欠落 | 自動チェックのように実行されます——古いまたは孤立したドキュメントは失敗します。システムは自身の健全性を監視します。
### コンテキストグループは自己整理する グループはトピックが3つ以上のドキュメントに達したとき、または単一のファイルが約800行を超えたときに自動的に作成されます。エージェントはルーターに従いパスをハードコードしません——新しいグループ（例：`process/context/billing/all-billing.md`）を追加するにはルーターの更新のみが必要で、billingに言及するすべてのエージェントへの変更は不要です。ルーターが安定した参照であり；その背後のファイルは自由に再整理できます。 > キットは実際のコードベース（`vc-setup`経由）からコンテキストグループをシードします。グループは固定リストではありません——パターンです。認証エリア、インフラエリア、支払いエリアはそれぞれプロジェクトの成長に合わせてファーストクラスのルーティング可能なナレッジになります。 --- ## 🤖 中身の紹介
### 15エージェント
クリックでエージェントリストを展開
**コアワークフローエージェント**——RIPER-5フェーズごとに1つ（R → SPEC → I → P → V → E → UP）： | エージェント | モデル | 役割 | |-------|:---:|------| | 🔍 `vc-research-agent` | sonnet | コードベース＋Webリサーチ、リードオンリー。矛盾追跡内蔵 | | 📝 `vc-spec-agent` | sonnet | INNOVATE前のプロダクトディスカバリー要件ドキュメント。`*_SPEC_*.md`を生成 | | 💡 `vc-innovate-agent` | sonnet | 2〜3のアプローチを比較。PLAN前に意思決定サマリー（選択・却下） | | 📋 `vc-plan-agent` | sonnet | ショートカット防止ガード付きでプランを作成。「やり方はもう分かってる」はプランではない | | ✅ `vc-validate-agent` | sonnet | プラン→合意済みチェックリストに変換（V1〜V7）。チェックポイント：PASS/CONDITIONAL/BLOCKED | | ⚡ `vc-execute-agent` | **opus** | プラン通りに実装。フェーズレポートへの進捗ノート、逸脱プロトコル、セルフレビュー | | ⏩ `vc-fast-mode-agent` | **opus** | EXECUTE前に必須の安全一時停止付きでR→S→I→P→Vを圧縮 | | 🔧 `vc-quick-fix-agent` | **opus** | QUICK FIXレーン：1つの小さな低リスク編集＋スコープ内チェック、プラン/バリデート不要 | | 🧠 `vc-update-process-agent` | sonnet | 7フェーズクローズアウト：アーカイブ、コンテキスト更新、古いアーティファクトスキャン、学びのキャプチャ |
**スペシャリストエージェント**——EXECUTE中またはスタンドアロンで呼び出し： | エージェント | 役割 | |-------|------| | 🐛 `vc-debugger` | 仮説を立てる前に証拠を収集。対立仮説、除外チェーン、フィージビリティプローブ | | 🧪 `vc-tester` | 変更対応。合意済みチェックリストのテストを再実行（EVL）。設定変更時に自動エスカレーション | | 🔎 `vc-code-reviewer` | レビュー前にエッジケーススカウトを送る。N+1検出、認証パス確認 | | ✨ `vc-code-simplifier` | 動作を変えずにわかりやすさのためにコードを整理 | | 🎨 `vc-ui-ux-designer` | デザイン対応フロントエンド。ビルド中にリサーチワーカーを起動可能 | | 📦 `vc-git-manager` | `touched_files`から論理的なコミットに分割。不明なファイルを拒否 |

### 33スキル（自動発見）
クリックでスキルリストを展開（20コントラクト＋13ヘルパー）
**📜 コントラクトスキル（20）**——アーティファクトを所有：`vc-generate-plan` · `vc-generate-context` · `vc-generate-spec` · `vc-generate-closeout` · `vc-generate-phase-program` · `vc-audit-context` · `vc-audit-plans` · `vc-audit-vc` · `vc-update` · `vc-publish` · `vc-feasibility-test` · `vc-risk-evidence-pack` · `vc-test-coverage-plan` · `vc-validate-findings` · `vc-autoresearch` · `vc-intent-clarify` · `vc-autopilot` · `vc-agent-strategy-compare` · `vc-plan-discovery` · `vc-context-discovery` **🛠️ ヘルパースキル（13）**——エージェントの動き方を改善：`vc-review-situation` · `vc-sequential-thinking` · `vc-problem-solving` · `vc-scout` · `vc-debug` · `vc-docs-seeker` · `vc-frontend-design` · `vc-agent-browser` · `vc-web-testing` · `vc-setup` · `vc-predict` · `vc-scenario` · `vc-security`
> **⚠️ 命名ルール：** 独自のスキルやエージェントに`vc-`プレフィックスを**使用しないでください**——そのネームスペースはキット提供ファイル用に予約されており、古いファイル削除ガードが`.claude/skills/`と`.claude/agents/`下のあらゆる`vc-*`パスをキット所有として扱います。代わりに`my-`、`team-`、または`proj-`を使用してください。
### 🪝 10のフック | フック | 何をするか | |------|-------------| | 🔐 `privacy-block.cjs` | `.env`、クレデンシャル、SSHキーの読み取りをブロック。明示的な承認が必要 | | 🚫 `scout-block.cjs` | `node_modules/`、`dist/`への侵入を防止。gitignore構文の`.ckignore` | | 🧠 `session-init.cjs` | スタックを検出し、envを注入し、コンパクション後に承認ゲートを復元 | | 💉 `subagent-init.cjs` | すべてのサブエージェントにコンパクトなコンテキストブロックを注入 | | ✨ `post-edit-simplify-reminder.cjs` | 5回以上の編集後、シンプリファイアーの実行を促す（ノンブロッキング、スロットリング付き） | | 📛 `descriptive-name.cjs` | すべてのWriteに言語対応のファイル命名規約を適用 | | 📊 `session-state.cjs` | セッションメトリクス＋トークン認識 | | 📋 `post-write-plan-check.mjs` | `*_PLAN_*.md`へのすべてのWriteでプランアーティファクト構造を検証 | | 🧹 `post-commit-lint.mjs` | すべての`git commit`でconventional-commitsプレフィックスを確認 | | 🔍 `stop-validator-sweep.cjs` | セッション停止時にコアハーネスバリデーターを実行 |
**すべての配置場所：** ```text your-project/ ├── .claude/{agents,skills,hooks}/ # 🤖 15エージェント · ⚡ 33スキル · 🪝 10フック ├── .codex/agents/ # 🔄 Codex用ミラー ├── .agents/skills -> .claude/skills # 🔗 Codex発見用シンボリックリンク ├── CLAUDE.md · AGENTS.md # 📋 オーケストレーター設定＋クロスツールレジストリ └── process/ ├── context/ # 🧠 自動ルーティングされるナレッジドメイン ├── general-plans/ # 📋 横断的なプラン＋タスクフォルダー ├── features/ # 🏷️ フィーチャースコープのライフサイクルフォルダー └── development-protocols/ # 📜 22の共有ワークフロードキュメント ``` --- ## ⚡ Quick Fix + Fast Mode フルRIPER-5プロセスが仕事に対して過剰な場合の2つの軽量オプション：

🔧

Quick Fix — "quick fix: …"

単純な1行より大きく、「プランが必要」より小さい変更。リードエージェントがリードオンリーでスカウト→1行の確認→vc-quick-fix-agentを起動して編集＋触れたファイルのみのスコープ内チェック。プランなし、合意済みチェックリストなし、EVLなし。

変更がスキーマ、認証、API、課金、またはマイグレーションサーフェスに触れた場合は即座にキャンセル——その場合はフルRESEARCHにルーティングされます。

⏩

Fast Mode — "ENTER FAST MODE - …"

RESEARCH＋SPEC＋INNOVATE＋PLAN＋VALIDATEを1パスに圧縮します——しかし**プランを書き、合意済みチェックリストを書き、EXECUTE前に一時停止します。**

プレーンFast Modeでは、VALIDATE後に一時停止があります——あなたがレビューして「ENTER EXECUTE MODE」と言います。autopilot fast: [task]を使えば一時停止を取り除き、止まらずに最後まで実行できます。
--- ## 🔄 キットライフサイクル：Install · Setup · Update · Publish | コマンド | 何をするか | いつ | |---|---|---| | `curl … install.sh \| bash` | あなたのファイルを上書きせずにキットファイルを同期；新規かアップグレードかを自動検出してルーティング | 初回インストール＋すべてのアップグレード | | **Run vc-setup** | スタックを検出し、`process/`をスキャフォルド、コードベースをディープスキャン、実際のコンテキストを入力 | 新規インストール後 | | **Run vc-update** | 精密な差分を計算し、何が変わるかを表示し、OKを待つ；古いフォーマットのプラン/フォルダーをデータ損失ゼロで移行 | すべてのアップグレード時 | | **Run vc-publish** *（メンテナー向け）* | ハーネスの変更をキットリポジトリに公開 | キット自体へのコントリビュート時 | ```mermaid %%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px', 'lineColor': '#8888AA'}} }%% flowchart TD TRG["EXECUTE complete\nENTER UPDATE PROCESS MODE"] AGT["spawn vc-update-process-agent"] A["(a) Archive plan\nactive/ → completed/"] B["(b) Update process/context/\nsmallest relevant file\n+ all-context.md router"] C["(c) Tier-1 audits\n(change-type gated)"] AVC["vc-audit-vc\nharness/agent edits"] ACX["vc-audit-context\ncontext-doc edits"] APL["vc-audit-plans\nplan/program edits"] D["(d) Capture learnings\nto memory"] E["(e) Write closeout packet\nvc-generate-closeout"] F["(f) Conventional commit\nvc-git-manager"] TRG --> AGT --> A --> B --> C C --> AVC C --> ACX C --> APL AVC --> D ACX --> D APL --> D D --> E --> F style TRG fill:#1565C0,stroke:#0D47A1,color:#FFFFFF style AGT fill:#0277BD,stroke:#01579B,color:#FFFFFF style A fill:#6A1B9A,stroke:#4A148C,color:#FFFFFF style B fill:#00695C,stroke:#004D40,color:#FFFFFF style C fill:#E65100,stroke:#BF360C,color:#FFFFFF style AVC fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style ACX fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style APL fill:#2E7D32,stroke:#1B5E20,color:#FFFFFF style D fill:#558B2F,stroke:#33691E,color:#FFFFFF style E fill:#C62828,stroke:#B71C1C,color:#FFFFFF style F fill:#37474F,stroke:#263238,color:#FFFFFF ``` > 💡 `vc-update`はプレビュー差分を表示してOKを待ちます。`process/`ディレクトリとプロジェクト固有のコンテンツは**決して**黙って変更されません。インストールを再実行しても安全に2回実行できます。 --- ## 💡 うまく動く理由 多くの小さくスマートなデフォルトが積み重なって、手間が減り、コストが下がります。 - **各ロールは必要なツールだけを持ちます。** プランニング中、エージェントは文字通りコードを編集できません——そのツールがオフになっています。これはエージェントがプランが承認される前に先走って変更するのを防ぎます。システムが単純にそれを許しません。 - **プレミアムAIモデルを本当に重要な場所だけに使います。** コード作成には最高モデルを使用。プランニング、リサーチ、レビュー、チェックはすべてより安価で速いモデルを使用します。結果：すべてに最高モデルを使う場合と比べて約60〜70%のコスト削減——重要な作業の品質は失わずに。 - **構築前にリスクのある推測をテストします。** エージェントが何かが動作するか確信が持てない場合——特定のAPI動作、ライブラリの機能、インフラの前提——最初に小さな実際の実験を実行します。結果は明確です：動作する、動作しない、または不明。その判定と平易な英語のノートがプランに直接フィードバックされます。エージェントは間違った前提の上に何時間も費やしません。 - **きれいで意味のあるセーブポイント。** 変更は明確なメッセージを持つ論理的なクリーンなチャンクでコミットされます——自動的に。履歴は読みやすく、1つずつ取り消しやすいです。 - **役立つ自動リマインダー。** 小さな組み込みヘルパーが、変更されたファイルに正しいチェックを実行すること、コードをシンプルに保つこと、適切なコミットメッセージを書くことなどを促します。あなたが監視しなくても品質が高く保たれます。 - **自己改善ループを単独で実行できます。** プランチェックとテスト修正を駆動する同じ「問題を見つけ、修正し、繰り返す」エンジンが、どんな雑然とした領域——スペック、ドキュメント、テスト、エラーリスト——にもスタンドアロンツールとして機能します。それを使うためにフルの機能ビルドは必要ありません。 - **ワークフロールールが実際に動作することの組み込みの証明。** キットには独自のテストスイートが付属します：ワークフロールールが正しく動作することを証明する既知の良い例と悪い例のセット。システムが自分自身を確認します。ガードレールがオンになっていると信頼する必要はありません——チェックを実行して確認できます。 --- ## コントリビュート コントリビューションを歓迎します！ガイドラインは[CONTRIBUTING.md](CONTRIBUTING.md)をご覧ください。
**クイックリンク：** - 🐛 [バグを報告する](https://github.com/withkynam/vibecode-pro-max-kit/issues/new?template=1.bug_report.yml) - 💡 [機能をリクエストする](https://github.com/withkynam/vibecode-pro-max-kit/issues/new?template=2.feature_request.yml) - ⚡ [スキルを提出する](https://github.com/withkynam/vibecode-pro-max-kit/issues/new?template=3.skill_submission.yml) - 🌐 [翻訳を追加する](https://github.com/withkynam/vibecode-pro-max-kit/issues/new?template=5.translation.yml)
Contributors
### 🙏 クレジット vibecode-pro-max-kitはスペック駆動の開発フレームワークと自己改善型コンテキスト整理に焦点を当て、80以上のスキルで肥大化させません。ツールは少なく、構造を重視。 --- ## ⭐ Star History Star History Chart --- ## 📄 ライセンス MIT