Wiki Update — プロジェクトを Wiki に同期

現在のプロジェクトから知識をユーザーの Obsidian wiki に蒸留しています。このスキルは obsidian-wiki リポジトリだけでなく、どのプロジェクトディレクトリからも動作します。

開始する前に

1. 設定を解決する — llm-wiki/SKILL.md の Config Resolution Protocol に従ってください（CWD を遡って .env → ~/.obsidian-wiki/config → プロンプト設定を探します）。これで OBSIDIAN_VAULT_PATH、OBSIDIAN_WIKI_REPO、OBSIDIAN_LINK_FORMAT（デフォルトは wikilink または markdown）が得られます。どのプロジェクトディレクトリからでも動作します。
2. $OBSIDIAN_VAULT_PATH/.manifest.json を読んで、このプロジェクトが以前同期されたかを確認します。
3. $OBSIDIAN_VAULT_PATH/index.md を読んで、wiki が既に何を含んでいるかを把握します。

ステップ 4 ～ 5 で内部リンクを書くときは、llm-wiki/SKILL.md のリンク形式セクションで説明されている形式を OBSIDIAN_LINK_FORMAT の値を使用して適用してください。

ステップ 1: プロジェクトを理解する

現在のワーキングディレクトリをスキャンしてプロジェクトが何かを把握します：

• README.md、docs/、その他の markdown ファイル
• ソース構造（フレームワーク、言語、主要な抽象化）
• package.json、pyproject.toml、go.mod、Cargo.toml またはプロジェクトを定義するもの
• Git ログ（「typo を修正」ではなく、決定を示すコミットメッセージに焦点を当てる）
• Claude メモリファイルが存在する場合（プロジェクトの .claude/）

ディレクトリ名から整理されたプロジェクト名を導き出します。

ステップ 2: 差分を計算する

.manifest.json でこのプロジェクトを確認します：

• 初回？ 完全スキャン。すべてが新しいです。
• 以前同期されている？ last_commit_synced を確認します。最後の同期以降の変更のみを考慮してください。git log <last_commit>..HEAD --oneline を使用して新しい内容を確認します。

最後の同期以降に意味のある変更がない場合は、ユーザーに伝えて停止してください。

ステップ 3: 蒸留すべき内容を決定する

これは Karpathy のパターンからの中核的な質問です：3 か月後にコンテキストなしでこのプロジェクトに戻ってきたときに、何を知りたいですか？

蒸留する価値があるもの：

• アーキテクチャの決定とそれが行われた 理由
• 構築中に発見されたパターン（そうでなければ Google で検索するもの）
• プロジェクトが依存するツール、サービス、API、およびそれらがどのように配線されているか
• 主要な抽象化、それらがどのように接続するか、メンタルモデルが何であるか
• 評価されたトレードオフ、何が選ばれたのか、そしてなぜか
• コードから明らかでない、構築中に学んだこと

蒸留する価値がないもの：

• ファイルリスト、ボイラープレート、明らかな設定
• より広い教訓のない個々のバグ修正
• 依存関係のバージョン、ロックファイルの内容
• コードが既に明確に言っている実装の詳細
• ルーチン変更（誰でも diff から読み取れるもの）

ヒューリスティック：コードベースを読むことで質問に答えられるなら、wiki に書かないでください。20 個のコミット間で git blame を読み直す必要がある場合は、wiki に書いてください。

ステップ 4: Wiki ページに蒸留する

プロジェクト固有の知識

$VAULT/projects/<project-name>/ の下に配置されます：

projects/<project-name>/
├── <project-name>.md          ← プロジェクト概要（プロジェクト名で命名、_project.md ではない）
├── concepts/                  ← プロジェクト固有のアイデア、アーキテクチャ
├── skills/                    ← プロジェクト固有のハウツー、パターン
└── references/                ← プロジェクト固有のソース要約

概要ページ（<project-name>.md）は以下を含む必要があります：

• プロジェクトが何か（1 段落）
• 主要なコンセプトとそれらがどのように接続するか
• プロジェクト固有とグローバル wiki ページへのリンク

グローバルな知識

プロジェクト固有ではないものは、グローバルカテゴリーの下に配置されます：

発見したこと	配置先
学んだ一般的なコンセプト	concepts/
再利用可能なパターンまたはテクニック	skills/
ツール/サービス/人物	entities/
クロスプロジェクト分析	synthesis/

ページ形式

すべてのページに YAML frontmatter が必要です：

---
title: >-
    ページタイトル
