コンテンツにスキップ

KUDO-Vault Stage 0 完了報告

結論

  • 完遂：Phase 0〜5 全工程
  • Phase 0（環境確認＋スキル探索）
  • Phase 1（骨格）
  • Phase 2（初期4ファイル）
  • Phase 3（obsidian-skills clone）
  • Phase 4（Git初期化＋初回commit）
  • Phase 5（Claude Code & Desktop への MCP 登録＋接続検証）
  • 配置先確定：~/KUDO-Vault（ホーム直下）— ~/working/ が Google Drive 同期配下と判明したため、工藤氏の選択により集中原則から外して非同期配置を選定
  • 追記：同日中に工藤氏が HANDOFF §1 GUI 作業完了 → Phase 5 を追実行。HTTPS 27124 は Claude Code 側で自己署名証明書により Failed to connect、HTTP 27123 にフォールバックして接続成功

Phase 0 探索結果

A1. 既存 kudo-* スキル実体ルート

特定箇所：~/.claude/skills/

~/.claude/skills/kudo-client-template-factory
~/.claude/skills/kudo-ecosystem-cascade-protocol
~/.claude/skills/kudo-pptx-postprocess-validator
~/.claude/skills/kudo-personal-settings-changelog
~/.claude/skills/kudo-deck-aesthetic-qa
~/.claude/skills/kudo-skill-tree-ssot-map

所見：ローカルファイル実体は 6 件のみ。system-reminder の available-skills には anthropic-skills:kudo-* 名義で 40〜50 件が列挙されているため、大半は plugin / .skill 配信側に存在すると推定。Stage 1 の移植時は ① ローカル 6 件＋② plugin 側スキル一覧（~/Library/Application Support/Claude/ 配下 .skill ZIP 群）の二段で取得元を整理する必要がある。

~/Library/Application Support/Claude/skills/ は 空ディレクトリ（plugin インストール先は別パスの模様）。

A2. ~/working/ 同期状態

~/working → /Users/kudotakuma/Library/CloudStorage/GoogleDrive-kudotakuma421@gmail.com/マイドライブ/working

シンボリックリンクで Google Drive マイドライブ配下を指す。HANDOFF Phase 0 判断条件「同期配下なら停止して相談」に該当。

A3. ボルト位置の最終確定値

~/KUDO-Vault（ホーム直下／非同期）に確定。

工藤氏判断の根拠（Claude Chat が提示した3択から）： - ① ~/KUDO-Vault（ホーム直下／非同期）← 選択 - ② ~/working/KUDO-Vault（Drive 同期＋除外設定） - ③ ~/Documents/KUDO-Vault

.obsidian/ 配下の高頻度更新ファイル（workspace*, cache）と Google Drive の常時同期が衝突するリスク、Obsidian 公式が Google Drive 同期を非推奨と明言している事実から、Obsidian 公式推奨に沿う ① を採用。バックアップは別途 git remote push で確保する想定（Stage 1 以降）。

実行コマンドと結果

Phase 0

  • git --version → git version 2.49.0
  • claude mcp --help → 利用可
  • node --version → v26.0.0
  • npx --version → 11.12.1
  • find ~/.claude/skills -name 'kudo-*' → 6件
  • readlink -f ~/working → Google Drive 配下確認
  • ls -d ~/KUDO-Vault → 未作成（OK）

Phase 1 — 骨格作成

mkdir -p ~/KUDO-Vault/.claude/skills
mkdir -p ~/KUDO-Vault/memory/{decisions,insights}
mkdir -p ~/KUDO-Vault/00-Inbox/workflowy-import
mkdir -p ~/KUDO-Vault/{01-Projects,02-Areas,03-Resources,04-Archive,logs}
touch ~/KUDO-Vault/memory/mistakes.md
→ 11 ディレクトリ作成完了。find で全パス確認済み。

