コンテンツにスキップ

Stage 3-B 完遂報告 — Vault Drive ミラー配置

目的

Gemini app から KUDO-Vault の主要コンテキストを Drive 経由で read 専用参照 可能にするため、Vault 本体の重要ファイルを Google Drive 同期配下の専用サブフォルダにミラー配置する。Vault 本体(~/KUDO-Vault/)は SSOT のまま不変、ミラーは派生コピーとして扱う。

集中原則ガバナンスとの整合

本配置は 個人設定 v5.4 項目 15 および kudo-shared-storage-protocol v1.3 §5.5 で定義された「集中原則の正規特例」として ~/working/_claude_workspace_global/ 配下に配置。

  • ✅ Drive ルート直下配置ではない
  • ✅ クライアント案件 _claude_workspace/ への横断ファイル混入ではない
  • ~/Downloads/ への永続化前提配置ではない
  • _claude_workspace_global/ 配下のサブフォルダとして規律準拠

配置済みファイル一覧(10 件・verbatim)

# カテゴリ ファイル名 サイズ SSOT 源泉
1 Vault 構造正本 CLAUDE.md 20,718 B ~/KUDO-Vault/CLAUDE.md
2 Gemini CLI 起動指示 GEMINI.md 7,880 B ~/KUDO-Vault/GEMINI.md
3 ADR Stage 1 2026-05-22-stage-1-complete.md 9,703 B ~/KUDO-Vault/memory/decisions/
4 ADR Stage 2 P1 2026-05-22-stage-2-phase1-complete.md 10,319 B ~/KUDO-Vault/memory/decisions/
5 ADR Stage 3-A 2026-05-22-stage-3a-gemini-integration.md 13,277 B ~/KUDO-Vault/memory/decisions/
6 個人設定スナップ personal-settings-v5.4.md 7,457 B ミラー専用合成版(claude.ai UI が唯一の SSOT・v5.3/v5.4 draft + Stage 3-A ADR から構築)
7 動詞群 1 親 SKILL kudo-mitate-SKILL.md 16,220 B ~/.claude/skills/kudo-mitate/SKILL.md
8 動詞群 1 子 SKILL kudo-strategy-houshin-SKILL.md 21,478 B ~/.claude/skills/kudo-strategy-houshin/SKILL.md
9 動詞群 2 親 SKILL kudo-writing-SKILL.md 173,325 B ~/.claude/skills/kudo-writing/SKILL.md
10 三重保存 SSOT kudo-triple-store-write-SKILL.md 17,099 B ~/.claude/skills/kudo-triple-store-write/SKILL.md
ミラー運用文書 README.md 1,276 B ミラー専用(集中原則特例の明示)

合計 10 件 + README 1 件 = 11 ファイル(Gemini app Gem Knowledge / Workspace 添付の容量を意識した厳選セット)。

Drive フォルダ ID

項目
親フォルダ(_claude_workspace_global/) 1EXyQOuWn2tvaBqBnhyeIhAH7Gox3jMsF
本ミラー(vault-mirror-for-gemini/) 1KsZqcjeiF_shKlGAyAamxfi9me2WVNgS
Drive URL https://drive.google.com/drive/folders/1KsZqcjeiF_shKlGAyAamxfi9me2WVNgS

主要ファイルの Drive ID(参考)

ファイル Drive ID
CLAUDE.md 1lCyOiL9_a1poOfL89ShDL2bemTRkdFUd
GEMINI.md 1Y_m2e84OCW4e9sGLqsV-u6ejb0svxrZc
personal-settings-v5.4.md 1HTe-bxxXkCQ5ZOGsqsOXXTiUF69jP6QO
kudo-strategy-houshin-SKILL.md 1SE5GSM7aH4n5tLAoIgwx-QAXaf7JZh3v
README.md 1vAkuEoQ0lrNzCmB-Mxd713ZExbLF630N

sync スクリプトの永続化先パス

項目
パス ~/.claude/scripts/sync_vault_to_drive_mirror.py
実行権限 chmod +x
設計原則 片方向同期(Vault → ミラー)・冪等・ミラー側からの逆方向同期は禁止
利用方法 python3 ~/.claude/scripts/sync_vault_to_drive_mirror.py [--check] [--verbose]
検証結果 --check で全 9 件 SSOT 一致確認(2026-05-22 配置直後・exit=0)

スクリプト設計サマリ

  • SSOT 9 件(Vault 5 件 + SKILL 4 件)を片方向で ミラーへ反映
  • ミラー専用 2 件(personal-settings-v5.4.md / README.md)は同期対象外・存在チェックのみ
  • ハッシュ(SHA-256)一致時はスキップ、不一致時のみ shutil.copy2 で上書き
  • SSOT 側に源泉ファイルが欠落した場合は exit=1(設計エラー)
  • --check モードで差分検出のみ可能(exit=2 で diff あり示唆)

