基本概念

VibeProは、プロダクト意図、技術的制約、証跡を分けて保存し、それらを接続して扱います。

Story（作業目的）

Storyは、変更が届けるユーザー価値、作業範囲、受け入れ条件、関連する根拠資料を表します。

Storyは対象リポジトリのVibePro作業領域やプロジェクト文書に置かれます。診断、検証記録、エージェントレビュー、PR証跡の起点になります。

Architecture（設計文脈）

Architecture文書は、変更が守るべき境界と責務を説明します。AIエージェントが全ファイルを同じ危険度として扱うのではなく、影響範囲を判断する助けになります。

Spec（仕様）

Specは振る舞いの要求と、常に守るべき条件を定義します。VibeProは受け入れ条件をコード、検証、レビュー証跡へ接続する時にSpecを使います。

検証証跡

検証証跡は、現在のGit状態に対して実際に実行したコマンドと観測結果を記録します。

主な種別:

• unit
• integration
• e2e
• typecheck
• build

Agent Review（エージェントレビュー）

Agent ReviewはAIサブエージェント向けの構造化レビューです。VibeProは役割別のレビュー依頼を作成し、開始から終了までの状態を追跡し、PR作成の前提として完了証跡を要求できます。

Gate DAG（ゲートの依存グラフ）

Gate DAGは、PR作成に必要な確認項目の依存グラフです。PR作成前に必要な証跡、判断、レビュー、例外承認を表します。

小さな文書修正では軽いゲートで済みます。手順変更の多い作業では、再現確認、本番経路の確信度、リリースリスク、プレビュー確認、ネットワークや実行時の振る舞い、追加のレビュー役割などがゲートとして追加されます。

.vibepro/

.vibepro/ は、VibeProが生成物を保存するリポジトリ内の作業領域です。

典型的な構成:

.vibepro/
  config.json
  vibepro-manifest.json
  diagnostics/
  graphify/
  pr/
  qa/
  raw/
  stories/

.vibepro/ は証跡と作業状態を置く場所です。アプリケーション実装とは分けて扱います。