hirokimry/sync-check

sync-check: 整合性チェック（読み取り専用）

コード変更に対して docs/、knowledge/、README.md が整合しているかを、各職種エージェントに委任して 確認する。 このスキルは チェックのみ 行い、ファイルの編集は一切しない。

ワークフロー

1. 変更内容の把握

# ベースブランチとの差分（PRスコープ）
git diff main...HEAD --name-only

# 未コミットの変更も含める
git diff --staged --name-only
git diff --name-only

2. 対象外の判定

以下のケースは整合性チェック不要。エージェント起動をスキップしてステップ6のスタンプ発行に進む:

• docs/ や knowledge/ や README.md のみの変更（コードとの整合問題が発生しない）
• .gitignore 等の軽微な変更のみ

3. 担当エージェントの起動

変更内容に基づき、関連する職種のエージェントを Agent ツールで並列起動 する。 各エージェントは 自分の管轄ファイルだけ を読み取りチェックする。

プリセット検出

.claude/vibecorp.yml から preset を取得する:

awk '/^preset:/ { sub(/^preset:[[:space:]]*/, ""); print; exit }' .claude/vibecorp.yml

• minimal / standard → デフォルト（CTO / CPO のみ）
• full → デフォルト + 差分キーワードにヒットした C*O を自動起動

デフォルト管轄（全プリセット共通）

CTO / CPO は常時起動する。

| エージェント | 管轄ファイル | 起動条件 | |-------------|------------|---------| | CTO | docs/ 内の技術設計ドキュメント、knowledge/cto/ | アーキテクチャ・技術設計・エージェント定義・hooks・スキル関連の変更 | | CPO | docs/specification.md、knowledge/cpo/、README.md | 仕様・UI・プロンプト・スキル・フック・エージェント・README 関連の変更 |

full プリセット時の自動起動

preset: full の場合、以下のトリガー表に従い git diff main...HEAD -U0 に対してキーワード検出する。ヒットした領域の C*O を CTO / CPO に 加えて 並列起動する（Phase 3 /review-loop と同一のトリガー表）。

| 領域 | diff 内キーワード | 起動 C*O | 管轄ファイル | |---|---|---|---| | 課金影響 | API call, model:, claude -p, ANTHROPIC_API_KEY, rate limit, 従量, トークン消費, npx, bunx | CFO | docs/cost-analysis.md, knowledge/accounting/ | | セキュリティ | auth, token, secret, encrypt, permission, credential, curl, wget, eval, exec | CISO | docs/SECURITY.md, knowledge/security/ | | 法務 | dependency, LICENSE, third-party, 規約, プライバシー, 第三者, package.json, requirements.txt, go.mod | CLO | docs/POLICY.md, knowledge/legal/ | | 組織運営 | .claude/agents/, .claude/hooks/, .claude/rules/, .claude/skills/ | SM | docs/ai-organization.md, knowledge/sm/ |

検出コマンド例（課金領域）:

git diff main...HEAD -U0 | grep -iE 'API call|model:|claude -p|ANTHROPIC_API_KEY|rate limit|従量|トークン消費|npx|bunx'

該当した領域のみ起動する（複数ヒット時は該当全 CO を並列）。standard / minimal プリセットでは CO の自動起動は行わない（既存挙動維持）。

起動方法

各エージェントは name を指定した永続 teammate として起動する（結果返却後も idle で残るため、ステップ5で必ず shutdown する）。起動した name はステップ5で参照するため全て保持しておく。

各エージェントに以下を渡して Agent ツールで起動する:

あなたは {役職名} として、コード変更に対する管轄ドキュメントの整合性をチェックしてください。

## あなたの管轄ファイル
{管轄ファイルリスト}

## コード変更の差分
{git diff の内容}

## チェック観点
- 矛盾: コード変更がドキュメントの記載と食い違っていないか
- 更新漏れ: ドキュメントに反映すべき変更が漏れていないか
- README 乖離（CPO）: 実装と README の記載に乖離がないか
- README 未反映（CPO）: 新しいスキル・フック・エージェントが追加されたのに README に未反映でないか
- POLICY.md 違反（法務のみ）: MUST/MUST NOT 制約に抵触していないか

## 制約
- 読み取りのみ。ファイルを編集してはならない
- 管轄外のファイルに言及しない
- 判定は「OK / 要更新 / 矛盾あり」の3段階

## 出力フォーマット
- 管轄ファイル: {ファイル名}
- 判定: {OK / 要更新 / 矛盾あり}
- 詳細: {具体的な内容（問題がある場合のみ）}

4. 結果の統合・レポート出力

全エージェントの結果を統合し、以下のフォーマットで出力する:

## sync-check 結果

### 変更ファイル
- {変更ファイル一覧}

### チェック結果

#### CTO（技術設計）
- docs/design-philosophy.md: ✅ OK
- knowledge/cto/decisions.md: ⚠️ 要更新 — {詳細}

#### CPO（プロダクト）
- docs/specification.md: ✅ OK

#### CFO / CISO / CLO / SM（full プリセットかつキーワードヒット時のみ）
- docs/cost-analysis.md: ✅ OK
- docs/SECURITY.md: ✅ OK
- docs/POLICY.md: ✅ OK
- docs/ai-organization.md: ✅ OK

### 総合判定
- ✅ 問題なし → push してよい
- ⚠️ 要更新あり → /sync-edit を実行してください
- ❌ 矛盾あり → /sync-edit を実行してください

5. 起動エージェントの shutdown

ステップ3で起動した全エージェントへ shutdown_request を SendMessage で送信し、チームを解散する。 name 付きで起動された teammate は結果を返却した後も idle 状態でペインを占有し続けるため、総合判定（✅ / ⚠️ / ❌）にかかわらず必ず送信する。

{"to": "<エージェント名>", "message": {"type": "shutdown_request", "reason": "sync-check 完了"}}

• 起動した全エージェントに対して 1 件ずつ送信する（同一メッセージで並列送信して構わない）
• teammate 側は shutdown_response を返した時点で terminate されるため、メイン側での応答待ちコードは不要
• ステップ2で整合性チェックをスキップした場合（エージェント未起動）は、本ステップをスキップしてステップ6へ進む

6. スタンプ発行

総合判定が ✅ の場合のみ スタンプを発行する。スタンプは ~/.cache/vibecorp/state/<repo-id>/ 配下に作成され、.claude/ 配下への書込確認プロンプトを回避する:

. "$CLAUDE_PROJECT_DIR/.claude/lib/common.sh"
STAMP_DIR="$(vibecorp_stamp_mkdir)"
touch "${STAMP_DIR}/sync-ok"

⚠️ または ❌ がある場合はスタンプを発行しない。/sync-edit による修正後、再度 /sync-check を実行すること。

判定基準

• ❌ 矛盾: コードとドキュメントが明確に食い違っている
• ⚠️ 要更新: コード変更がドキュメントに反映されていない
• ✅ OK: 整合性に問題なし

制約

• jq では string interpolation \(...) を使わない — Bash 上で \ がエスケープ文字、() がサブシェルとして解釈され、意図しない展開やパースエラーを引き起こすため。必ず + で結合する
• コマンドをそのまま実行する — 2>/dev/null、|| echo、; echo 等のリダイレクトやフォールバックを付加しない（根拠）