knowledge-consolidation

COG ナレッジ統合スキル

目的

パターン認識と体系的な統合を通じて、ブレインダンプ、日次ブリーフ、チェックインから得られた散在する洞察を、一貫性のあるフレームワークと「信頼できる唯一の情報源」となるナレッジドキュメントに変換します。

呼び出すタイミング

• ユーザーが自身の洞察を統合したいと考えている
• ユーザーが「ナレッジを統合する」「フレームワークを構築する」「洞察を統合する」と言った
• 定期的なナレッジベースのメンテナンス（毎週、毎月、四半期ごと）を行うとき
• ユーザーが蓄積されたブレインダンプからパターンを抽出したいと考えている
• フレームワークを参照することで役立つ重大な意思決定を行う前

エージェントモードの確認

00-inbox/MY-PROFILE.md のフロントマターにある agent_mode を確認します：

• agent_mode: team の場合 — スキャンとパターン抽出を並列サブエージェントに委任します（例：個人のブレインダンプ、仕事上のブレインダンプ、プロジェクト固有のコンテンツ、日次ブリーフなど、領域ごとに担当を分けます）。各エージェントがテーマとパターンを特定し、その後、統合エージェントが調査結果を組み合わせてフレームワークを作成します。
• agent_mode: solo（デフォルト）の場合 — スキャン、パターン認識、フレームワーク構築のすべてを直接行います。委任は行いません。

事前確認

現在のタイムスタンプを取得します（ファイルを生成する前に必ず実行）：

1. Bash を使って date '+%Y-%m-%d %H:%M' を実行し、実際の現在の日付と時刻を取得します
2. この値を保存し、created: フロントマターフィールドに使用します
3. 時刻を推測したり捏造したりしてはなりません。必ず date コマンドが返した値を使用します

プロセスの流れ

1. データ収集

処理されていない、または一部しか処理されていないコンテンツを保管庫からスキャンします：

