Stage 3-A 完遂報告書 — Gemini CLI を KUDO-Vault 生態系に統合¶
TL;DR¶
工藤拓真の AI 環境を Chat / Cowork / Code / Gemini CLI の 4 ノード体制として正式統合。 Stage 3-A は Phase 1（実機調査）→ Phase 2（GEMINI.md 配置・実機検証）→ Phase 3（SKILL.md v1.15 拡張）の 3 段ワークフローで完遂。Stage 2 §16-3 環境非対称性見落とし（Entry #20）と同種の事故ゼロ。
Stage 累計 commit¶
Stage 1 系列（KUDO-Vault 健全化・2026-05-18 〜 2026-05-22）¶
- Stage 1 完遂 ADR：
2026-05-22-stage-1-complete.md - Stage 1-C 完遂 ADR：
2026-05-22-stage-1c-complete.md - Stage 1-C-2 再設計 ADR：
2026-05-21-stage-1c-2-redesign.md
Stage 2 系列（WorkFlowy → Vault Phase 1 移行・2026-05-22）¶
- Stage 2 Phase 1 完遂 ADR：
2026-05-22-stage-2-phase1-complete.md - Stage 2 scheduled-tasks 書き換え：
2026-05-22-stage-2-scheduled-tasks-rewrite.md - 関連 commit：
830834d（Stage 2-A WorkFlowy ダイジェスト一括取込）/85da1f0（Stage 2 Phase 1 ADR）
Stage 3-A 系列（Gemini CLI 統合・2026-05-22 ←本ステージ）¶
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 末尾で追加予定
各 Phase の完遂サマリ¶
Phase 1：Gemini CLI 現状確認（実機調査）✅¶
配置：~/working/_claude_workspace_global/reports/gemini-cli-environment-survey-2026-05-22.md
| 確認項目 | 結果 |
|---|---|
| インストール | /opt/homebrew/bin/gemini v0.42.0 |
| 認証 | OAuth 完了済（kudotakuma421@gmail.com） |
| 設定パス | ~/.gemini/（~/.config/gemini/ ではない） |
| MCP 接続 | obsidian (HTTP 27123) ✅ + workflowy (stdio) ✅ |
| Context window | Pro 系 2M / Flash 系 1M |
| GEMINI.md 規約 | DEFAULT_CONTEXT_FILENAME 確認・階層メモリ動作 |
| Claude Code 互換 | gemini hooks migrate あり・SKILL.md 仕様共通 |
| Vault 実機テスト | --approval-mode plan で CLAUDE.md 読込・日本語要約成功 |
Phase 2：GEMINI.md 起草・配置・実機検証 ✅¶
配置：~/KUDO-Vault/GEMINI.md v1.0（commit a0c051e、push 済）
実機検証レポート：~/working/_claude_workspace_global/reports/gemini-vault-integration-test-2026-05-22.md
設計方針：薄いファイル方針（80-100 行目安、実装 119 行）。CLAUDE.md 544 行への cross-reference を多用し、Gemini 固有差分のみを記述。
実機検証 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：SKILL.md v1.15 + GEMINI.md v1.1 ✅¶
Vault commit：73dd778（push 済）
主要改訂：
| 改訂対象 | 内容 |
|---|---|
| frontmatter | version 1.14 → 1.15、anchors キーに 3 件追加（gemini-integration / usage-allocation-criteria / gemini-pitfalls） |
| §0-2 チェックリスト | 項目 5（Gemini 専用検証 3 件）を追加 |
| §16-3 マトリクス | 2 段構造化：§16-3-i 4 環境機能可否マトリクス（新設）+ §16-3-ii 既存作業タイプ別（Gemini 関連行 2 件追加） |
| §16-3-B | Gemini CLI 統合の位置付け（3 つの独自強み）を新設 |
| §16-3-C | 用途分担判定軸 4 件（tokens / PARA / 書込 / Hooks）を新設・機械判別可能化 |
| §16-3-D | Gemini 固有ハマりポイント 6 件 + wikilink 展開指示テンプレートを新設 |
| §16-7 関連スキル | GEMINI.md / AI-ACCESS.md / kudo-shared-storage-protocol#concentration-principle を追加 |
| GEMINI.md §6 | wikilink 自動展開なし項目を追加 |
| GEMINI.md §7 | usage-allocation-criteria への参照に統一（重複定義禁止） |
KUDO-Vault 生態系 4 ノード完成状態¶
4 ノードの強み・制約（総括）¶
| ノード | 強み | 制約 |
|---|---|---|
| Chat（claude.ai） | 対話・起草・戦略議論／自然言語ループ／UI rendering | ローカル FS ❌・git ❌・MCP 主要群 ❌ |
| Cowork | 自動化・夜間バッチ／scheduled-tasks / workflowy / obsidian / Chrome 等 MCP 群 | ローカル FS 直接書込 ❌（mount 経由のみ）・ステート保持不可・標準 context |
| Code（Claude Code） | git workflow・スキル改訂／ホーム全域 R/W・連続セッション／1M context（Opus 4.7 [1M]） | scheduled-tasks MCP 0 件返答（スコープ外） |
| Gemini CLI（v0.42.0） | 長文 Vault 横断分析／2M context（Pro）／obsidian + workflowy MCP Connected／--approval-mode plan 読取専用 |
wikilink 自動展開なし（明示指示必要）・Shell cwd reset・scheduled-tasks MCP は未登録（★仮説） |
機能可否マトリクス（kudo-cowork-code-handoff-protocol §16-3-i SSOT）¶
| 機能 | Chat | Cowork | Code | Gemini CLI |
|---|---|---|---|---|
| Vault ローカル FS 直接 | ❌ | △ | ✅ | ✅ |
| WorkFlowy MCP | ❌ | ✅ | ❌ | ✅ |
| obsidian MCP | ❌ | ✅ | ❌ | ✅ |
| scheduled-tasks MCP | ❌ | ✅ | ❌ | ★仮説 |
| git 操作 | ❌ | ❌ | ✅ | △ |
| Context window | 標準 | 標準 | 1M | 2M |
| Skills/Hooks エコシステム | ❌ | ❌ | ✅ | ✅（独立） |
認知ズレ予防の成果¶
Stage 2 §16-3 環境非対称性見落とし（Entry #20）と同種の事故ゼロ：
- Phase 1 で 11 セクションの実機調査を完遂してから Phase 2 へ
- Phase 2-A で CLAUDE.md cross-reference 先を verbatim 確認してから起草
- Phase 2-D で end-to-end 実機検証（6 項目すべて PASS）
- Phase 3 で v1.14 → v1.15 改訂前に §16 全体構造を Read で把握、anchor 衝突を回避
§0 着手前環境マトリクス検証チェックリスト（v1.14 新設）の規範が Stage 3-A 全 Phase で実証された形。
戦略的含意：2M context window の活用¶
Gemini CLI の 2M context は Claude Opus 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 候補：Gemini Skills 統合 | gemini skills link ~/KUDO-Vault/.claude/skills/kudo/ の実機検証。kudo-* スキル群を Gemini からも参照可能か |
別 Stage 候補・工藤さん判断待ち |
| scheduled-tasks MCP の Gemini 対応 | Gemini 側 ~/.gemini/settings.json に scheduled-tasks を追加すべきか検証 |
★仮説段階・優先度低 |
| Stage 2 Phase 2 判定 | dual-write 期間 1-2 週間後（〜2026-06-05 頃）の運用観察に基づく WorkFlowy 完全廃止判定 | 6 月初旬 |
| Stage 1-E 残件（KUDO-Vault 既存 todo） | Stage 1 系列で着手しなかった項目があれば棚卸し | 未棚卸し |
Stage 3-A 起点の継続観察項目¶
- Gemini CLI 利用頻度：実際に何回 2M context を活かす場面が来るか（ログ）
- wikilink 展開指示テンプレートの有効性：実運用で「リンク先も読んで」明示が機能しているか
- 4 軸判定の妥当性：判定が割れるケースが想定より多くないか
個人設定 v5.4 差分提案¶
Phase 3-E で ~/working/_claude_workspace_global/handoffs/personal-settings-v5.4-draft.md を起草。
Chat 経由で工藤さんに UI 反映依頼（claude.ai > カスタマイズ）。
主な差分：
- ヘッダー：v5.3 → v5.4（2026-05-22）・Gemini CLI 統合追加
- 項目 14 主要スキル直接参照リストに以下を追加：
- Gemini CLI 統合・4 環境マトリクス → kudo-cowork-code-handoff-protocol#gemini-integration（v1.15 新設）
- Vault Gemini CLI 起動指示 → ~/KUDO-Vault/GEMINI.md（v1.1）
その他項目は変更なし。
結論¶
Stage 3-A は 完全成功。工藤拓真の AI 環境は 4 ノード体制として正式に確立し、用途分担は機械判別可能化された。 2M context という新たな分析次元を獲得し、Stage 2 教訓「実機検証ベース進行」が Stage 3-A 全 Phase で実証された。