KUDO-Vault — Operating Manual for Claude¶

⚠ このファイルは KUDO-Vault における Vault 書込ルールの SSOT(Single Source of Truth)である。フォルダ構造・命名規則・Obsidian 構文・安全規則の正本としてここに集約され、他の SKILL.md やドキュメントは本書を参照する。直接編集できるのは工藤氏のみ。AI(Claude / Gemini)は参照のみ。改訂が必要な場合は §9 の編集プロトコルに従う。

0. このファイルの位置づけ¶

KUDO-Vault は工藤拓真の AI 外部記憶アーキテクチャ。Obsidian Vault としてローカルに存在し、Git で版管理され、GitHub private repo にバックアップされる。本ファイル ~/KUDO-Vault/CLAUDE.md は、AI(Claude Code / Claude Desktop / Gemini CLI 等)が Vault を読み書きするための運用指示書兼 SSOT である。

0.1 SSOT 領域¶

本ファイルが正本として定義するのは以下：

ボルト全体の論理構造(フォルダ構成と各フォルダの責任範囲)
ファイル命名規則
YAML frontmatter 規則
Obsidian 構文(wikilink / embed / callout)
安全規則(rename / move / graph view / inbound link 走査)
AI 運用指示(セッション開始手順 / 1 行報告 / 振り分け基準)
スコープ外定義(WorkFlowy 連携 / 機密情報の扱い)

詳細な Obsidian 構文や検証ロジックは .claude/skills/obsidian-skills/(kepano 公式 obsidian-skills)に委ねる。本ファイルはそこへの参照と、本 Vault 固有の規律を補う。

0.2 参照関係¶

本ファイルは他スキルから参照される正本：

kudo-triple-store-write ← Vault 書込ルールを本ファイルから参照
kudo-context-routing ← Vault フォルダ構造を本ファイルから参照
kudo-shared-storage-protocol ← 機密情報の扱いを本ファイルから参照
その他多数(kudo-skill-tree-ssot-map 参照)

逆に、本ファイルから参照する正本：

kepano/obsidian-skills ← Obsidian 構文の詳細
kudo-skill-cross-reference-resolver ← anchor_id 方式の詳細
個人設定項目 12 ← GitHub ホスティング原則

1. ユーザー¶

工藤拓真。ブランディング専門家／クリエイティブディレクター。複数のクライアント案件を並行。本 Vault の唯一の直接編集者。AI は工藤氏の指示・承認に基づいて Vault を更新する。

2. ボルト構造¶

~/KUDO-Vault/
├── CLAUDE.md             ← 本ファイル(Vault SSOT)
├── MEMORY.md             ← Claude の長期記憶要約(セッション開始時に必読)
├── 00-Inbox/             ← 未処理キャプチャ
│   └── workflowy-import/ ← WorkFlowy からの取込
├── 01-Projects/          ← 進行中のクライアント案件
│   └── {案件名}/
│       └── _MOC.md       ← 案件マップ(セッション開始時に必読)
├── 02-Areas/             ← 継続領域(ブランディング知見・健康・X 戦略 等)
├── 03-Resources/         ← 参考資料
│   └── research/         ← リサーチレポート集
├── 04-Archive/           ← 完了案件
├── memory/               ← Claude が書く記憶領域
│   ├── decisions/        ← ADR(YYYY-MM-DD-<topic>.md)
│   ├── insights/         ← 横断的気づき
│   └── mistakes.md       ← 失敗ログ
├── logs/                 ← セッションログ
├── .claude/              ← Claude Code 設定とスキル
│   └── skills/
│       ├── obsidian-skills/  ← kepano 公式
│       └── kudo/             ← 工藤氏のカスタムスキル
├── .obsidian/            ← Obsidian 設定(.gitignore で除外)
└── .git/                 ← Git

2.1 各フォルダの責任範囲¶

00-Inbox/：未処理キャプチャの一時置き場。 - 入れる：処理待ちのメモ・WorkFlowy からの取込・新規アイデア - 入れない：処理済み・分類済みのファイル - トリアージ：将来 kudo-process-inbox スキルで 01〜04 へ振り分け(現状は手動)