category: concepts
tags: [tag1, tag2]
sources: [projects/<project-name>]
summary: >-
    このページが何をカバーしているかを説明する 1 ～ 2 文（≤200 文字）。
provenance:
  extracted: 0.6
  inferred: 0.35
  ambiguous: 0.05
base_confidence: 0.59
lifecycle: draft
lifecycle_changed: TIMESTAMP_DATE
created: TIMESTAMP
updated: TIMESTAMP
---

Use folded scalar syntax (summary: >-) for title and summary to keep frontmatter parser-safe across punctuation (:, #, quotes) without escaping rules.
Keep the title and summary contents indented by two spaces under summary: >-.

# ページタイトル

- コードベースまたはドキュメントが実際に述べている事実。
- なぜこのデザインが機能するのか。 ^[inferred]

[[wikilinks]] を使用して他のページに接続します。

すべての新規/更新ページに summary: frontmatter フィールドを書いてください（1 ～ 2 文、≤200 文字）。>- 折りたたみスタイルを使用します。プロジェクト同期の場合、良い要約は「このページはタイトルから推測できないプロジェクトについて何を教えてくれるか？」に答えます。このフィールドは wiki-query による安価な検索を支えています。

provenance マーカーを適用してください llm-wiki（Provenance Markers セクション）。プロジェクト同期に対して：

• Extracted — コード、設定、またはドキュメント/コミットメッセージに表示されるもの：ファイル構造、依存関係、関数シグネチャ、ファイルの機能。
• Inferred — 決定が行われた 理由、設計原理、トレードオフ、「チームは Y のために X を選んだ」 — コミットメッセージ、ドキュメント、または ADR が明示的に記載していない限り。
• Ambiguous — コードとドキュメントが一致しない場合、または明らかに進行中の移行があり 2 つのパターンが並行して存在する場合。

大まかな割合を計算し、すべての新規/更新ページに provenance: ブロックを書いてください。

更新と作成

• ページが既にバルトに存在する場合は、新しい情報をそこに マージ してください。重複を作成しないでください。
• 既存のページに追加する場合は、updated タイムスタンプを更新し、新しいソースを追加してください。
• 新しいものを作成する前に、index.md を確認して、既に何があるかを確認してください。

ステップ 5: クロスリンク

ページを作成/更新した後：

• 新しいページから既存の関連ページへ [[wikilinks]] を追加します
• 関連する場合、既存のページから新しいページへ戻る [[wikilinks]] を追加します
• プロジェクト概要をすべてのプロジェクト固有ページと関連するグローバルページにリンクします

ステップ 6: 更新トラッキング

.manifest.json を更新する

このプロジェクトのエントリを追加または更新します：

{
  "projects": {
    "<project-name>": {
      "source_cwd": "/absolute/path/to/project",
      "last_synced": "TIMESTAMP",
      "last_commit_synced": "abc123f",
      "pages_in_vault": ["projects/<project-name>/<project-name>.md", "..."]
    }
  }
}

index.md を更新する

作成された新しいページのエントリを追加します。

log.md を更新する

以下を追加します：

- [TIMESTAMP] WIKI_UPDATE project=<project-name> pages_updated=X pages_created=Y source_cwd=/path/to/project

hot.md を更新する

$OBSIDIAN_VAULT_PATH/hot.md を読みます（欠落している場合は wiki-ingest のテンプレートから作成します）。Recent Activity を同期されたばかりの内容で書き直します — 最後の 3 つの操作まで。このプロジェクトが継続的なフォーカスである場合、Active Threads を更新します。このシンク中に明らかになった最も重要なアーキテクチャの洞察または決定で Key Takeaways を更新します。updated タイムスタンプを更新します。

概念的に書いてください：「obsidian-wiki を同期 — wiki-capture と wiki-research スキルを追加、中核的な新機能は自律的なウェブ研究と会話キャプチャです。」

ヒント

• マージに積極的になってください。 プロジェクトが React Server Components を使用する場合、concepts/react-server-components.md が既に存在するなら新しいページを作成しないでください。既存のものを更新し、このプロジェクトをソースとして追加してください。
• タグ分類法を参照してください。 $VAULT/_meta/taxonomy.md が存在する場合は読んで、正規タグを使用してください。
• コードをコピーしないでください。 実装ではなく 知識 を蒸留してください。「このプロジェクトは 300ms の遅延を持つ debounced 検索パターンを使用する」は有用です。実際の debounce 関数を貼り付けることは有用ではありません。
• プロジェクト概要はアンカーです。 <project-name>.md ファイルは、方向性を知るために読むものです。良くしてください。