Phase 2 — 初期ファイル生成

  • ~/KUDO-Vault/CLAUDE.md — Operating Manual（HANDOFF §2-1 通り）
  • ~/KUDO-Vault/memory/MEMORY.md — 記憶インデックス（YAML frontmatter付き、updated: 2026-05-18）
  • ~/KUDO-Vault/memory/voice.md — 声・好みプレースホルダ（Stage 1 で記入予定）
  • ~/KUDO-Vault/.claude/CLAUDE.md — Claude Code 向けスコープ指示（親 CLAUDE.md パスを ~/KUDO-Vault/CLAUDE.md に更新済み）

Phase 3 — obsidian-skills clone

git clone https://github.com/kepano/obsidian-skills ~/KUDO-Vault/.claude/skills/obsidian-skills
→ 5 スキル確認：defuddle / json-canvas / obsidian-bases / obsidian-cli / obsidian-markdown

Phase 4 — Git 初期化

cd ~/KUDO-Vault && git init && git add -A && git commit -m "Stage 0: KUDO-Vault skeleton + obsidian-skills"
- .gitignore 作成（HANDOFF 仕様通り：workspace, cache, .env, .key, *.crt, .DS_Store） - commit ede241a 作成完了 - 7 files changed, 76 insertions

検証チェックリスト

  • Phase 0：kudo-* スキル実体ルートを特定し記録（~/.claude/skills/ の 6 件、plugin 側は別途）
  • Phase 0：~/working/ の同期状態を確認（Google Drive 同期配下と判明、相談・代替配置決定済み）
  • Phase 1：~/KUDO-Vault の 11 ディレクトリ存在確認
  • Phase 2：CLAUDE.md / .claude/CLAUDE.md / memory/MEMORY.md / memory/voice.md / memory/mistakes.md 全て存在
  • Phase 3：obsidian-skills の 5 スキルが clone 済み
  • Phase 4：Git 初期化済み・初回コミット完了
  • Phase 5：claude mcp list に obsidian 表示 — ✓ Connected
  • Phase 5：MEMORY.md の REST API 読み取り成功（YAML frontmatter＋本文取得確認）
  • Phase 5：Claude Desktop 設定マージ完了・.bak.2026-05-18 退避済み（既存 workflowy 保持・16 preferences 全保持）
  • 既存 kudo-* スキルは読み取り以外一切変更なし

Phase 5 実行ログ（追記：§1 GUI 完了後の追実行）

疎通テスト結果

エンドポイント 結果 用途
https://127.0.0.1:27124/ HTTP 200 REST API 本体
http://127.0.0.1:27123/ HTTP 200 HTTP フォールバック
https://127.0.0.1:27124/vault/ 200・ボルト内容取得 ボルト認識確認
https://127.0.0.1:27124/mcp/ (POST initialize) 200・MCP capabilities 返却 MCP プロトコル疎通
http://127.0.0.1:27123/mcp/ (POST initialize) 200・MCP capabilities 返却 MCP プロトコル疎通

MCP サーバー情報：obsidian-local-rest-api v1.0.0、capabilities = resources/completions/tools（listChanged あり）

Claude Code MCP 登録

  • 初回 HTTPS 27124 で登録 → claude mcp list で「✗ Failed to connect」（自己署名証明書の信頼問題）
  • HTTP 27123 で再登録 → ✓ Connected
  • 設定ファイル：~/.claude.json 更新

Claude Desktop MCP 登録

  • バックアップ：~/Library/Application Support/Claude/claude_desktop_config.json.bak.2026-05-18（1927 bytes）
  • python3 で安全マージ実施（既存 workflowy MCP・16 preferences すべて保持）
  • 登録形式：mcp-remote@latest bridge 経由
  • command: npx
  • args: ["mcp-remote@latest", "http://127.0.0.1:27123/mcp/", "--header", "Authorization: Bearer <KEY>"]
  • 未検証事項：Claude Desktop を再起動して実際に obsidian MCP が読み込まれるかは未確認（Desktop アプリの再起動が必要）