01-Projects/：進行中のクライアント案件。 - 入れる：アクティブな案件の作業ファイル・MOC(Map of Content)・関連リサーチ - 入れない：完了した案件(→ 04-Archive へ移動) - 命名規則：{案件名}/_MOC.md を必ず作る。AI はセッション開始時にこれを読む

02-Areas/：継続領域。終わりの無い知識領域。 - 入れる：ブランディング知見・健康ログ・X 戦略・継続的な学習領域 - 入れない：特定案件に紐付くもの(→ 01-Projects へ)

03-Resources/：参考資料。 - 入れる：書籍メモ・リサーチレポート・記事スクラップ・参考デザイン - サブフォルダ：research/ にリサーチレポート集約(STRATEGY-, RESEARCH-, DESIGN-* 系)

04-Archive/：完了案件。 - 入れる：終了した案件・終了領域 - ファイルは削除せず Archive へ移すのが原則(過去参照のため)

memory/：Claude が書く記憶領域。人間(工藤氏)も参照するが、書き込み主体は Claude。 - decisions/：ADR(後述 §6.4) - insights/：横断的気づき - mistakes.md：失敗ログ(追記方式)

logs/:全体セッションログ + Cowork 夜間バッチによる日次ダイジェストアーカイブ(2026-05-22 Stage 2-D-2 で拡張)。 - トップレベル(logs/YYYY-MM-DD-{session-type}.md):セッションログ(従来) - サブフォルダ(logs/YYYY/MM/YYYY-MM-DD-{案件名 kebab-case}.md):Cowork 夜間バッチが書く案件別ダイジェスト(Phase 1 dual-write 期間中の Vault 側書込先) - 詳細運用ルールは logs/README.md を一次ソース(frontmatter 規約 / 整合性チェック / dual-write 期間中の WorkFlowy 並行書込との関係)

.claude/skills/：Claude Code が読むスキル群。 - obsidian-skills/：kepano 公式 obsidian-skills - kudo/：工藤氏のカスタムスキル kudo-*

3. ファイル命名規則¶

3.1 基本ルール¶

kebab-case：ハイフン区切り・小文字(例：kudo-triple-store-write)
日本語可：人間が直接編集するファイルは日本語ファイル名も許容(例：記憶の箱.md)。AI が書くファイルは英数字を推奨
拡張子：Markdown は .md。HTML は .html。CSV は .csv
空白禁止：ファイル名に空白を使わない(wikilink・git・rsync で問題)
特殊文字禁止：/ \ ? * : | " < > および ' "(引用符)を避ける

3.2 日付プレフィックス¶

時系列性が重要なファイルは YYYY-MM-DD- で始める：

ADR：memory/decisions/2026-05-20-stage-1c-roadmap.md
セッションログ：logs/2026-05-20-claude-code.md
完了報告：reports/stage1c-1-completion-2026-05-20.md

3.3 特殊サフィックス¶

_MOC.md：Map of Content。案件・領域のインデックスファイル(例：01-Projects/dof案件/_MOC.md)
-mixed.html：audience-mode mixed の HTML(external + internal セクション混在)
-for-client.html：audience-mode external 純粋型(クライアント提出版)
.bak.YYYY-MM-DD：バックアップファイル(.gitignore で除外推奨)

3.4 自動生成物の命名¶

自動生成されたファイルは冒頭に ⚠ このファイルは自動生成 を明記し、正本へのパスを示す。生成元スクリプトもフッタに記載：

# kudo-skill-tree-ssot-map(自動生成)

> ⚠ このファイルは自動生成。手で編集するな。
> 編集すべきは各 SKILL.md の frontmatter。
> 生成スクリプト：`~/.claude/scripts/regenerate_ssot_map.py`
> 最終更新：2026-05-20

4. YAML frontmatter 規則¶

4.1 基本構造¶

Markdown ファイルの冒頭に YAML frontmatter を置く：

---
title: ファイルのタイトル
created: 2026-05-20
updated: 2026-05-20
tags: [tag1, tag2]
type: adr | insight | mistake | project | area | resource | log | skill
---

--- の前後に空行を置かない(Obsidian の YAML パースが厳格)。

4.2 ファイル種別ごとの必須フィールド¶

