コンテンツにスキップ

KUDO-Vault Stage 1-A 完了報告

結論

  • 完遂:3 タスク全完了
  • タスク1:Stage 0〜0.5 の意思決定経緯を ADR 形式で memory/decisions/ に記録
  • タスク2:既存 kudo-* スキル 47 件を全件棚卸し
  • タスク3:仕分け案を 4 カテゴリ(R / M / D / 要相談)に振り分け
  • 仕分け案集計:R 21 件(うち確定済み 5)/ M 24 件 / D 0 件 / 要相談 2 件
  • 重要な発見:棚卸し中に Drive sync 欠落 3 件・YAML frontmatter 不整合 3 件・数字drift 2 件を検出(修正はせず記録のみ)
  • 非破壊保証:既存 SKILL.md ファイルは読み取りのみ。改訂・移動・削除は一切なし。
  • Git:KUDO-Vault に commit fb1b375 を作成。

タスク1:Stage 0〜0.5 ADR 記録

出力ファイル

  • ADR 本体:~/KUDO-Vault/memory/decisions/2026-05-18-kudo-vault-stage0-setup.md
  • インデックス追記:~/KUDO-Vault/memory/MEMORY.md「直近の重要な意思決定」欄に1行リンク - [[memory/decisions/2026-05-18-kudo-vault-stage0-setup]]

