second-brain-ingest

Second Brain — 取り込み

未加工のソース文書を処理し、構造化された相互リンク付きの wiki ページにします。

処理するソースを特定する

取り込みが必要なファイルを判断します。

1. ユーザーがファイルを指定した場合は、そのファイルを使用します
2. ユーザーが「新しいソースを処理して」などと指示した場合は、未処理のファイルを検出します。
   • raw/ 内のすべてのファイルを一覧表示します（raw/assets/ は除外）
   • wiki/log.md を読み、ingest エントリーから取り込み済みのソースファイル名をすべて抽出します
   • ログに記載されていない raw/ 内のファイルは未処理です
3. 未処理のファイルが見つからない場合は、ユーザーに伝えます

各ソースを処理する

ソースファイルごとに、次のワークフローに従います。

1. ソースをすべて読む

ファイル全体を読みます。ファイルに画像への参照が含まれている場合は、それらをメモし、重要な情報が含まれていれば画像を別途読みます。

2. 重要なポイントをユーザーと確認する

何かを書く前に、ソースの最も重要なポイントを3～5個共有します。特に強調したい点や省略したいトピックがあるか、ユーザーに尋ねます。続行する前に確認を待ちます。

3. ソースの要約ページを作成する

wiki/sources/ に、ソース名をスラッグ化した新しいファイルを作成します。次の内容を含めます。

---
tags: [関連するタグ]
sources: [元のファイル名.md]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

# ソースタイトル

**ソース：** 元のファイル名.md
**取り込み日：** YYYY-MM-DD
**種類：** 記事 | 論文 | 文字起こし | メモなど

## 要約

ソースの内容を構造化して要約します。

## 主な主張

- 主張 1
- 主張 2
- ...

## 言及されたエンティティ

- [[エンティティ名]] — 簡単な説明
- ...

## 扱われている概念

- [[概念名]] — 簡単な説明
- ...

4. エンティティと概念のページを更新する

ソース内で言及されている各エンティティ（人物、組織、製品、ツール）と概念（アイデア、フレームワーク、理論、パターン）について、次のように対応します。

wiki ページがすでにある場合：

• 既存のページを読みます
• このソースから得られた新しい情報を追加します
• ソースを sources: フロントマターのリストに追加します
• updated: の日付を更新します
• 既存の内容と矛盾する点があれば、両方のソースを引用して記録します

wiki ページがない場合：

• 適切なサブディレクトリに新しいページを作成します。
  • 人物、組織、製品、ツールの場合は wiki/entities/
  • アイデア、フレームワーク、理論、パターンの場合は wiki/concepts/
• タグ、ソース、作成日、更新日を含む YAML フロントマターを記述します
• このトピックについてソースに書かれている内容に基づき、焦点を絞った要約を作成します

5. ウィキリンクを追加する

関連するすべてのページが [[wikilink]] 構文で互いにリンクされていることを確認します。独自のページがあるエンティティや概念への言及は、すべてリンクします。

6. wiki/index.md を更新する

新しく作成した各ページについて、該当するカテゴリ見出しの下にエントリーを追加します。

- [[ページ名]] — 1行の要約（120文字以内）

7. wiki/log.md を更新する

次の内容を末尾に追加します。

## [YYYY-MM-DD] ingest | ソースタイトル
ソースファイル名.md を処理しました。N 個の新しいページを作成し、M 個の既存ページを更新しました。
新しいエンティティ：[[エンティティ1]]、[[エンティティ2]]。新しい概念：[[概念1]]。

8. 結果を報告する

実施した内容をユーザーに伝えます。

• 作成したページ（リンク付き）
• 更新したページ（変更内容）
• 特定した新しいエンティティと概念
• 既存の内容との矛盾が見つかった場合はその内容

規約

• ソースの要約ページには事実のみを記載します。解釈や統合は概念ページと統合ページに記載します。
• 1つのソースが通常10～15件の wiki ページに関係します。これは一般的で、想定内です。
• 新しい情報が既存の wiki の内容と矛盾する場合は、wiki ページを更新し、両方のソースを引用して矛盾を記録します。
• 新しいページを作成するよりも、既存のページを更新することを優先します。そのトピックが独自のページを設けるのに十分なほど明確に異なる場合にのみ、新しいページを作成します。
• すべての内部参照に [[wikilinks]] を使用します。ファイルパスをそのまま使用しないでください。

次のステップ

ソースを取り込んだ後、ユーザーは次のことができます。

• /second-brain-query を使って質問し、取り込んだ内容を調べる
• さらにソースを取り込む — 別の記事をクリップして、再び /second-brain-ingest を実行する
• 10 回取り込むごとに /second-brain-lint でヘルスチェックを行い、抜け漏れを確認する