工藤氏への申し送り

  1. Claude Desktop の再起動を推奨：merge した設定を Desktop が読み込むためには再起動が必要。再起動後、Desktop の MCP インジケータで obsidian が表示されることを確認してください
  2. 本セッションの API Key 露出：API Key は本会話の "API Key受渡" 回答・curl ログ・claude mcp add ログ・Bash 履歴に露出しています。Stage 0 完了後、本セッションを /clear するか、必要なら Obsidian 側で API Key を再生成してください
  3. HTTPS 自己署名を使いたい場合：将来 HTTPS 経路に切り替えるなら、mkcert でローカル CA を作って Obsidian Local REST API 設定の "Certificate" を差し替える方法があります（Stage 2 検討範囲）
  4. ~/KUDO-Vault に 無題のファイル.md が自動生成：Obsidian 起動時に作られたと思われる空ファイル。Stage 1 着手前に削除推奨

既知の留意点（Phase 4 git init 時に検出）

  1. obsidian-skills が gitlink (mode 160000) で取り込まれた
  2. 内側にも .git/ がある状態で git add -A した結果、submodule ではなく gitlink になっています。
  3. 影響：このボルトを git clone で別マシンに展開しても obsidian-skills/ 内のファイルは復元されません（pointer のみ）。

  4. Stage 0 では vault の共有計画がないため実害なし。Stage 1 以降で公開リポジトリにする場合は git submodule add への変換を推奨。

  5. 空ディレクトリは commit に含まれていない

  6. 00-Inbox/ 01-Projects/ 02-Areas/ 03-Resources/ 04-Archive/ logs/ memory/decisions/ memory/insights/ 00-Inbox/workflowy-import/ は中身が無いため git に記録されていません。
  7. ディスク上には存在しますが、git clone で復元したい場合は各ディレクトリに .gitkeep を置く必要があります。

  8. Stage 1 で実コンテンツが入れば自然解消するため、Stage 0 では放置で問題なし。

  9. git ユーザー名・メールが自動推定

  10. 工藤拓真 <kudotakuma@kudoutakushinnoMacBook-Pro.local> で commit されています。
  11. 公開リポジトリに push する場合は git config user.email の調整を推奨。

Stage 1 着手条件のリマインダ

HANDOFF §5 の通り、Stage 0 が「1週間・5セッション以上、障害なし」をクリアした後 に Stage 1 着手。

Stage 1 で扱う予定： - 既存 kudo-* の ~/KUDO-Vault/.claude/skills/kudo/ への移植（移植元：本報告 Phase 0 で特定した 6 件＋plugin 側スキル） - kudo-workflowy-double-save → kudo-triple-store-write 改訂 - kudo-context-routing のルーティング再定義 - kudo-cowork-code-handoff-protocol への「制約遭遇時の HANDOFF 変換プロトコル」追記 - Pilot 案件 1 件の 01-Projects/ 移植 - 新規スキル kudo-process-inbox / kudo-write-decision 作成

非破壊保証の確認

Stage 0 で行ったすべての操作は rm -rf ~/KUDO-Vault で完全に巻き戻せます。~/.claude/skills/ 内の既存 kudo-* スキルには read 以外一切触れていません。

ファイル一覧（Stage 0 で作成・変更したもの）

新規作成（Drive 同期外）： - ~/KUDO-Vault/ 配下一式（骨格 11 ディレクトリ＋ファイル 7 本＋obsidian-skills clone） - ~/KUDO-Vault/.git/ 配下（初回 commit ede241a）

新規作成（Drive 同期内）： - ~/working/_claude_workspace_global/reports/stage0-completion-2026-05-18.md（本ファイル）

変更（Phase 5 で追加）： - ~/.claude.json：mcpServers.obsidian 追加（user scope） - ~/Library/Application Support/Claude/claude_desktop_config.json：mcpServers.obsidian 追加（既存 workflowy・preferences は保持） - バックアップ：claude_desktop_config.json.bak.2026-05-18

変更なし： - ~/.claude/skills/ 配下の既存スキル全て - ~/working/ 配下の他全ファイル