second-brain-lint

Second Brain — Lint

Wiki の健全性をチェックし、問題と実行可能な修正案を報告します。

監査手順

以下のチェックをすべて実行し、結果をまとめたレポートを提示します。

1. 壊れた Wiki リンク

すべての Wiki ページをスキャンして [[wikilink]] 参照を確認します。各リンクについて、リンク先のページが存在するか確認してください。壊れたリンクがあれば報告します。

# Find all wikilinks across wiki pages
grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u

wiki/ 内の実際のファイルと照合してください。

2. 孤立したページ

被リンクのないページ、つまり、ほかのページから [[wikilink]] で参照されていないページを見つけます。

wiki/sources/、wiki/entities/、wiki/concepts/、wiki/synthesis/ 内の各 .md ファイルについて：

• ページ名（拡張子を除いたファイル名）を抽出します
• ほかのすべての Wiki ページから [[Page Name]] を検索します
• どのページからもリンクされていない場合は、孤立ページです

3. 矛盾

エンティティや概念が共通するページを読み、主張に食い違いがないか確認します。次の場合は指摘してください：

• 2つのソース要約が同じトピックについて正反対の主張をしている
• エンティティページの情報がソース要約と矛盾している
• ページ間で日付、数値、事実に関する主張が異なる

4. 古い主張

ソースの日付と Wiki の内容を照合します。次の場合は指摘してください：

• 概念ページが古いソースのみを引用しており、同じトピックに関する新しいソースが存在する
• 新しいソースでエンティティに言及されているにもかかわらず、エンティティ情報が更新されていない

5. ページの不足

存在しないページを指す [[wikilinks]] をスキャンします。これらは、Wiki で言及されているものの、専用ページがまだ作成されていないトピックです。専用ページを作成する価値があるか評価してください。

6. クロスリファレンスの不足

同じトピックを扱っているのに、互いにリンクしていないページを見つけます。次の点を確認してください：

• 概念に言及しているエンティティページで、その概念にリンクしていないもの
• エンティティに言及している概念ページで、そのエンティティにリンクしていないもの
• 同じトピックを扱っているのに、互いに参照していないソース要約

7. インデックスの整合性

wiki/index.md が完全かつ正確であることを確認します：

• wiki/sources/、wiki/entities/、wiki/concepts/、wiki/synthesis/ 内のすべてのページにインデックス項目がある
• 削除済みのページを指すインデックス項目がない
• 項目が正しいカテゴリ見出しの下にある

8. データの不足

Wiki の現在の網羅状況を踏まえ、次の点を提案してください：

• 頻繁に言及されるものの、掘り下げが不足しているトピック
• Wiki では十分に答えられない質問
• Web 検索で不足情報を補える領域

レポート形式

重要度別に項目をまとめてください：

エラー（必ず修正）

• 壊れた Wiki リンク
• ページ間の矛盾
• 存在しないページを指すインデックス項目

警告（修正を推奨）

• 被リンクのない孤立ページ
• 古いソースに基づく古い主張
• 頻繁に参照されるトピックのページ不足

情報（できれば修正）

• 追加を検討できるクロスリファレンス
• 補足できるデータの不足
• より説明的にできるインデックス項目

各指摘には、次の項目を含めてください：

• 内容： 問題の説明
• 場所： 該当するファイルと行
• 修正： 対応方法

レポートの後

ユーザーに次のように尋ねます：

「エラーが N 件、警告が N 件、情報項目が N 件見つかりました。修正する項目はありますか？」

ユーザーが同意した場合は、問題を修正し、変更内容を報告します。

lint の記録

wiki/log.md に次の内容を追記します：

## [YYYY-MM-DD] lint | Health check
エラーが N 件、警告が N 件、情報項目が N 件見つかりました。修正済み：[適用した修正の一覧]。

lint を実行するタイミング

• 10 件の取り込みごと — クロスリファレンスの不足を、新しいうちに発見できます
• 少なくとも毎月 — 古い主張や孤立ページを定期的に発見できます
• 大規模なクエリの前 — 分析に利用する前に Wiki の健全性を確認できます

関連スキル

• /second-brain-ingest — 新しいソースを Wiki ページに取り込む
• /second-brain-query — Wiki に質問する