コンテンツにスキップ

Stage 3-A 完遂 — Gemini CLI を KUDO-Vault 生態系に統合

Status

completed (2026-05-22)

Context

Stage 1 系列（KUDO-Vault 健全化）＋ Stage 2（WorkFlowy → Vault Phase 1 移行）が完遂し、Vault canonical 化と dual-write 体制が確立した。続く Stage 3-A は、ローカル環境に既にインストール・OAuth 認証・MCP 接続まで完了していた Gemini CLI 0.42.0 を、Vault 生態系の 4 番目の AI 環境として正式統合する作業：

  • ローカル環境に Gemini CLI 0.42.0 が Homebrew で導入済（/opt/homebrew/bin/gemini）
  • ~/.gemini/settings.json に obsidian (HTTP 27123) + workflowy (stdio) の MCP 接続が Connected 状態
  • AI-ACCESS.md（2026-05-18）に「end-to-end 検証済」と既記載
  • しかし、生態系の SSOT 層（CLAUDE.md / SKILL.md 群 / 個人設定）には Gemini CLI が未統合
  • 4 環境の用途分担判定が未明文化（機械判別不能・属人的）

Stage 2 着手時の §16-3 環境非対称性見落とし（Watchlist Entry #20）の教訓を踏まえ、実機検証ベースで Phase 1（調査）→ Phase 2（起草）→ Phase 3（SSOT 拡張）の 3 段ワークフローで進行。

Decision

工藤拓真の AI 環境を Chat / Cowork / Code / Gemini CLI の 4 ノード体制として正式統合：

  1. GEMINI.md（v1.1）を Vault ルート（~/KUDO-Vault/GEMINI.md）に配置 — CLAUDE.md と並列の上位 SSOT。Gemini 固有差分のみを薄いファイル方針（119 行）で記述、Vault 共通構造は CLAUDE.md への cross-reference で吸収。
  2. kudo-cowork-code-handoff-protocol を v1.15 に拡張 — §16-3 を 4 環境マトリクスに、§16-3-B（gemini-integration）/ §16-3-C（usage-allocation-criteria）/ §16-3-D（gemini-pitfalls）を新設。
  3. §0-2 着手前環境マトリクス検証チェックリスト（v1.14 で新設）に Gemini 専用項目（--approval-mode 明示 / gemini mcp list 事前確認 / trustedFolders.json 検証）を追加。
  4. 個人設定 v5.3 → v5.4 差分を _claude_workspace_global/handoffs/ に起草し、項目 14 主要スキル直接参照リストに kudo-cowork-code-handoff-protocol#gemini-integration と GEMINI.md を追加（Chat 経由で工藤さんに UI 反映依頼）。
  5. Phase 4（Gemini Skills 統合・gemini skills link ~/KUDO-Vault/.claude/skills/kudo/ の実機検証）は別 Stage 候補として保留 — Stage 3-A スコープ外。

Stage 3-A 各 Phase の完遂サマリ

Phase 1：Gemini CLI 現状確認（実機調査）

実行：Code セッション（2026-05-22） 成果物：~/working/_claude_workspace_global/reports/gemini-cli-environment-survey-2026-05-22.md（11 セクション・約 350 行）

重要発見 5 件： 1. Gemini CLI 0.42.0 が Homebrew インストール済・OAuth 認証完了済（/opt/homebrew/bin/gemini・active = kudotakuma421@gmail.com） 2. MCP プロトコル完全対応で既に接続済（obsidian + workflowy が Connected）。設定は ~/.gemini/settings.json（~/.config/gemini/ ではない） 3. GEMINI.md は CLAUDE.md と完全並列の階層メモリ規約（バンドル内に DEFAULT_CONTEXT_FILENAME = "GEMINI.md" 確認）。/init /memory list /memory reload 等のスラッシュコマンドあり 4. Claude Code 互換性が公式に意図されている：gemini hooks migrate サブコマンド・Skills/Extensions/Hooks エコシステムが並走設計・SKILL.md ファイル名共通 5. Context window：Pro 系 2M tokens（gemini-3-pro）/ Flash 系 1M tokens — Claude Opus 1M 比で約 2 倍

