examples

VDD Framework --- 参照実装

VDD Framework の実際の使用例を収録しています。テンプレート（template/）からセットアップした後、これらの例を参考にプロジェクト固有のカスタマイズを行ってください。

収録例

minimal/ --- Level 1: Safe Development

VDD Framework の最小構成です。ワークツリーによるコード隔離と基本的なコミット衛生ルールのみを含みます。

• 含まれるもの: worktree-guard + commit-guard の2つの hook と最小限の CLAUDE.md
• 含まれないもの: サブエージェントルール、レビュー強制、TDD、VDD ファイル
• 参考になる場面: VDD を段階的に導入したい場合、まず安全なベースラインを確立したい場合

レベル別の概要

機能	minimal (L1)	template (L1-L5)
ワークツリー隔離	o	o
コミット衛生	o	o
マイグレーションガード	-	L2+
サブエージェントルール注入	-	L3+
レビュー強制	-	L3+
TDD 必須	-	L3+
VDD ファイル (VISION/DECISIONS)	-	L4+
リリース仕様書	-	L2+
エージェント定義	-	L3+
スキル定義	-	L2+
クラウド実行環境	-	L5

使い方

1. まず template/ からプロジェクトをセットアップ:

   # scripts/init.sh を使用するか、template/ から手動コピー
   bash path/to/vdd-framework/scripts/init.sh

2. 自分のプロジェクトに合わせてカスタマイズする際、minimal/ や template/ を参考にする

3. 段階的にレベルを上げていく:

   • Level 1 (minimal) から始めて、必要に応じて機能を追加
   • template/ 内の各ファイルを参考に、プロジェクト固有の hooks やスキルを作成

独自の例を追加するには

実際のプロジェクトで VDD Framework を使用した例をコントリビュートする場合は、以下に注意してください：

• シークレット、API キー、内部 ID をマスクする
• ビジネス戦略、ロードマップ、内部決定を含めない
• 個人名やハンドル名を汎用化する
• GitHub の PR/Issue 番号など、リポジトリを特定可能な情報を除去する