構成(標準 ADR 形式)

  1. Status:Accepted
  2. Context:元の課題(三重保存・Chat の WorkFlowy MCP 不能・マルチAI分断)
  3. Decision:D1〜D5
  4. D1:AI 外部記憶の正本を Obsidian Vault(~/KUDO-Vault)に置く
  5. D2:WorkFlowy は廃止せず、役割を「人間専用キャプチャツール」に縮退
  6. D3:マルチAIアクセス整備(Claude Code/Desktop/Gemini CLI に MCP 登録)
  7. D4:Chat / Cowork からの Vault 直接接続は Stage 2 据え置き(Anthropic issue #123 待ち)
  8. D5:Vault 配置は「集中原則の正規の特例」として正式化
  9. Consequences:達成事項/トレードオフ/実環境差分 5 件
  10. Next Actions:Stage 1-A〜1-D + Stage 2 の段取り

情報源

~/working/_claude_workspace_global/reports/ 配下の以下を事実ベースで参照: - stage0-completion-2026-05-18.md - stage0-5-completion-2026-05-18.md - 20260518-obsidian-mcp-fix-and-gemini-vault-sync.md


タスク2:スキル棚卸し

出力ファイル

~/working/_claude_workspace_global/master-lists/kudo-skills-inventory-2026-05-18.md

総数と内訳

  • 総数:47 件
  • canonical 実体ルート/Users/kudotakuma/Library/CloudStorage/GoogleDrive-kudotakuma421@gmail.com/マイドライブ/working/claude/kudo-skill-sync/skills/(Drive 同期下、44 件)
  • 補完ルート~/.claude/skills.git-mirror/snapshots/2026-05-18/(3 件・Drive sync 欠落分)

動詞群別内訳

  • 動詞群 1(戦略や企画を考える):6 件
  • kudo-mitate, kudo-strategy-houshin, kudo-marketing-strategy, kudo-brand-architecture, kudo-brand-lens, kudo-strategist-lens-library
  • 動詞群 2(ことばをかく):5 件
  • kudo-writing, kudo-binary-fusion, kudo-audience-simulation, kudo-source-verification, ※ kudo-writing 以下の 3 件はすべて子
  • 動詞群 3(資料をつくる):11 件
  • kudo-proposal-deck(親)と 9 子+ kudo-pptx-postprocess-validator
  • 動詞群 4(ことば以外をつくる):11 件
  • kudo-design-generation-loop(親)と 5 子+kudo-designer-lens-library 等
  • 動詞群 5(Skillを管理する):11 件
  • kudo-persist-settings / kudo-cowork-code-handoff-protocol 等
  • 動詞群 不明(5(推定)):3 件 — SNAP_ONLY スキルで YAML frontmatter 不完全
  • kudo-ai-error-watchlist, kudo-mac-health-check, kudo-shared-storage-protocol

機械検出された言及(grep)

各 SKILL.md について以下キーワードの出現を grep で機械検出:WorkFlowy三重保存Claudeメモリプロジェクトファイル保存先context-routing

inventory 表の「言及」列に出現キーワードを記載。仕分け判断の補助情報として使用したが、grep ヒットの有無で機械的に R/M を決めず、実コンテキスト(boilerplate か core 機能か)を読んで判定した。

想定数との差分

HANDOFF 本文の「当初想定(約50)」に対して実数 47。乖離は 3 件で許容範囲内。 ただし kudo-skill-cross-reference-resolver 自身の description は「48 スキル」、kudo-skill-tree-ssot-map は「全 54 スキル」と記述しており、メタスキル自身が現状の数を把握できていない(後述「重要な所見」参照)。


タスク3:仕分け案(提案・確定権なし)

集計

カテゴリ 件数 内訳
R(改訂必要) 23 HANDOFF §3 で確定済み 5 + CLAUDE.md §3/§4.3 参照の boilerplate 8 + その他 memory/SSOT 依存 10(旧要相談 2 件を含む)
M(そのまま移植) 24 純粋方法論/純粋技術プロトコル
D(廃止候補) 0 該当なし
要相談 0 2026-05-18 工藤氏判断で 2 件とも R に確定

2026-05-18 仕分け確定(要相談 2 件 → R 確定)

工藤氏判断により、旧「要相談」2 件は両方とも R(改訂必要) に確定:

  • kudo-personal-settings-changelog → R
  • 改訂方針:守備範囲を「個人設定の変更履歴」から「個人設定+ Vault memory 主要変更」まで拡張する
  • kudo-skill-extraction → R
  • 改訂方針:暗黙知の抽出源に Vault memory/insights/00-Inbox/ を追加する(WorkFlowy のみだった §52・§85 を Vault-aware に書き換え)

これで Stage 1-A 仕分けは 47 件すべて確定R23 / M24 / D0 / 要相談0。 Stage 1-B(移植)の HANDOFF は Chat 側で起票。

R(改訂必要)— 23 件

R 確定済み(HANDOFF §3)— 5 件

  • kudo-ai-error-watchlist
  • kudo-context-routing
  • kudo-cowork-code-handoff-protocol
  • kudo-shared-storage-protocol
  • kudo-workflowy-double-save

CLAUDE.md §3/§4.3 参照の 8 スキル boilerplate — 8 件

(CLAUDE.md global header に「8 スキルが §3/§4.3 を一次ソースとして参照」と明記されている本人) - kudo-autonomous-execution-protocol - kudo-brand-architecture - kudo-deck-generation-router - kudo-design-mockup - kudo-designer-lens-library - kudo-presenter-lens-library - kudo-proposal-deck - kudo-schedule-budget

これら 8 スキルは SKILL.md 冒頭付近に共通の boilerplate ブロック「本スキルはカラー/フォント/保存先パス/NFC-NFD対策/…/WorkFlowyノードID/…の『定義』をハードコードしない。CLAUDE.md §3「作業環境」、§4「WorkFlowyへの書き込みルール」を一次ソース」を持つ。 Vault 移行で WorkFlowy / 保存先の定義が変わると、boilerplate の参照リンクが腐敗するため一律 R。

その他 R(memory/SSOT/ストレージ直接依存、旧要相談 2 件を含む)— 10 件

  • kudo-ecosystem-cascade-protocol — 4層SSOT生態系の編集アルゴリズム(memory 層が Vault に変わる)
  • kudo-gemini-image-bridge — 起動ごとに WorkFlowy へ生成枚数記録(kudo-workflowy-double-save 連携)
  • kudo-html-publish — Copy as Markdown ボタンで WorkFlowy 転記、context-routing 参照
  • kudo-naming-unification-protocol — 表記揺れを 4 経路(WorkFlowy/クラウド/プロジェクト/ファイル名)で検出
  • kudo-persist-settings — 記憶の仕組み・設定保存・ハードコード禁止の統治
  • kudo-personal-settings-changelog ★ — 守備範囲を Vault memory 主要変更まで拡張(2026-05-18 工藤氏確定)
  • kudo-project-state-recovery — 三重保存を前提とした状態再構成
  • kudo-skill-cross-reference-resolver — SSOT マップ regen のメタ
  • kudo-skill-extraction ★ — 抽出源に Vault memory/insights/00-Inbox/ を追加(2026-05-18 工藤氏確定)
  • kudo-skill-tree-ssot-map — kudo-skill-cross-reference-resolver の自動出力先

M(そのまま移植)— 24 件

純粋方法論/純粋技術プロトコル。memory architecture 非依存。詳細は inventory 表参照。 - 動詞群1:kudo-mitate / kudo-strategy-houshin / kudo-marketing-strategy / kudo-brand-lens / kudo-strategist-lens-library - 動詞群2:kudo-writing / kudo-binary-fusion / kudo-audience-simulation / kudo-source-verification - 動詞群3:kudo-briefing / kudo-client-template-factory / kudo-deck-aesthetic-qa / kudo-deck-faithful-redesign / kudo-pptx-postprocess-validator - 動詞群4:kudo-ad-kv-composition / kudo-design-generation-loop / kudo-logo-craft-protocol / kudo-motion-kv-composition / kudo-package-design-protocol / kudo-spatial-experience-design / kudo-verbal-to-visual-bridge - 動詞群5:kudo-mac-health-check(※SNAP_ONLY) / kudo-skill-md-format-validator / kudo-three-mode-protocol

D(廃止候補)— 0 件

該当なし。鬱屈で M / 要相談 に倒した方が安全だったケースが複数あり、本仕分けで D は採用していない。 Stage 1-B 以降で工藤氏判断で D に倒す候補は出ることがあり得るが、それは Code 側からは提案しない。

要相談 — 0 件(2026-05-18 確定)

旧「要相談」2 件は工藤氏判断で両方とも R(改訂) に確定(上記 R 一覧 ★ 印参照)。

1. kudo-personal-settings-changelog → R 確定

  • 改訂方針:守備範囲を「個人設定の変更履歴」だけでなく「個人設定+ Vault memory 主要変更」まで拡張する
  • kudo-persist-settings の改訂と整合させる

2. kudo-skill-extraction → R 確定

  • 改訂方針:暗黙知の抽出源に Vault memory/insights/00-Inbox/ を追加する
  • WorkFlowy のみだった §52・§85 を Vault-aware に書き換え
  • Stage 1-D で予定の kudo-process-inbox と接続する設計に

棚卸し中に気づいた既存スキルの問題(記録のみ・修正なし)

問題1:Drive sync 欠落 3 件

スキル mtime 所在
kudo-ai-error-watchlist 2026-05-16 ~/.claude/skills.git-mirror/snapshots/2026-05-18/ のみ
kudo-mac-health-check 2026-05-14 同上
kudo-shared-storage-protocol 2026-05-16 同上

いずれも Drive 同期下の canonical 位置(~/working/claude/kudo-skill-sync/skills/)に存在しない。 snapshot mirror(バックアップ)にしかない状態。比較的新しく作成されたスキル(2026-05-14〜2026-05-16)。

示唆:Drive sync 経路が壊れている可能性。kudo-persist-settings §設定ファイル所在マップ SSOT の Step 7「形骸化検出プロトコル」に該当する状態。 Stage 1-B の Vault 移植は snapshot mirror から救済可能だが、canonical sync 経路を直すべき

問題2:YAML frontmatter 不整合(同 3 件)

上記 3 件のスキルはいずれも YAML frontmatter に verb_group / parent フィールドを持たない(namedescription のみ)。 kudo-skill-cross-reference-resolver#schema-spec の標準に未準拠。 Stage 1-B 移植時に補完すべき。

問題3:description 内の数字 drift

  • kudo-skill-cross-reference-resolver:description に「48 スキルの SSOT マップを自動生成」(実態 47)
  • kudo-skill-tree-ssot-map:description に「全 54 スキルの anchors 辞書」(実態 47)

メタスキル自身が現状を把握できていない。 description は claude.ai 保存UI制約で 1024 字以内かつ単一行なので、機械同期は難しいかもしれない。

問題4:kudo-skill-tree-ssot-map の手動編集禁止が機能していない可能性

description に「手動編集禁止(次回 regenerate で上書きされる)」と明記されているが、 数字が 54→47 に追従していない事実から、regenerate cron が止まっているか source-of-truth path が間違っている可能性。 ~/.claude/scripts/regenerate_ssot_map.py の状態確認推奨。


検証チェックリスト

  • タスク1:memory/decisions/2026-05-18-kudo-vault-stage0-setup.md を ADR 形式で作成。reports/ の事実を反映
  • タスク1:MEMORY.md の「直近の重要な意思決定」欄にリンク追記
  • タスク2:全 kudo-* スキルを棚卸し、master-lists/kudo-skills-inventory-2026-05-18.md に表出力
  • タスク3:inventory 表に「仕分け案」「理由」列を追加。ルーブリック厳守
  • タスク3:D 振り分けスキルは 0 件(実際に削除・移動なし)
  • 全タスク非破壊:既存スキルファイルは読み取りのみ。改訂・移動・削除なし
  • Git:~/KUDO-Vault の変更(decisions追加・MEMORY.md更新)を commit fb1b375 で記録

工藤さんへの申し送り

1. 要相談 2 件は工藤氏判断で R 確定済み(2026-05-18)

旧「要相談」だった kudo-personal-settings-changelogkudo-skill-extraction は両方とも R(改訂) に確定。改訂方針は本報告の R 一覧 ★ 印参照。Stage 1-B 着手の前提条件はクリア。

2. Drive sync 欠落 3 件の取扱い

Stage 1-B Vault 移植時は snapshot mirror を採用すれば一時救済できるが、Drive sync 経路自体は壊れたまま。 本問題は「Stage 1 の射程に含めるか」を Chat 側で判断推奨。 - 含める案:snapshot から Drive へ rsync する手当てを Stage 1-B に追加 - 含めない案:Vault 移植を済ませ、Drive sync 復旧は別タスクとして切り出し

3. regenerate_ssot_map.py の状態確認推奨

description 数字 drift と SNAP_ONLY 3 件は、SSOT 生成パイプラインの稼働状況にも示唆がある。 本 Stage 1-A の射程外だが、Stage 1-C で kudo-skill-cross-reference-resolver を改訂する前に cron 状態を確認しておくと無駄足が減る。

4. Stage 1-B HANDOFF 起票の前提条件

  • 要相談 2 件の確定
  • Drive sync 欠落 3 件への対応方針
  • これら 2 つが揃えば Stage 1-B(移植)の HANDOFF を起票可能

ファイル一覧

新規作成

  • ~/KUDO-Vault/memory/decisions/2026-05-18-kudo-vault-stage0-setup.md(ADR)
  • ~/working/_claude_workspace_global/master-lists/kudo-skills-inventory-2026-05-18.md(inventory)
  • ~/working/_claude_workspace_global/reports/stage1a-completion-2026-05-18.md(本ファイル)

変更

  • ~/KUDO-Vault/memory/MEMORY.md(直近の重要な意思決定欄に1行リンク追記)
  • ~/KUDO-Vault/ git:commit fb1b375 作成

変更なし(非破壊保証)

  • ~/.claude/skills/ 配下の既存スキル全て
  • ~/Library/CloudStorage/GoogleDrive.../working/claude/kudo-skill-sync/skills/ 配下の既存スキル全て
  • ~/.claude/skills.git-mirror/snapshots/ 配下の全 snapshot
  • ~/.claude/CLAUDE.md(global)
  • ~/.gemini/settings.json(Gemini CLI 設定)
  • ~/.claude.json(Claude Code MCP 設定)
  • ~/Library/Application Support/Claude/claude_desktop_config.json(Desktop MCP 設定)
  • ~/working/_claude_workspace_global/ 配下の他全ファイル
  • WorkFlowy(一切触らず)

補足:使用ツール

  • 棚卸し抽出:/tmp/inventory_kudo.sh(読み取りのみ/非破壊)
  • 集計・MD 生成:/tmp/build_inventory.py(読み取りのみ/非破壊)
  • いずれも実行終了で消える /tmp 配下。永続化必要なし。