ADR(memory/decisions/)：

---
title: <意思決定タイトル>
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: adr
status: proposed | accepted | superseded | rejected
context: <短い文脈・1-2行>
decision: <短い決定・1-2行>
consequences: <短い影響・1-2行>
related:
  - [[wikilink1]]
  - [[wikilink2]]
---

ADR の本文構造は Status / Context / Decision / Consequences の 4 セクション。

insight(memory/insights/)：

---
title: <気づき>
created: YYYY-MM-DD
type: insight
source: <発見元の案件 or 領域>
applies_to:
  - <横展開可能な領域1>
  - <横展開可能な領域2>
---

project(01-Projects/{案件名}/_MOC.md)：

---
title: <案件名>
client: <クライアント名>
status: active | paused | archived
started: YYYY-MM-DD
team:
  - <関係者1>
  - <関係者2>
---

skill(.claude/skills/kudo/{skill-name}/SKILL.md)：

---
name: kudo-{skill-name}
description: <1024 字以内・トリガー条件含む>
parent: <親スキル名 or null>
version: <semver>
anchors:
  <anchor_id>: <セクションタイトル>
naming_aliases:
  - <別名>
---

詳細スキーマは kudo-skill-cross-reference-resolver#schema-spec 参照。

4.3 wikilink の frontmatter 内記法¶

related: [[file-name]]      # 単一参照(一行)
related:                     # 複数参照(リスト形式推奨)
  - [[file-1]]
  - [[file-2]]

[[...]] 形式は YAML の角括弧と紛れる場合があるので、複数参照はインデント付きリスト形式を必ず使う。

5. Obsidian 構文¶

詳細は .claude/skills/obsidian-skills/ を参照。本ファイルでは KUDO-Vault 固有の運用を補足する。

5.1 wikilink¶

