| name | vibeflow-healthcheck |
| description | Verify VibeFlow project repository consistency. Use when checking project structure, required files, and integration health. |
VibeFlow Healthcheck
When to Use
- When verifying project setup is correct
- When troubleshooting configuration issues
- When onboarding to an existing project
- After running setup or upgrade
Instructions
VibeFlow プロジェクトの整合性を検証します。
Checks to Perform
1. ディレクトリ構造
- .vibe/context/ が存在するか
- .vibe/references/ が存在するか
- .vibe/archive/ が存在するか
- .vibe/context/STATUS.md が存在するか
- .github/ISSUE_TEMPLATE/ が存在するか
2. 必須ファイル
- vision.md, plan.md が存在するか / .vibe/spec/ に構造化 spec があるか
- .vibe/project_state.yaml が有効なYAMLか
- .vibe/sessions/iris-main.yaml が存在し有効か
- .vibe/policy.yaml が存在するか
3. State ファイル整合性
.vibe/project_state.yaml を読み込み
current_phase が development | discovery のいずれかかactive_issue が null または有効な Issue 番号か
.vibe/sessions/iris-main.yaml を読み込み
current_role が有効なロール名かkind が iris か
Note: .vibe/state.yaml が存在する場合は旧形式。正本は project_state.yaml + sessions/*.yaml です。
4. GitHub Issues 連携
gh CLI が利用可能か- GitHub リポジトリとの接続確認
- Issue テンプレートが配置されているか
5. Hook 設定
- .claude/settings.json が存在するか
- validate_access.py が存在し実行可能か
6. ロール定義
- .vibe/roles/iris.md が存在するか（v3必須）
- 旧 discussion-partner.md が残っていないか
7. Skills 確認
- .claude/skills/ ディレクトリが存在するか
- 必須 skills が配置されているか
8. 構造化 spec とコードの整合性（v6 — 日常検証の核）
vibeflow spec-verify を実行する- ERRORS が 1 件でもあれば failure。spec がコードから drift している
（source_files / producers / consumers / test / source_ref の参照先が消えた、
story 参照が壊れた、必須フィールド欠落 等）。修正手順とともに表示する。
- pending invariant 数を warning として表示。テスト未整備の不変条件で、
これが多いほど「構造化されているが未検証」のリスクが高い。後続 Issue で
test を付けて verified に押し上げる対象。数の推移を毎回見える化する。
- WARNINGS（schema_ref 未解決など）も表示する。
spec-verify はコード変更を伴わない静的検証。invariant の test を実際に
走らせて verified を確定するのは PR ゲート側の責務。
Output Format
各チェック項目について pass / warning / failure を表示。
日本語で表示し、修正手順を含めてください。
Examples
- "プロジェクトの整合性をチェック"
- "/healthcheck"