• 前回の統合以降のすべてのブレインダンプ：

  • 02-personal/braindumps/
  • 03-professional/braindumps/
  • 04-projects/*/braindumps/
  • 00-inbox/braindump-*.md（複数領域）

• 日次ブリーフとチェックイン：

  • 01-daily/briefs/
  • 01-daily/checkins/

• 次の場所にある会議の議事録やプロジェクトドキュメント：

  • 04-projects/*/planning/
  • 04-projects/*/resources/

対象範囲を決定します：

• ユーザーに尋ねます：「どの期間を分析しますか？（先週、先月、前四半期、全期間、またはカスタム範囲）」
• 未処理のコンテンツを特定します（status: "captured" があるか、統合メタデータが欠落していないかを確認します）

統計を収集します：

• 分析対象のドキュメント総数
• 領域および種類ごとの内訳
• 対象となる日付範囲

2. パターン認識

すべてのコンテンツを対象に、体系的なパターン検出を適用します：

頻度分析

繰り返し現れるものは何ですか？

• 複数のドキュメントで言及されているテーマを特定します
• トピックの頻度とクラスターを追跡します
• 継続的な疑問や懸念を認識します
• 繰り返し現れるアクションアイテムや意思決定を見つけます

時間的クラスター分析

どの洞察が同時期に生まれましたか？

• 関連する洞察を期間ごとにグループ化します
• 思考が時間とともにどのように発展したかを特定します
• 思考が変化した転換点を認識します
• 変化のきっかけとなった要因を整理します

領域間の相関

どのようなパターンが領域をまたいでいますか？

• 仕事上の思考に影響する個人的な洞察
• プロジェクトに応用された仕事上の学び
• 個人の成長に影響を与えるプロジェクトの経験
• すべての領域にまたがる戦略的テーマ

矛盾分析

思考が食い違っているのはどこですか？

• 矛盾する考えやアプローチを特定します
• 発展と一貫性の欠如を見分けます
• 解決済みか、緊張関係が続いているかを把握します
• 時間の経過に伴う視点の変化を追跡します

横断的なパターン

あらゆる側面にまたがるメタパターン：

• 意思決定のアプローチ
• 問題解決の戦略
• 学習のパターン
• 感情やエネルギーのパターン
• 人間関係のパターン
• 創造的なプロセス

3. フレームワークの作成

パターンを実践に役立つフレームワークに統合します：

中核となる原則の特定

散在する洞察から基本原則へ：

• パターンからどのような深い原則が見えてきますか？
• どのようなルールやヒューリスティックが生まれていますか？
• どのようなメンタルモデルが形成されていますか？
• どのような戦略が効果を上げていますか？

根拠に照らして検証する

ソース資料を使ってフレームワークを検証します：

• ソースから得られた洞察は、これらの原則を裏付けていますか？
• 反例や例外はありますか？
• このフレームワークにはどの程度の確信を持てますか？
• 適用範囲の境界条件は何ですか？

適用範囲を定義する

フレームワークはいつ適用でき、いつ適用できませんか？

• このフレームワークはどのような状況に適していますか？
• どのような制限がありますか？
• どのような場合に使用すべきではありませんか？
• どのような前提に基づいていますか？

活用方法を作成する

このフレームワークの使い方：

• 具体的なユースケース
• 意思決定への活用方法
• 問題解決用テンプレート
• 実践的な実装手順

4. ナレッジの統合

ナレッジベースのドキュメントを更新し、作成します。

既存のフレームワークを更新する

更新が必要な各フレームワークについて、references/templates.md の統合ナレッジ用テンプレートを使用します。

保存先：05-knowledge/consolidated/[framework-name]-framework.md

新しいフレームワークを作成する

新たに特定したフレームワークには、references/templates.md の新規フレームワーク用テンプレートを使用します。

保存先：05-knowledge/consolidated/[framework-name]-framework.md

パターンのドキュメントを更新する

references/templates.md のパターン用テンプレートを使用してパターンを記録します。

保存先：05-knowledge/patterns/pattern-[name].md

タイムラインの項目を作成する

references/templates.md の思考の変遷用テンプレートを使用して、タイムラインの項目を作成します。

保存先：05-knowledge/timeline/[topic]-evolution-YYYY-MM.md

5. 統合レポートを生成する

レポート用テンプレートを使用して、統合ドキュメントを作成します。

保存先：05-knowledge/consolidated/consolidation-YYYY-MM-DD.md

6. クリーンアップとアーカイブ

処理済みのブレインダンプに印を付ける： 処理済みのブレインダンプのフロントマターを更新します。

status: "consolidated"
consolidated_in: "[[consolidation-YYYY-MM-DD]]"
consolidated_date: "YYYY-MM-DD"

古くなったコンテンツをアーカイブする： 置き換えられたフレームワークや洞察を、次の場所に移動します。 00-inbox/archive/[filename]-archived-YYYY-MM-DD.md

アーカイブした理由と、何に置き換えられたかを説明する注記を追加します。

ナレッジベースを整理された状態に保つ：

• 重要な文脈を保ちながら、重複を取り除く
• 相互参照を更新する
• 壊れたリンクを修正する
• タグの一貫性を保つ

7. 完了を確認する

統合後：

• ユーザーに次のように伝えます：「ナレッジの統合が完了しました！[X] 件のドキュメントを処理しました」
• 次の内容を強調します：「[X] 件のフレームワークを更新し、[X] 件の新しいフレームワークを作成しました」
• 次のように示します：「統合レポートの保存先：[file path]」
• 作成・更新した主要なフレームワークを確認するよう提案します
• 特定のフレームワークについて詳しく説明することを申し出ます

ループエンジニアリング

統合は、完全性クリティックを伴う、枯渇するまで繰り返す抽出であり、1 回のスキャンではありません。共通の用語については .claude/skills/loop-engineering/SKILL.md を参照してください。

ループ： 対象範囲内のドキュメントをまとめてスキャン → テーマ、パターン、候補となるフレームワーク原則を抽出 → 完全性クリティック（「対象範囲内でまだ読んでいないドキュメントはあるか？ N 件以上のドキュメントで繰り返し現れるのに、まだどのフレームワークにも取り込まれていないテーマはあるか？」）を実行 → クリティックによって新しい内容が明らかになった場合は、もう一度抽出パスを実行 → 2 回連続で新しい内容が見つからなくなったら（枯渇したら）停止します。agent_mode: team では、最初のスキャンをドメインごとに 1 人のワーカーに分担します（個人／業務／プロジェクトごと／ブリーフ）。各ワーカーは結論のみを返し、統合パスで結果をまとめます。

検証器（可能な限り決定的に実施）：

• トレーサビリティ： すべてのフレームワーク原則は、少なくとも 1 つのソースドキュメントにリンクします。[[source]] のない原則は公開せず、破棄します。これは機械的に実施できる、統合における COG の検証優先ルールです。
• 網羅性： 対象範囲内のすべてのドキュメントに status: "consolidated" のマークを付け、consolidated_in のバックリンクを設定します。
• 重複排除： フレームワークを作成する前に 05-knowledge/consolidated/ を確認し、重複して作成するのではなく、既存のフレームワークを更新します。
• 完全性クリティック（「テーマを見落としていないか？」）は、判断に基づく唯一のチェックです。明示的に行い、根拠にリンクしてください。

終了条件（段階的）：

• 枯渇： K=2 回連続のパスで、新しいテーマもドキュメントも見つからないこと。
• 網羅性の達成： 対象範囲内のすべてのドキュメントに統合済みのマークが付いていること。
• ハード上限： 抽出パスの最大回数を設け、ノイズの多いコーパスが無限にループしないようにします。

パターン： 枯渇するまで繰り返す（中核）＋計画・実行・検証（各パス）＋オーケストレーターとワーカー（チームモードのドメインスキャン）＋完全性クリティック。

ループ中のコンテキスト： 統合レポートを段階的に書き進め、新しいテーマは会話ではなく、蓄積中のテーマ一覧と照合して重複排除します。レポートファイルに外部化することで、大規模なコーパスがコンテキストウィンドウからあふれるのを防ぎます。

統合ガイドライン

量より質

• 十分に成熟していない洞察を無理に作り出さないでください
• 根拠からパターンが自然に現れるのを待ってください
• 不完全な考察にも辛抱強く取り組んでください
• 質の高いフレームワークには時間と根拠が必要です
• フレームワークには「創発中」「運用中」「安定」のいずれかのステータスを付けてください

ニュアンスを保つ

• 複雑な洞察を過度に単純化しないでください
• 重要なコンテキストや条件を維持してください
• フレームワークに制約がある場合は記録してください
• まだ解決していない矛盾を残してください
• 不確実性を明示してください

トレーサビリティを維持する

• 常にソースドキュメントにリンクしてください
• フレームワークの根拠を示してください
• 考え方の変化を記録してください
• 将来の検証や修正を可能にしてください
• フレームワークの主張を容易に監査できるようにしてください

生きたドキュメント

• 新しい洞察に合わせてフレームワークを進化させてください
• 完璧な初稿を目指すより、定期的に更新してください
• ステータスを明確に示してください（創発中／運用中／安定）
• 反復と改善を促してください
• Git でバージョン履歴を管理してください

分析手法のリファレンス

パターン検出方法

1. 頻度分析： 言及を数え、トピックをクラスタリングします
2. 時間的クラスタリング： 時間ごとにグループ化し、変化を追跡します
3. ドメイン相関： ドメインをまたぐ関連性を調べます
4. 矛盾分析： 対立を特定し、その解決を追跡します
5. エネルギーパターン検出： 感情面と実務面のパターンを検出します

フレームワーク統合プロセス

1. 中核原則の特定： 基本的な真実を抽出します
2. 根拠との照合： ソースを使って妥当性を検証します
3. 境界の定義： 適用範囲を定めます
4. 用途の作成： ユースケースを作成します
5. 進化の記録： 時間の経過に伴う発展を追跡します

タイムライン構築方法

1. 転換点に印を付ける： 考え方が変化した時点を特定します
2. きっかけの特定： 変化を引き起こした要因を特定します
3. 進化の記録： 理解がどのように発展したかを記録します
4. 学びの抽出： 進化から得られる教訓を抽出します

成功指標

• 完全性：関連するすべての知見を処理している
• 一貫性：フレームワークに論理的な整合性がある
• トレーサビリティ：元資料への明確なリンクがある
• 実用性：フレームワークを意思決定に適用できる
• 発展性：思考の進展を記録している
• ユーザー価値：フレームワークが実際に活用されている

一般的なユースケース

• 週次の統合： 1週間分の知見をパターンにまとめる
• 月次のフレームワーク開発： 戦略的なフレームワークを構築する
• 四半期ごとの戦略的統合： 全体像を捉えて統合する
• 年次のナレッジベース整理： 品質と関連性を維持する
• 意思決定前のフレームワーク参照： 重要な意思決定にフレームワークを適用する
• プロジェクトの振り返り： フレームワークに活用する学びを抽出する

哲学

ナレッジ統合スキルは、COG の自己進化する知性を体現しています。

• 散在する考えを戦略的なフレームワークへと変換する
• 時間の経過に伴う思考の進化を尊重する
• 「信頼できる唯一の情報源」となる、更新し続けるドキュメントを構築する
• トレーサビリティと証拠に基づく推論を維持する
• より良い意思決定につながる、実用的な知識を生み出す
• パターンを見つけながら、ニュアンスも尊重する
• 反復と継続的な改善を重視する