Vault 実機テスト：cd ~/KUDO-Vault && gemini --approval-mode plan -p "..." で CLAUDE.md を読み・日本語要約を出力（成功）。

Phase 2：GEMINI.md 起草・配置・実機検証

実行：Code セッション（2026-05-22） 成果物： - ~/KUDO-Vault/GEMINI.md v1.0（commit a0c051e、push 済） - ~/working/_claude_workspace_global/reports/gemini-vault-integration-test-2026-05-22.md（実機検証レポート）

判断：「薄いファイル方針」（80-100 行目安）を採用。CLAUDE.md 544 行への cross-reference を多用し、Gemini 固有差分のみを 119 行で記述。

実機検証結果（6 検証項目すべて PASS）： 1. GEMINI.md が階層メモリにロードされる ✅ 2. wikilink cross-reference が verbatim 保持される ✅（重要発見：自動展開しない） 3. CLAUDE.md が並列でロードされる ✅ 4. memory/decisions/ 配下 ADR が読込可能 ✅ 5. ADR 内容に幻覚なし（原文 5 要素すべて整合）✅ 6. --approval-mode plan で書込なし ✅

Phase 2-C 判断：~/.gemini/trustedFolders.json は 変更不要（既存 /users/kudotakuma=TRUST_FOLDER が macOS case-insensitive で ~/KUDO-Vault を再帰的に trusted 化、Phase 1 実機テスト成功が実証）。

Phase 3：kudo-cowork-code-handoff-protocol v1.15 拡張 + GEMINI.md v1.1 微改訂

実行：Code セッション（2026-05-22） Vault commit：73dd778（push 済）

SKILL.md v1.14 → v1.15： - frontmatter version 1.14 → 1.15、anchors キーに gemini-integration / usage-allocation-criteria / gemini-pitfalls の 3 件を追加 - §16-3 を 2 段マトリクス構造に拡張： - §16-3-i 4 環境機能可否マトリクス（新設・9 機能 × 4 環境） - §16-3-ii 既存作業タイプ別マトリクス（Gemini 関連行 2 件追加：Vault 全読長文横断分析 / WorkFlowy 読み取り） - §16-3-B Gemini CLI 統合の位置付け（gemini-integration）を新設 - §16-3-C 用途分担判定軸 4 件（usage-allocation-criteria）を新設 — 機械判別可能化： - 軸 1：対象 tokens サイズ（~100K / 100K-500K / 500K-2M） - 軸 2：PARA フォルダ横断性（単一 / 複数） - 軸 3：書き込み・編集の有無（書込必須 / 読取専用） - 軸 4：Claude Code Hooks の継続性（流用必要 / 新規） - 判定が割れた場合のエスカレーション規範（3/4 一致なら確定、2-2 で割れたら §16-3-i 強み列、それでも決まらなければ工藤さんに 1 行確認） - §16-3-D Gemini 固有ハマりポイント（gemini-pitfalls）を新設 — 6 項目 + wikilink 展開指示テンプレート - §0-2 着手前チェックリストに項目 5（Gemini 専用検証 3 件）を追加 - §16-7 関連スキルに [[GEMINI]] / [[AI-ACCESS]] / kudo-shared-storage-protocol#concentration-principle を追加

GEMINI.md v1.0 → v1.1： - §6 に「wikilink 自動展開なし」項目を追加（Phase 2-D で発見した重要差分・再発防止永続化） - §7 用途分担を kudo-cowork-code-handoff-protocol#usage-allocation-criteria への参照に統一（重複定義禁止・Trust the Namespace 原則）

4 ノード生態系の確立状態（2026-05-22 完成）

ノード 役割 強み 制約
Chat（claude.ai） 対話・起草・戦略議論 UI と context routing、自然言語ループ ローカル FS / git / MCP 主要群 ❌
Cowork 自動化・夜間バッチ・MCP 駆動 scheduled-tasks / workflowy / obsidian / Chrome 等の MCP 群 ローカル FS 直接書込 ❌（mount 経由のみ）、ステート保持不可
Code（Claude Code） git workflow・スキル改訂・ローカル FS 直接書込 macOS ネイティブ、ホーム全域 R/W、連続セッション、1M context scheduled-tasks MCP 0 件返答（スコープ外）
Gemini CLI（v0.42.0） 長文 Vault 横断分析 2M context（gemini-3-pro）、obsidian + workflowy MCP Connected、--approval-mode plan 読取専用 wikilink 自動展開なし（明示指示が必要）、Shell cwd reset、scheduled-tasks MCP は未登録（★仮説：未検証）