[[File]]                  # ファイルへのリンク
[[File#Heading]]          # ファイル内見出しへのリンク
[[File|alias]]            # 表示名を変える
![[File]]                 # embed(ファイル内容を埋め込み)
![[File#Heading]]         # 見出し以下を embed

5.2 wikilink の運用ルール¶

near-match 解決：参照先ファイル名のタイポは kepano 公式 obsidian-skills の olw lint/olw maintain --fix、または obsidian-wikilink-types verify-and-repair で自動検出・修復(Levenshtein ≤ 2 のみ)
死亡リンク禁止：存在しないファイルへの wikilink は作らない。stub を先に作る
rename 影響：ファイル名を変えると inbound link が全部死ぬ。§7 の安全規則に従う
アンカー参照：スキル間参照は実体のセクション見出し(日本語・変わりうる)ではなく、frontmatter anchors: で定義した anchor_id(英数字・不変)で指す。詳細：kudo-skill-cross-reference-resolver

5.3 callout¶

> [!NOTE]
> 通常のメモ

> [!WARNING]
> 警告

> [!IMPORTANT]
> 重要

> [!TIP]
> ヒント

> [!QUESTION]
> 質問・要確認(工藤氏に判断を求める箇所)

工藤氏が AI に判断を求める箇所、または AI が工藤氏に判断を求める箇所は > [!QUESTION] でマークする。

5.4 embed の運用¶

embed(![[...]])は同期表示。embed 元のファイルが変わると embed 先も自動更新される。SSOT 二重化を避ける強力なツール：

案件の MOC ヘッダ → embed で再利用
カラーパレット定義の表示 → 個人設定からの embed
スキルのトリガー条件一覧 → frontmatter からの embed

ただし embed しすぎると graph view が複雑化する。SSOT の正本に直接 embed するのは推奨だが、孫引きの embed は避ける。

6. AI(Claude / Gemini)運用指示¶

6.1 セッション開始時の必読リスト¶

本ファイル ~/KUDO-Vault/CLAUDE.md(毎セッション・必読)
~/KUDO-Vault/MEMORY.md(毎セッション・必読)
該当案件の 01-Projects/{案件名}/_MOC.md(案件作業時)
関連スキル .claude/skills/kudo/{skill-name}/SKILL.md(トリガー時)

6.2 1 行報告¶

読み書きしたファイルは工藤氏に 1 行で報告：

Read: ~/KUDO-Vault/memory/decisions/2026-05-20-stage-1c-roadmap.md
Wrote: ~/KUDO-Vault/01-Projects/dof案件/_MOC.md (added Phase 5 section)

冗長な要約は不要。「何を、何に対して、どうしたか」だけ。長時間自律実行時の詳細は HANDOFF 規定の完了報告ファイルに集約。

6.3 振り分け基準¶

種別	配置先	命名
意思決定(このプロジェクトでこう決めた)	memory/decisions/	YYYY-MM-DD-.md
横断的気づき(他案件に応用可)	memory/insights/	YYYY-MM-DD-.md
失敗(再発防止のため記録)	memory/mistakes.md	追記
案件固有作業	01-Projects/{案件名}/	案件命名規則に従う
継続領域の知見	02-Areas/{領域}/	kebab-case
参考資料	03-Resources/	出典明示
リサーチレポート	03-Resources/research/	RESEARCH- / STRATEGY- / DESIGN-*
完了案件	04-Archive/	元の名前で移動
セッションログ	logs/	YYYY-MM-DD-{session-type}.md

6.4 ADR の書き方¶

---
title: Stage 1-C ロードマップ修正
created: 2026-05-20
updated: 2026-05-20
type: adr
status: accepted
context: Stage 1-C 着手準備で 5 つの実機発見が確定、当初計画の前提が崩壊
decision: Stage 1-C を 5 段階構成に再設計(1-C-1〜1-C-5)
consequences: CLAUDE.md 充実が前提条件、中核スキル改訂を診断より先行
related:
  - [[STRATEGY-stage1c-roadmap-revision]]
  - [[HANDOFF-kudo-vault-stage1c-prep]]
---

## Status
accepted

## Context
Stage 1-C 着手準備 HANDOFF の Code 完了報告で 5 つの実機発見が…(本文)

## Decision
Stage 1-C を 5 段階に再設計：
1. CLAUDE.md 充実
2. 中核スキル改訂
3. 47件健全性レビュー
4. 残り R23 改訂
5. 健全性スキャナ常設化

## Consequences
- CLAUDE.md 充実が完了するまで Stage 1-C-2 着手不可
- 47 件診断の中で anchor 一括補完を実施
- 健全性スキャナは Phase 5 で cron 化

7. 安全規則(最重要)¶

7.1 人間ノート上書き禁止¶

工藤氏が書いたノート(特に手書きの記憶・思考の断片)を AI が上書きしない。追記または日付付き新規ファイルで対応する：

❌ NG:工藤氏の 01-Projects/dof案件/_MOC.md の既存セクションを書き換える
✅ OK:新しいセクションを末尾に追加する
✅ OK:別ファイル 01-Projects/dof案件/2026-05-20-claude-summary.md を作る

判断に迷ったら別ファイル化。

7.2 rename / move 前の inbound link 走査¶

ファイル名を変える・移動する前に、そのファイルへの inbound link を全部洗い出す。

走査コマンド:

grep -rln "\[\[ファイル名" ~/KUDO-Vault --include="*.md"
grep -rln "\[\[ファイル名#" ~/KUDO-Vault --include="*.md"

inbound link が 1 件でもあれば、rename / move 後にそれを更新するか、stub を残す。一括更新は obsidian-skills の olw maintain --fix で安全に実行可能(Git-aware・自動コミット)。

7.3 graph view 出現ファイルの rename 制限¶

Obsidian の graph view に出ているファイル(= inbound link を持つファイル)は、工藤氏の明示的承認なしに rename しない。AI が勝手に rename すると graph 構造が壊れる。

7.4 安全地帯¶

AI が比較的自由に編集できる「安全地帯」:

00-Inbox/:未処理キャプチャ。AI が分類・移動してよい
memory/:AI 自身が書いている領域(mistakes.md は追記のみ)
inbound link がゼロの新規 draft:作ったばかりで、まだ誰からも参照されていないファイル
logs/:日付付きセッションログ

それ以外は、編集前に inbound link 走査と工藤氏承認を経る。

7.5 危険操作の事前確認¶

以下の操作は必ず工藤氏に事前確認:

ファイル削除(移動でなく削除)
大量 rename(10 件以上の一括 rename)
フォルダ構造変更
.gitignore 変更
自動生成物の手編集(生成スクリプトを直すべき)
.git/ 配下の操作(履歴 rewrite 等)

8. ツール参照とスコープ外¶

8.1 obsidian-skills(kepano 公式)¶

.claude/skills/obsidian-skills/ に kepano 公式の obsidian-skills が配置されている。Obsidian 構文の詳細・wikilink 検証ツール群(olw lint、olw maintain --fix、obsidian-wikilink-types verify-and-repair)はここを参照する。本ファイルは KUDO-Vault 固有の規律を補足するのみ。

8.2 kudo-* スキル¶

.claude/skills/kudo/ に工藤氏のカスタムスキル群が配置。最新マップは kudo-skill-tree-ssot-map(自動生成)参照。

8.3 WorkFlowy¶

WorkFlowy は工藤氏(人間)専用の思考ツール。AI は本 Vault に書き込むが、WorkFlowy 本体には書き戻さない:

00-Inbox/workflowy-import/ の取込ファイルは AI が読む(参照可)
WorkFlowy アプリへの書き込み(MCP 経由含む)はしない
詳細は kudo-triple-store-write(Stage 1-C-2 で起草予定)参照

8.4 機密情報の扱い¶

真に機密なクライアント情報は本 Vault に置かない:

✅ OK:意思決定・メタ情報・公開可能な戦略メモ・方法論
✅ OK:取引先名・案件名(工藤氏が外部に公開している関係)
❌ NG:契約書本文・未公開財務数値・パスワード/API Key/PAT/TLS秘密鍵
❌ NG:NDA 厳格相手の未公開戦略

機密情報の正本は各案件の _claude_workspace/(Vault 外・個人設定項目 15 の集中原則の対象外)に置く。詳細は kudo-shared-storage-protocol#confidentiality。

認証情報の取り扱いと過去事案は kudo-ai-error-watchlist の PAT 漏洩 Entry(2026-05-20)を参照。

9. このファイルの編集プロトコル¶

9.1 編集権限¶

直接編集できるのは工藤氏のみ。AI は本ファイルを読むのみ。改訂が必要な場合:

AI が改訂提案を起草(present_files で工藤氏に提示)
工藤氏が内容確認・承認
AI(Claude Code)が Vault に配置・push
改訂は Stage 1-C-* HANDOFF プロトコルに従う

9.2 改訂時のバックアップ¶

本ファイル改訂前に必ず .bak.YYYY-MM-DD でバックアップを取る。

9.3 改訂のトリガー¶

以下の場合、本ファイルの改訂を検討:

新しいフォルダ・命名規則・構文ルールが必要になった
既存ルールでカバーされない新しいワークフローが定常化した
AI が読んでも判断できないケースが繰り返し発生した
安全規則の事故(参照腐敗、上書き、認証情報漏洩等)が発生した

9.4 改訂のチェックリスト¶

既存ルールとの整合性確認
他スキル(kudo-*)への波及確認
個人設定(特に項目 4・項目 9・項目 13・項目 14)への波及確認
バックアップ取得(.bak.YYYY-MM-DD)
git commit 時に「(SSOT)」を含むコミットメッセージ
kudo-skill-tree-ssot-map の再生成(フォルダ構造変更時)

10. 改訂履歴¶

2026-05-21 / v2.0:Stage 1-C-1 で 25 行 → 約 380 行に拡充。8 項目の SSOT 不足(フォルダ詳細・命名規則・frontmatter・wikilink・安全規則・rename プロトコル・graph view 規則・inbound link 走査)を埋めた。Stage 0 で工藤氏が起票した基本ルール(章立て、人間ノート上書き禁止、ADR形式、WorkFlowy・機密スコープ外、Obsidian 書式参照)はすべて保持。
2026-05-18 / v1.0:Stage 0 で工藤氏が起票。25行。Vault 基本構造と運用ルール、スコープ外(WorkFlowy・機密)を定義。

本ファイルは KUDO-Vault における Vault 書込ルールの SSOT である。改訂時は §9 の編集プロトコルに従う。