Communityコーディング&開発github.com

コンテキストキュレーションベース

レトロスペクティブや計画セッション後にプロジェクトファイルのコンテキストを管理するためのフレームワーク。週次/月次レトロ+計画完了後、またはコンテキストが肥大化したと感じたときにトリガーします。

コンテキストキュレーションベース とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がプロジェクトファイルのコンテキストを効率的に管理し、会話品質を維持するための体系的なプロセスを提供します。「フラクタル圧縮」パターンを採用し、各レベルの要約が前レベルの生入力をアーカイブ可能にします。具体的には、デイリーサマリー、ウィークリーレトロ、マンスリーレトロなど、時間粒度ごとに文書を保持しつつ、アーカイブ前に抽出可能なデータを別途保存することで、情報の損失を防ぎます。このスキルは、週次・月次レトロと計画完了後に自動トリガーされることを想定しており、ファイルごとに「常に保持」「現在のレイヤー」「アーカイブ候補」を明確に分類します。ユーザーは最終的なアーカイブ決定を行い、必要に応じてデータを抽出・圧縮します。エッジケース(レトロ欠落、複数日またぎのサマリー、抽出データなし)への対処法も定義されており、実践的なユースケース(ランニングプロジェクトの例)を通じて動作を理解できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZachBeta/claude-as-coach/tree/main/skills/context-curation-base

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コンテキストキュレーションスキル

作成日: 2026年1月19日(月) 更新日: 2026年1月20日(月) 目的: レトロスペクティブ/計画セッション後にプロジェクトファイルのコンテキストを管理するための体系的なプロセス ステータス: 実験的


概要

コンテキストキュレーションは「フラクタル圧縮」パターンに従います。各レベルの要約は、前レベルの生入力をアーカイブ可能にします。アーカイブする前に、抽出可能なデータを補遺文書や参照文書に折り込みます。

トリガーフレーズ:

  • "context curation"
  • "clean up project files"
  • "archive old summaries"
  • "what can we remove"

圧縮階層

デイリーサマリー → ウィークリーレトロ → マンスリーレトロ → クォータリーレトロ → イヤリーレトロ
完了後...これらをアーカイブ可能...
デイリーサマリーその日の生会話ログ
ウィークリーレトロその週のデイリーサマリー
マンスリーレトロその月のウィークリーレトロ
クォータリーレトロその四半期のマンスリーレトロ
イヤリーレトロその年のクォータリーレトロ

原則: 各粒度レベルで少なくとも1つのコピーを保持する。


最小保持基準

各粒度レベルで少なくとも1つの文書を保持する。

レベル最小保持数
デイリー最新のサマリー1〜2件
ウィークリー今週の計画+最新のレトロ
マンスリー今月の計画+最新のレトロ
クォータリー今四半期の計画+最新のレトロ
イヤリー今年の計画+最新のレトロ

原則: 圧縮後も、各時間スケールで最近の状態を確認できるようにする。


アーカイブ前に折り込む

デイリーサマリーをアーカイブする前に、参照文書に残すべきデータを抽出する。

抽出するもの

  • 定量的進捗(反復回数、時間、測定値、PR)
  • プロトコルの変更や発見
  • 追跡項目のステータス更新
  • 確認された追加事項(新しい安全な食品、新しい動作など)

抽出先

補遺ファイル データを蓄積する参照文書用:

  • Reference-Doc.md → Reference-Doc-Addendum-YYYY-MM-DD-to-DD.md
  • 日付範囲は処理中の週次レトロ期間と一致
  • 例: Training-Log-Addendum-2026-02-16-to-22.md

直接更新 単純なステータス変更の場合:

  • 単一値の変更はメイン文書に直接反映可能
  • レベルの進行、ステータスの切り替えなど

補遺ファイル命名パターン

{Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md

日付範囲は処理中の週次レトロと一致させる。

補遺ファイルが圧縮されるタイミング

週次キュレーション中に、補遺ファイルをメイン文書に折り込む:

  1. 補遺ファイルの内容を確認
  2. メイン文書の適切なセクションに統合
  3. メイン文書の更新日を更新(例: **Updated:** 2026-02-23)
  4. 更新された文書をプロジェクトに保存(古いバージョンを置き換え)
  5. 処理済みの補遺ファイルをアーカイブ

更新日の重要性: Claudeが参照文書のアーティファクトを生成する際、更新日が最新バージョンを明確にします。古いバージョンはプロジェクトからアーカイブ/削除できます。

参照文書のバージョニング

ファイル名に日付を含める(定期的な改訂に推奨):

  • Identity-Ecosystem-2025-12.md → Identity-Ecosystem-2026-03.md
  • 新しいバージョン作成時に古いバージョンをアーカイブ

コンテンツ内の更新日(段階的な更新用):

  • ファイル名は同じまま、内部の **Updated:** YYYY-MM-DD を更新
  • 補遺ファイルが小さな変更を折り込む場合に機能

ファイルカテゴリ

常に保持(参照文書)

「ロールアップ」されない継続的な参照価値を持つ文書:

  • プロトコル文書(トレーニング計画、栄養ガイドライン、回復ルーチン)
  • フレームワーク文書(目標階層、進捗追跡システム)
  • コンテキスト文書(現在のステータス、背景情報)
  • リサーチ計画(進行中の調査スレッド)

現在のレイヤーを保持

各時間スケールの最新文書:

  • 今週の計画+最新の週次レトロ
  • 今月の計画+最新の月次レトロ
  • 最新のデイリーサマリー1〜2件(現在の会話への橋渡し)

アーカイブ候補

内容が上位レベルの要約に合成された文書:

  • 週次レトロでカバーされたデイリーサマリー(抽出完了後)
  • 月次レトロでカバーされた週次レトロ
  • 過去の週次計画(実行済み、レトロ完了)
  • 過去の月次計画(月次レトロが成果を捉えた後)
  • 処理済み補遺ファイル(メイン文書に折り込まれたもの)
  • 参照文書の古いバージョン(更新版に置き換えられたもの)

プロセス

1. 時間的境界の特定

どのレトロが完了したか?

  • 週次レトロ → その週のデイリーサマリーをアーカイブ可能
  • 月次レトロ → その月の週次レトロをアーカイブ可能

2. デイリーサマリーから抽出可能データを確認

アーカイブ対象のデイリーサマリーをスキャン:

  • 参照文書に属する定量的データ
  • プロトコルの変更や確認
  • 永続化すべき進捗マーカー

3. 補遺ファイルに抽出

抽出可能データがある各参照文書について:

  • 今週の補遺ファイルを作成または追記
  • 命名規則: {Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md を使用

4. 補遺ファイルをメイン文書に圧縮

過去の週からの補遺ファイルが存在する場合:

  • 補遺ファイルの内容を確認
  • メイン文書の適切なセクションに統合
  • アーカイブ対象として補遺ファイルをマーク

5. アーカイブ候補をリストアップ

プロジェクトファイルを簡単にパス:

  • 参照文書: リストアップ、保持の確認、鮮度のチェック
  • 現在のレイヤー: 各スケールの最新を特定
  • アーカイブ候補: 理由とともにリストアップ

フォーマット:

**抽出 - 今週のデイリーから:**
- [ファイル]: "[データ]" → [補遺ファイル]

**圧縮 - 折り込み準備完了の補遺:**
- [補遺ファイル] (Nエントリ) → [メイン文書]

**保持 - 参照文書:**
- [ファイル] - [明白でない場合は簡単な理由]

**保持 - 現在のレイヤー:**
- [ファイル] - [どのレイヤーか: daily/weekly/monthly]

**リフレッシュ - 古くなっている可能性:**
- [ファイル] - [なぜ更新が必要か]

**アーカイブ - [レトロ名]に折り込まれました:**
- [ファイル]
- [ファイル]

リフレッシュトリガー(参照文書はアーカイブされませんが、古くなります):

  • 時間ベース: 最終更新から30日以上経過
  • イベントベース: 主要マイルストーン、レベルの変更、プロトコルの変更
  • コンテンツベース: 情報が最近のサマリー/レトロと矛盾

6. ユーザーが確認してアーカイブ

ユーザーは次のように反応:

  • ✓(推奨に同意)
  • ✗(特定ファイルを保持/再検討)
  • 追加コンテキスト(「さらにXもアーカイブ」または「Yは理由により実際は保持」)

ユーザーはその後:

  • データを補遺ファイルに抽出
  • 補遺ファイルをメイン文書に圧縮
  • アーカイブファイルをプロジェクトから削除

エッジケース

明確にカバーされていないファイル

期間のレトロが欠落または不完全な場合:

  • カバレッジが得られるまで下位レベルの文書を保持
  • 例: 12月の月次レトロがその期間を明確にカバーしていない場合、Week 11のレトロを保持

更新が必要な参照文書

一部の「参照」文書は古くなります:

  • トレーニング計画 → フィットネスレベルの変化に応じて更新
  • 機器/ギアリスト → ニーズの変化に応じて更新
  • 目標フレームワーク → 主要マイルストーン後の変化に応じて更新

これらはアーカイブではなくリフレッシュとしてフラグを立てる。

複合サマリー

デイリーサマリーが複数日にまたがる場合(スキップや結合による):

  • 週次レトロがその期間をカバーした後にアーカイブ
  • 結合自体はレトロに含まれている
  • アーカイブ前に定量的データを抽出

抽出可能データがない場合

デイリーサマリーに抽出すべき定量的/プロトコルデータがない場合:

  • 抽出ステップをスキップ
  • 直接アーカイブに進む
  • レトロの合成で十分

決定原則

  1. アーカイブ前に折り込む: ソースを削除する前に永続データを抽出
  2. 迷ったら保持: 後でいつでもアーカイブ可能
  3. 圧縮は信号を保持: 上位レベルの合成は重要だったものを捉える
  4. コンテキストは有限: プロジェクトファイルは会話の質に影響する
  5. 最近 > 古い: 過去の文書よりも最近の文書を優先
  6. 参照 > 一時: 参照文書は要約よりも寿命が長い

セッション例

Week 8レトロ後(Robのランニングプロジェクト):

Claude: コンテキストキュレーションを始めましょう。まず、アーカイブ前に抽出すべきデータはありますか?

**抽出 - 今週のデイリーから:**
- Summary-02-16: "3.1mi at 9:45 pace" → Training-Log-Addendum-2026-02-16-to-22.md
- Summary-02-18: "New stretching routine working well" → Recovery-Protocol-Addendum-2026-02-16-to-22.md
- Summary-02-20: "PR: 5K in 28:32" → Training-Log-Addendum-2026-02-16-to-22.md

**圧縮 - 折り込み準備完了の補遺:**
- Training-Log-Addendum-2026-02-09-to-15.md (4エントリ) → Training-Log.md
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (2エントリ) → Recovery-Protocol.md

**保持 - 参照文書:**
- Training-Plan-5K.md
- Race-Schedule-2026.md
- Training-Log.md
- Recovery-Protocol.md

**保持 - 現在のレイヤー:**
- Weekly-Plan-2026-02-23.md (現在)
- Weekly-Retro-2026-02-16.md (作成したばかり)
- Summary-02-21.md, Summary-02-22.md (最新)

**リフレッシュ - 古くなっている可能性:**
- Training-Plan-5K.md - 6週間前に最終更新、Week 4のインターバルを超えて進歩しています

**アーカイブ - Week 8レトロに折り込まれました:**
- Weekly-Plan-2026-02-16.md
- Summary-02-16.md から Summary-02-20.md
- Training-Log-Addendum-2026-02-09-to-15.md (圧縮後)
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (圧縮後)

ユーザー: トレーニングデータを補遺ファイルに抽出しました。先週の補遺ファイルをメイン文書に圧縮しました。残りはアーカイブしました。

Claude: 良いですね。データは参照文書に保持されました。コンテキストがキュレーションされました。

統合ノート

トリガータイミング:

  • 週次レトロ+計画完了後
  • 月次レトロ+計画完了後
  • コンテキストが肥大化/会話品質が低下していると感じたとき

一般的な週次キュレーションフロー:

  1. 週次レトロ(サマリーのサマリー)
  2. 週次計画
  3. コンテキストキュレーション: a. デイリーから抽出 → 補遺ファイル b. 補遺ファイルを圧縮 → メイン参照文書 c. デイリーをアーカイブ(レトロに折り込まれた) d. 処理済み補遺ファイルをアーカイブ(メイン文書に折り込まれた)

認知負荷:

  • 軽量に保つ(深い分析ではなく、簡単なパス)
  • 各ファイルの最終判断はユーザーが行う
  • 余力がないときに判断を強要しない

スキル依存関係:

  • レトロスペクティブスキルと連携(その出力を使用)
  • プランニングスキルと連携(計画完了後に発生)

"折り込んでからアーカイブ。各レイヤーの最新を保持。"

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

関連スキル