コンテンツにスキップ

GEMINI.md — Gemini CLI 向け Vault 起動指示

§1 このファイルの位置付け

  • [[CLAUDE]] と並列の上位 SSOT（Gemini CLI の階層メモリ規約 DEFAULT_CONTEXT_FILENAME = "GEMINI.md"）
  • Gemini CLI 0.42.0+ 向け
  • Vault 共通の構造・規約は [[CLAUDE]] を参照：
  • ボルト構造 → [[CLAUDE#2. ボルト構造]]
  • 命名規則 → [[CLAUDE#3. ファイル命名規則]]
  • YAML frontmatter → [[CLAUDE#4. YAML frontmatter 規則]]
  • Obsidian 構文 → [[CLAUDE#5. Obsidian 構文]]
  • セッション開始の必読リスト → [[CLAUDE#6.1 セッション開始時の必読リスト]]
  • 1 行報告 → [[CLAUDE#6.2 1 行報告]]
  • 配置振り分け → [[CLAUDE#6.3 振り分け基準]]
  • ADR の書き方 → [[CLAUDE#6.4 ADR の書き方]]
  • 安全規則 → [[CLAUDE#7. 安全規則(最重要)]]
  • 機密情報判断 → [[CLAUDE#8.4 機密情報の扱い]]
  • 本ファイルは Gemini 固有の差分のみを担う

§2 Gemini CLI 環境前提

  • インストール：Homebrew（/opt/homebrew/bin/gemini）
  • バージョン：0.42.0+
  • 認証：OAuth 完了済（active = kudotakuma421@gmail.com）
  • 設定パス：~/.gemini/（~/.config/gemini/ ではない・要注意）
  • context window：Pro 系 2,097,152（2M） / Flash 系 1,048,576（1M）
  • 2M context は KUDO-Vault 全読を可能にする Gemini 固有の強み

§3 セッション開始プロトコル（Gemini 固有）

  1. 起動コマンド（推奨）：cd ~/KUDO-Vault && gemini --approval-mode plan
  2. cd ... && gemini ... の一行チェイン必須（§6 「Shell cwd reset」参照）
  3. --approval-mode plan は読み取り専用。書込が必要な場面のみ昇格
  4. メモリ確認：/memory list で読み込まれた GEMINI.md パス一覧を確認
  5. メモリ更新後：/memory reload で再読込（編集後のホットリロード）
  6. その他は [[CLAUDE#6.1 セッション開始時の必読リスト]] と同じ（本ファイル → MEMORY.md → 案件 MOC → 関連 SKILL.md）

/init は本ファイルが既存のため実行不要。

§4 MCP 接続状態（2026-05-22 現在）

  • obsidian (HTTP 27123)：Connected ✅
  • workflowy (stdio)：Connected ✅
  • 接続確認コマンド：gemini mcp list
  • 詳細・他 AI との横並び表は [[AI-ACCESS]] を参照
  • 環境差マップは kudo-cowork-code-handoff-protocol#environment-asymmetry を参照（v1.15 で 4 環境マトリクス統合済）

§5 安全規約（Gemini 固有）

  • 通常運用：--approval-mode plan（読み取り専用）を推奨
  • 書き込みが必要な場合のみ：--approval-mode auto_edit または default（都度承認）
  • yolo モードは原則禁止：CI 用途等の限定的な場面のみ
  • trustedFolders.json：~/.gemini/trustedFolders.json に /users/kudotakuma が TRUST_FOLDER 登録済（macOS 大小区別なしのため ~/KUDO-Vault も再帰的に trusted）
  • 機密情報判断：[[CLAUDE#8.4 機密情報の扱い]] を SSOT とする（Vault 共通）

§6 既知の運用ノイズ・ハマりポイント

事象 内容 対処
Shell cwd reset Gemini CLI の Shell ツールは各実行で cwd がリセットされる（Claude Code との挙動差） 連続コマンドは cd ... && ... で一行に集約
Ripgrep 警告 Ripgrep is not available. Falling back to GrepTool. が出る brew install ripgrep で解消（性能向上）
設定パス誤認 ~/.config/gemini/ ではなく ~/.gemini/ 他ツールとの混同注意
256-color 警告 Terminal の TERM 環境変数依存 実害なし。無視可
初回 headless で OAuth 失敗 -p で初回起動すると認証エラーの可能性 一度対話起動で認証を確立してから headless に移行
wikilink 自動展開なし（v1.1 追加・Phase 2-D で発見） Gemini は [[link]] を索引として verbatim 保持する。リンク先を自動で読みに行かない（Claude Code との挙動差） クロスリンク多用の分析タスクでは「[[link]] のリンク先も再帰的に読んで」を明示する指示テンプレートが必要（詳細は kudo-cowork-code-handoff-protocol#gemini-pitfalls）
Gemini app との混同注意（v1.2 追加・Stage 3-B で発覚） Gemini app（gemini.google.com / モバイル）と Gemini CLI は別環境。app は Drive 連携でも本文 read 不可で、Gem Knowledge sources 経由が必須（10 ファイル上限） Gemini app 用には KUDO-Vault Navigator Gem（~/working/_claude_workspace_global/vault-mirror-for-gemini/ の 10 ファイルを Knowledge sources に登録）が稼働中。詳細は kudo-cowork-code-handoff-protocol#workspace-scope-limitation
Gemini app の Drive 連携は分析情報取得のみ（v1.2 追加・Watchlist Entry #21 起点） Gemini app の Workspace 連携はメタデータ検索（ファイル名・更新日）まで。任意ファイル本文 read は Gem Knowledge 経由のみ 本文 read が必要な場合は Gem 作成 + Knowledge sources 登録の経路を使う（kudo-cowork-code-handoff-protocol#workspace-scope-limitation）

§7 用途分担（Claude Code / Chat / Cowork / Gemini app との使い分け）

SSOT は kudo-cowork-code-handoff-protocol v1.16+ に統一（v1.1 で重複定義禁止・Trust the Namespace 原則を適用）：

  • 5 環境機能可否マトリクス → kudo-cowork-code-handoff-protocol#environment-asymmetry §16-3-i（v1.16 で 4 環境 → 5 環境化）
  • Gemini CLI 統合の位置付け → kudo-cowork-code-handoff-protocol#gemini-integration §16-3-B
  • 用途分担の機械判別可能な 5 軸（tokens サイズ / PARA 横断性 / 書込有無 / Hooks 継続性 / Google エコシステム連携要否）→ kudo-cowork-code-handoff-protocol#usage-allocation-criteria §16-3-C
  • Gemini CLI / app 固有のハマりポイント → kudo-cowork-code-handoff-protocol#gemini-pitfalls §16-3-D
  • Gemini app 統合の位置付け → kudo-cowork-code-handoff-protocol#gemini-app-integration §16-3-E（v1.16 新設）
  • Gemini app Workspace 連携スコープ制約 → kudo-cowork-code-handoff-protocol#workspace-scope-limitation §16-3-F（v1.16 新設）

判定が割れたら §16-3-i の「強み」列を参照、それでも決まらなければ工藤さんに 1 行確認（規範は §16-3-C 末尾）。

Gemini CLI vs Gemini app の使い分け（v1.2 追加）

  • Gemini CLI：ローカル開発環境からの Vault 全文横断分析。2M context（Pro 系）で ~/KUDO-Vault 全読が可能。--approval-mode plan 推奨。MCP 多態接続（obsidian HTTP + workflowy stdio）で書込・MCP 駆動も可
  • Gemini app：Google エコシステム連携（Gmail / Drive メタデータ / Calendar / Photos）+ Nano Banana Pro 画像生成 + Deep Research + KUDO-Vault Navigator Gem 経由の Vault 部分参照（Drive ミラー 10 ファイル）

CLI と app は別環境として扱う。両方使う場合の役割分担は §16-3-E / §16-3-F を参照。

§8 Skills / Extensions / Hooks

  • Gemini CLI には Skills / Extensions / Hooks 構造あり（Claude Code と類似）
  • gemini skills list / install / link / uninstall
  • gemini extensions install / list / update
  • gemini hooks migrate：Claude Code の hooks をそのまま移植可能
  • ★仮説：KUDO-Vault .claude/skills/kudo/ を Gemini からも gemini skills link で読み込めるか要実機検証（Phase 4 で予定）
  • 現時点では Vault SKILL.md 群は Claude Code 専用として運用（Gemini は GEMINI.md + CLAUDE.md 経由で Vault に接続）

§9 Vault 内 Gemini 関連ファイルの配置

種別 配置先 命名
本ファイル（必読・階層メモリ） ~/KUDO-Vault/GEMINI.md 固定
Gemini 固有 ADR ~/KUDO-Vault/memory/decisions/ 他 ADR と統合（[[CLAUDE#6.3 振り分け基準]]）
Gemini 固有 insight ~/KUDO-Vault/memory/insights/ 他 insight と統合
全 AI 共通の意思決定 同上 [[CLAUDE]] と GEMINI.md 双方から参照可能

専用フォルダ gemini/ 等は作らない（[[CLAUDE#2. ボルト構造]] の PARA 構造を維持）。

§10 編集プロトコル

本ファイルの編集権限・改訂手順は [[CLAUDE#9. このファイルの編集プロトコル]] に準ずる：

  • 直接編集できるのは工藤氏のみ。AI は読むのみ
  • 改訂は AI 起草 → 工藤氏承認 → Code Claude が配置・push の 3 段階
  • 改訂前に .bak.YYYY-MM-DD でバックアップ

§11 更新履歴

  • v1.2（2026-05-22・Stage 3-B / 3-C-3）：
  • §6 既知の運用ノイズに 2 項目追加（Gemini app との混同注意 / Gemini app の Drive 連携は分析情報取得のみ）— Stage 3-B 実機検証 + Watchlist Entry #21 起点
  • §7 用途分担を 5 環境（Claude Code / Chat / Cowork / Gemini CLI / Gemini app）対応に拡張。SSOT 参照を kudo-cowork-code-handoff-protocol v1.16+ に更新。Gemini CLI vs Gemini app の使い分けサブセクションを新設
  • 5 環境マトリクス + Gemini app 統合の位置付け + Workspace 連携スコープ制約への参照を §7 から追加（§16-3-i / §16-3-E / §16-3-F）
  • Stage 3-B 完遂 ADR（[[2026-05-22-stage-3b-gemini-app-integration]]）と双方向参照
  • v1.1（2026-05-22・Stage 3-A Phase 3-B）：
  • §6 に「wikilink 自動展開なし」項目を追加（Phase 2-D 実機検証で発見した Gemini と Claude Code の挙動差分・再発防止永続化）
  • §7 用途分担を kudo-cowork-code-handoff-protocol#usage-allocation-criteria（v1.15 で新設）への参照に統一（重複定義禁止・Trust the Namespace 原則）
  • 詳細は Stage 3-A 完遂 ADR（[[2026-05-22-stage-3a-gemini-integration]]）参照
  • v1.0（2026-05-22）：Stage 3-A Phase 2 で新規起票。KUDO-Vault 生態系への Gemini CLI 統合。詳細は ~/working/_claude_workspace_global/reports/gemini-cli-environment-survey-2026-05-22.md（Phase 1 調査レポート）参照