Obsidian セットアップ — Vault の初期化

新しい Obsidian wiki vault をセットアップしています (または既存の vault を修復しています)。

ステップ 1: .env を作成する

.env が存在しない場合は、.env.example から作成します。ユーザーに以下を聞いてください:

1. vault はどこに配置しますか? → OBSIDIAN_VAULT_PATH

   • デフォルト: ~/Documents/obsidian-wiki-vault
   • 絶対パスである必要があります (展開後)

2. ソース文書はどこにありますか? → OBSIDIAN_SOURCES_DIR

   • 複数のパスをカンマで区切って指定可能
   • デフォルト: ~/Documents

3. Claude の履歴をインポートしたいですか? → CLAUDE_HISTORY_PATH

   • デフォルト: ~/.claude から自動検出
   • Claude データが別の場所にある場合は明示的に設定

4. QMD がインストールされていますか? → QMD_WIKI_COLLECTION / QMD_PAPERS_COLLECTION / QMD_TRANSPORT

   • オプション。wiki-query でのセマンティック検索と wiki-ingest でのソース検出を有効にします。
   • ユーザーがローカル qmd CLI を直接呼び出すことを望まない限り、デフォルトは QMD_TRANSPORT=mcp に設定します。
   • CLI モードを使用する場合は、デフォルトで QMD_CLI_SEARCH_MODE=quality を設定してください。リランキングが遅い場合は balanced をお勧めします。
   • 不確実な場合はスキップしてください — 両方のスキルは自動的に Grep にフォールバックします。
   • インストール手順: .env.example を参照してください (QMD セクション)。

ステップ 2: Vault のディレクトリ構造を作成する

mkdir -p "$OBSIDIAN_VAULT_PATH"/{concepts,entities,skills,references,synthesis,journal,projects,_archives,_raw,.obsidian}

• .obsidian/ — Obsidian 独自の設定。vault の認識を作成します。
• projects/ — プロジェクトごとの知識 (ingest 中に入力されます)。
• _archives/ — wiki スナップショットを保存し、再構築/復元操作用に使用します。
• _raw/ — 未処理のドラフト用ステージング エリア。ここに rough notes をドロップしてください。wiki-ingest は適切な wiki ページに昇格させ、元のファイルを削除します。

ステップ 3: 特殊ファイルを作成する

index.md

---
title: Wiki Index
---

# Wiki Index

*このインデックスは自動的に維持されます。最終更新: TIMESTAMP*

## Concepts

*まだページがありません。`wiki-ingest` を使用して最初のソースを追加してください。*

## Entities

## Skills

## References

## Synthesis

## Journal

log.md

---
title: Wiki Log
---

# Wiki Log

- [TIMESTAMP] INIT vault_path="OBSIDIAN_VAULT_PATH" categories=concepts,entities,skills,references,synthesis,journal

hot.md

---
title: Hot Cache
updated: TIMESTAMP
---

# Hot Cache

*最近のアクティビティの約 500 語のセマンティック スナップショット。主要な書き込み操作のたびに更新されます。*

## Recent Activity

- [TIMESTAMP] INIT — vault が OBSIDIAN_VAULT_PATH に作成されました

## Active Threads

*まだありません — ソースを ingest してから入力してください。*

## Key Takeaways

*まだありません。*

## Flagged Contradictions

*まだありません。*

ステップ 4: .obsidian 設定を作成する

優れたそのまま使える体験のための最小限の Obsidian 設定を作成します:

.obsidian/app.json

{
  "strictLineBreaks": false,
  "showFrontmatter": false,
  "defaultViewMode": "preview",
  "livePreview": true
}

.obsidian/appearance.json

{
  "baseFontSize": 16
}

ステップ 5: Obsidian プラグインをお勧めする

ユーザーにこれらの推奨コミュニティ プラグイン (手動でインストール) について説明してください:

1. Dataview — ページのメタデータをクエリし、動的テーブルを作成します。wiki に不可欠です。
2. Graph Analysis — 接続を探索するための強化されたグラフ ビュー。
3. Templater — テンプレートを使用してページを手動で作成したい場合。
4. Obsidian Git — vault を git リポジトリに自動バックアップします。

ステップ 6: セットアップを検証する

クイック サニティ チェックを実行します:

• Vault ディレクトリが存在し、以下を含んでいます: concepts/、entities/、skills/、references/、synthesis/、journal/、projects/、_archives/、_raw/
• index.md が vault ルートに存在します
• log.md が vault ルートに存在します
• hot.md が vault ルートに存在します
• .env に OBSIDIAN_VAULT_PATH が設定されています
• .obsidian/ ディレクトリが存在します
• ソース ディレクトリ (設定されている場合) が存在し、読み取り可能です

結果を報告し、ユーザーに以下を実行できることを伝えます:

1. Obsidian で vault を開く (File → Open Vault → ディレクトリを選択)
2. wiki-status を実行して、ingest 可能な内容を確認する
3. wiki-ingest を実行して最初のソースを追加する
4. claude-history-ingest を実行して Claude の会話をマイニングする
5. codex-history-ingest を実行して Codex セッションをマイニングする (Codex を使用している場合)
6. 任意のタイミングで wiki-status を再度実行して差分を確認する