インストールと初回実行

VibeProにはNode.js 20以上が必要です。

公開パッケージは現在、早期ベータ版です。npmから試す場合は beta dist-tagを明示してください。

npx vibepro@beta --help

VibePro本体をローカル開発する場合:

git clone https://github.com/Unson-LLC/vibepro.git
cd vibepro
npm install
node bin/vibepro.js --help

どこで実行するか

VibeProは、変更対象のリポジトリで実行します。CodexやClaude Codeに実装を任せる場合でも、VibeProのコマンドはそのリポジトリのGit状態を見て判断します。

Cloudflare Pagesに載せるWebアプリであれば、Pagesのダッシュボード内でVibeProを動かすのではなく、PRを作る前にローカルまたはCI上で実行します。

/path/to/web-app
  package.json
  src/
  docs/
  .vibepro/      # VibeProが証跡を書き込む作業領域

まず対象リポジトリで vibepro init または vibepro check を実行し、その後にCodex/Claude Codeの実装、検証、PR準備へ進みます。

まずリポジトリを診断する

Storyがまだない場合は、リポジトリ全体の診断から始めます。

vibepro check all /path/to/repo --base <base-branch>

生成された診断レポートと、すべての needs_review / fail 項目を確認してから、AI実装へ進むべきか判断します。

Storyを作る

機能追加や不具合修正では、Story IDを指定して初期化します。

vibepro init /path/to/repo \
  --story-id story-<short-name> \
  --title "<機能追加または不具合修正のタイトル>" \
  --language ja

そのStoryに対して診断を実行します。

vibepro check all /path/to/repo \
  --story-id story-<short-name> \
  --base <base-branch>

PR証跡を準備する

実装差分ができたら pr prepare を実行します。

vibepro pr prepare /path/to/repo \
  --story-id <story-id> \
  --base <base-branch>

生成されたファイルはこの順で確認します。

1. .vibepro/pr/<story-id>/review-cockpit.html
2. .vibepro/pr/<story-id>/gate-dag.html
3. .vibepro/pr/<story-id>/split-plan.html
4. .vibepro/pr/<story-id>/pr-body.md

<base-branch> はリポジトリごとに異なります。origin/main、main、origin/develop、develop など、そのリポジトリの実際の統合先を使ってください。

検証証跡を記録する

現在のGit状態で実際にコマンドを実行してから、その結果を記録します。

vibepro verify record /path/to/repo \
  --id <story-id> \
  --kind unit \
  --status pass \
  --command "npm test"

将来実行する予定の検証を、pass済み証跡として記録してはいけません。

VibePro経由でPRを作る

pr prepare が作成可能と示した後、VibePro経由でPRを作成します。

vibepro pr create /path/to/repo \
  --base <base-branch> \
  --head <feature-branch> \
  --story-id <story-id>

通常経路として直接 gh pr create を使うのは避けてください。VibeProのGate DAGと例外承認の記録を通らなくなります。