認知ズレ予防の成果

Stage 2 着手時の Watchlist Entry #20（指示書設計時の環境非対称性見落とし）から学んだ「実機検証ベースで進行」の規範を Stage 3-A 全 Phase で徹底：

  • Phase 1：11 セクションの実機調査（インストール / 設定ファイル / MCP / バンドル grep / Vault テスト）を完遂してから Phase 2 に進む
  • Phase 2-A：CLAUDE.md §6.1 / §8.4 / §6.3 等の cross-reference 先を verbatim 確認してから起草
  • Phase 2-D：headless 実機テストで end-to-end 動作確認（GEMINI.md → CLAUDE.md → ADR の辿りを 6 項目検証）
  • Phase 3：v1.14 → v1.15 改訂前に §16 全体構造を Read で把握、anchor 衝突を回避

結果：Entry #20 同種事故ゼロで完遂。§0 着手前環境マトリクス検証チェックリスト（v1.14 新設）の規範が実証された形。

戦略的含意：2M context の活用

Gemini CLI の 2M context は、Claude Opus 4.7 [1M] の 約 2 倍の収容量。次のような新規ワークフローが可能になった：

  • Stage 1 系列 vs Stage 2 系列の対比分析：両系列の全 ADR + insights + 完遂報告を一度に読み込んで傾向分析
  • PARA 複数フォルダ横断分析：01-Projects/ + 02-Areas/ + 03-Resources/ を同時参照する戦略議論
  • 50 スキル全文一括レビュー：.claude/skills/kudo/ 配下全 SKILL.md を一度に読んで生態系の整合性チェック
  • 長期プロジェクトの状態復元：複数月分の logs/YYYY/MM/ ダイジェスト + ADR + 関連スキルを一括参照

これらは Claude Code の 1M context では分割読込が必要だったが、Gemini なら一発で処理可能。新たな分析の生産性次元が開いた。

保留：Phase 4 候補（別 Stage）

gemini skills link ~/KUDO-Vault/.claude/skills/kudo/ で Vault SKILL.md 群を Gemini からも参照可能か実機検証する作業は、Stage 3-A のスコープ外。GEMINI.md §8「★仮説：要実機検証」として明記。実施判断は工藤さん。

実施した場合の予想効果：Gemini が kudo-* スキル群を自律的にトリガーできるようになり、/skills enable kudo-mitate のようなコマンドで戦略分析が走らせられる可能性。ただし Claude Code の Skills エコシステムと衝突しないか別途検証が必要。

関連 commit / push

  • a0c051e：GEMINI.md v1.0 配置（Phase 2-B）
  • 73dd778：SKILL.md v1.15 + GEMINI.md v1.1（Phase 3-C）
  • 本 ADR commit：別途追加予定（Phase 3-D 末尾で）

Consequences

  • 4 環境用途分担が機械判別可能化（§16-3-C usage-allocation-criteria の 4 軸）→ 今後の作業で「Code か Gemini か」の判断が決定論的になり、属人性が解消
  • 2M context window が KUDO-Vault 全読を伴う長文横断分析の本線ルートとして利用可能 → 新たな分析次元の獲得
  • wikilink 自動展開なしの差分が永続化 → Gemini 利用時の指示テンプレ運用が型化、再発防止
  • Stage 2 §0 着手前環境マトリクス検証チェックリスト（Entry #20 起点）に Gemini 専用項目を追加 → 4 環境化に伴う指示書設計の漏れを予防
  • 個人設定 v5.4 差分提案（_claude_workspace_global/handoffs/personal-settings-v5.4-draft.md）が起草され、Chat 経由で工藤さんに UI 反映依頼が発行される
  • Phase 4（Gemini Skills 統合）の布石が GEMINI.md §8 と本 ADR に残り、将来の Stage 着手判断材料として保存