Stage 3-B 内 SKILL 選定の判断履歴

候補 5 件 → 4 件への絞り込み:

候補 採否 判断根拠
kudo-mitate ✅ 採用 動詞群 1 親スキル(全戦略の最上流)・他の戦略系子スキルの起点
kudo-strategy-houshin ✅ 採用(本指示で確定) 動詞群 1 子スキル・親 kudo-mitate の直接的な実装層
kudo-writing ✅ 採用 動詞群 2 親スキル(190+ 名作鑑)・173KB の最大規模スキル
kudo-triple-store-write ✅ 採用 三重保存上位 SSOT・Phase 1 dual-write 移行の中核
kudo-binary-fusion ❌ 不採用 メタ論法は重要だが、Stage 3-B 初回ミラーでは Gemini Knowledge 上限を意識して動詞群 1/2 親子ペア + governance 系を優先

:前回 turn で kudo-binary-fusion を採用していたが、本指示の Phase 3-B-2 で kudo-strategy-houshin に差し替え。binary-fusion は次回ミラー拡張時の最有力候補として記録。

工藤氏が Gemini app 側で確認すべきこと

1. Workspace 連携 ON の確認(Gemini app 側)

Gemini app の設定で Google Workspace(Drive 等)連携が有効になっていることを確認:

  • Gemini app(Web): 設定 → Apps → Google Workspace
  • Gemini app(モバイル): プロフィール → 設定 → アプリ → Workspace

2. Drive 経由で本フォルダが見えるか

Gemini app の入力欄で以下を試す:

@vault-mirror-for-gemini

または個別ファイル指定:

@CLAUDE.md @GEMINI.md @personal-settings-v5.4.md

候補に出てこない場合:

  • Drive 同期完了を待つ(最大 10 分程度)
  • Drive 側で本フォルダ ID 1KsZqcjeiF_shKlGAyAamxfi9me2WVNgS をブラウザで開いて 11 ファイルが見えるか確認
  • Gemini app 側で Workspace 再認証

3. 動作確認の例(質問例)

Gemini app で以下を質問して、ミラー経由で回答されるか確認:

質問例 期待される参照先
「個人設定の最新版は?」 personal-settings-v5.4.md
「Vault の構造を教えて」 CLAUDE.md
「Gemini CLI 起動時の前提は?」 GEMINI.md
「Stage 3-A で何が決まった?」 2026-05-22-stage-3a-gemini-integration.md
「見立てとは?」 kudo-mitate-SKILL.md
「三重保存の運用は?」 kudo-triple-store-write-SKILL.md

4. Instructions for Gemini v2.0 の整合

本フォルダ参照がうまく動かない場合、Gemini app の Custom Instructions(Gem の Instructions)で「~/working/_claude_workspace_global/vault-mirror-for-gemini/ 配下を Vault のミラーとして参照してください」と明示されているか確認。

Vault git との関係(本ミラーは対象外)

本ミラーは Drive 同期のみで永続化。Vault git(~/KUDO-Vault/.git)には含めない:

  • 理由: SSOT 二重化を避ける(Vault 本体が git 管理対象・ミラーは派生コピー)
  • ただし sync_vault_to_drive_mirror.py~/.claude/scripts/ 配下に永続化・再実行可能化済
  • README.md は Drive ミラー内のみ配置(Vault 本体には置かない)

未完了タスク(Stage 3-C 候補)

  • Gemini app 側の Workspace 連携実機検証(工藤氏が対応)
  • ミラー自動同期化(現状は手動 python3 ~/.claude/scripts/sync_vault_to_drive_mirror.py)
  • 候補: launchd 経由の定期実行 / Vault git post-commit hook 経由
  • Gem の Instructions for Gemini v2.0 への「このフォルダを参照する」明示文の最終チェック
  • 容量上限到達時の優先度判断ロジック策定(現状は手動選定)

完遂判定

判定軸 結果
配置先フォルダ作成(mkdir -p)
10 件のミラー対象ファイル配置 ✅(10/10)
README.md 配置 ✅(指定文面 verbatim)
sync スクリプト永続化 ✅(~/.claude/scripts/sync_vault_to_drive_mirror.py)
sync スクリプト動作確認 ✅(--check で diff なし・exit=0)
Drive 同期完了 ✅(11 件全て Drive 側 ID 確認済)
集中原則ガバナンス準拠
Vault git 二重化回避 ✅(ミラーは Drive 同期のみ)
完遂報告配置 ✅(本ファイル)

Stage 3-B は完遂。次は Stage 3-C で工藤氏による Gemini app 側の実機検証 → 自動同期化の検討へ。


本報告は集中原則(kudo-shared-storage-protocol#concentration-principle)に従い ~/working/_claude_workspace_global/reports/ 配下に配置。Drive 同期で Chat / Cowork 側からも参照可能。