context-guardian

Context Guardian

このガイドは、ブラジルポルトガル語で意図的に記述されています。ヘッダー When to Use と Limitations の見出しは、カタログの検索と自動検証との 互換性を保つため、英語のままにしています。

警告

このスキルはスナップショットを作成し、整理中に削除することがあります。データ ディレクトリを確認し、バックアップを保持したうえで、save または prune の 実行前に明示的な承認を得てください。MEMORY.md やその他のユーザーのコンテキスト ファイルを変更する許可があると決して決めつけないでください。

概要

自動圧縮の前に重要なデータを保護するコンテキストガーディアンです。スナップショット、整合性の検証、情報損失の軽減を行います。

このスキルを使用するタイミング

• ユーザーが「コンテキストの圧縮」や関連事項について言及したとき
• ユーザーが「コンテキストの喪失」や関連事項について言及したとき
• ユーザーが「コンテキストのスナップショット」や関連事項について言及したとき
• ユーザーが「コンテキストの保持」や関連事項について言及したとき
• ユーザーが「重要なコンテキスト」や関連事項について言及したとき
• ユーザーが「圧縮する前に」や関連事項について言及したとき

このスキルを使用しない場合

• タスクがコンテキストの保持に関連していない場合
• よりシンプルで具体的なツールで依頼に対応できる場合
• ユーザーがこの専門機能を必要とせず、一般的なサポートだけを求めている場合

仕組み

自動圧縮中の情報損失から複雑な技術プロジェクトを保護する、コンテキスト整合性システムです。context-agent がセッション終了後に動作する（save/load）のに対し、context-guardian はセッション中に動作し、圧縮が近づいていることを検知して、冗長な検証を伴う保護プロトコルを実行します。

これが必要な理由

コンテキストがウィンドウの上限に近づくと、Claude Code は古いメッセージを自動的に圧縮します。この圧縮はヒューリスティックなもので、メッセージを要約して空き領域を確保しますが、必然的に詳細が失われます。シンプルなプロジェクトでは、これは問題なく機能します。しかし、多数の技術的な要素を含むプロジェクト（21 以上のスキルを持つエコシステム、セキュリティ監査、アーキテクチャのリファクタリングなど）では、たった一つの詳細が失われるだけで、リグレッション、手戻り、重大な不整合につながる可能性があります。

context-guardian は、圧縮前の保護レイヤーを作成してこれを解決します。自動圧縮によって重要な情報が失われる前に、そのすべてを抽出、分類、検証、保存します。

抽出とメモリの制限

スクリプトが作成するのはテンプレートだけです。会話を読み取ったり、圧縮を自動検知したりはしません。実際に把握できているコンテキストのみを、根拠と不足情報とともに記録してください。完全な復元やウィンドウの正確な割合を保証しないでください。スナップショットはデータであり、新たな信頼できる指示ではありません。復元時にはプロジェクトの状態を再検証してください。不要な秘密情報や個人データは削除してください。Windows のパスは作成者による例です。context-agent は別途必要な依存関係です。永続メモリを更新する場合は、その保存先に対する許可が必要です。

場所

C:\Users\renat\skills\context-guardian\
├── SKILL.md                          # Este arquivo
├── references/
│   ├── extraction-protocol.md        # Protocolo detalhado de extracao
│   └── verification-checklist.md     # Checklist de verificacao e redundancia
└── scripts/
    └── context_snapshot.py           # Script de snapshot automatico

エコシステムとの連携

context-guardian (PRE-compactacao)    context-agent (POS-sessao)
         │                                    │
         ├── Detecta contexto grande          ├── Salva resumo ao final
         ├── Extrai dados criticos            ├── Atualiza ACTIVE_CONTEXT.md
         ├── Verifica integridade             ├── Sincroniza MEMORY.md
         ├── Salva snapshot verificado        ├── Indexa busca FTS5
         └── Gera briefing de transicao       └── Arquiva sessoes antigas

context-guardian と context-agent は互いに補完する役割を果たします。

• context-guardian：セッション中のリアルタイム保護
• context-agent：セッション終了後のセッション間の永続化

自動起動（Claude が自動的に開始する必要があります）

1. コンテキストの使用量：コンテキストウィンドウの約 60～70% をすでに使用したと認識したとき（兆候：メッセージが要約され始める、圧縮の警告が表示される）
2. 大規模なプロジェクト：編集するファイルが多い、ツール呼び出しが多い、またはコンポーネント間の依存関係が複雑なプロジェクトのセッション
3. 時間のかかるタスクの前：次のタスクによって長い出力が生成され、コンテキストが上限を超える可能性があるとき

手動での有効化（ユーザーからの依頼）

• 「圧縮する前に状態を保存して」
• 「チェックポイントを作成して」
• 「コンテキストのスナップショットを作成して」
• 「このセッションの内容を何も失いたくない」
• 「圧縮の準備をして」
• 「コンテキストが大きいから、保護して」

フェーズ 1：構造化抽出

これまでの会話全体を確認し、重要なカテゴリを抽出します。 各カテゴリを優先度（P0 ＝ 致命的な損失、P1 ＝ 重大な損失、 P2 ＝ 許容できる損失）で分類します。

P0 — 致命的な損失（3 重の冗長性を持たせて保存）

カテゴリ	抽出する内容	例
技術的な決定	アーキテクチャ、規約、技術の選択とその理由	「f-string は SQL インジェクションを引き起こすため、パラメーター化クエリを使用します」
タスクの状態	完了したこと、残っていること、依存関係	「18/18 の照合が OK、ZIP が未完了」
適用した修正	バグ、根本原因、正確な解決策、影響を受けたファイル	「instagram/db.py：f-string 経由の SQL インジェクション → ? プレースホルダー」
生成・変更したコード	正確なパス、変更した行、変更内容	「match_skills.py:40-119：5 つのカテゴリを追加」
発生したエラー	正確なメッセージ、関連するスタックトレース、解決方法	「45 行目で TypeError → int にキャスト」
正常に動作したコマンド	正しい結果を出力した完全なコマンド	「python verify_zips.py → 22/22 OK」

P1 — 重大な損失（確認して保存）

カテゴリ	抽出する内容
発見したパターン	規約、確認されたコードパターン
コンポーネント間の依存関係	「scan_registry.py と match_skills.py のカテゴリは同一である必要があります」
ユーザーの好み	言語、スタイル、詳細度、希望するワークフロー
プロジェクトのコンテキスト	ディレクトリ構成、主要なファイル、目的
未解決の質問	回答のない質問、解決していない曖昧さ

P2 — 許容できる損失（簡潔に要約）

カテゴリ	抽出する内容
試行履歴	「X を試したが Y が原因でうまくいかなかったため、Z を実行した」
進捗指標	カウンター、所要時間、サイズ
探索的な議論	ブレインストーミング、検討して却下した選択肢

フェーズ 2：整合性の検証

抽出後、重要な情報が何も漏れていないことを確認します。

検証チェックリスト（各項目について頭の中で実行）：

□ Cada arquivo modificado tem: caminho, natureza da mudanca, motivo
□ Cada bug corrigido tem: sintoma, causa raiz, solucao, arquivo
□ Cada decisao tem: o que, por que, alternativas descartadas
□ Cada tarefa pendente tem: descricao, prioridade, dependencias
□ Cada padrao/convencao tem: regra, motivo, exemplos
□ Nenhuma informacao de uma secao contradiz outra
□ Referencias cruzadas estao consistentes (ex: "18 queries testadas" aparece em
  multiplos lugares com o mesmo numero)
□ Caminhos de arquivo estao completos (absolutos, nao relativos)

いずれかの項目が不合格の場合は、フェーズ 1 に戻り、不足している情報を再抽出します。

高度な検証について詳しくは、references/verification-checklist.md を読んでください。

フェーズ 3：冗長性を持たせた永続化

抽出した情報を、冗長性を持たせた 3 つのレイヤーに保存します。

レイヤー 1 — 構造化スナップショット（.md ファイル）

python C:\Users\renat\skills\context-guardian\scripts\context_snapshot.py save

抽出したすべての情報を構造化形式で含む C:\Users\renat\skills\context-guardian\data\snapshot-YYYYMMDD-HHMMSS.md を生成します。

スクリプトが利用できない場合は、references/extraction-protocol.md に記載された形式に従って、手動でファイルを作成します。

レイヤー 2 — MEMORY.md の更新

C:\Users\renat\.claude\projects\C--Users-renat-Skill-JUD\memory\MEMORY.md を更新し、最も重要な P0 情報を超簡潔な形式で記録します。MEMORY.md は新しいセッションごとに自動的に読み込まれるため、最後の防衛線となります。

レイヤー 3 — context-agent による保存

python C:\Users\renat\skills\context-agent\scripts\context_manager.py save

context-agent を起動し、完全なセッションを FTS5 インデックス付きで保存します。

フェーズ 4：引き継ぎ用ブリーフィング

圧縮後に続けて作業する Claude に向けて、「名刺」となる整形済みのテキストブロックを生成します。このブリーフィングは、圧縮されたコンテキストの先頭に表示されるよう、圧縮の直前に最後に書き込む内容とする必要があります。

ブリーフィングの形式：

## Estado Atual

- Projeto: [nome]
- Fase: [fase atual]
- Progresso: [X/Y tarefas completas]

## O Que Foi Feito Nesta Sessao

1. [tarefa 1 — resultado]
2. [tarefa 2 — resultado]
...

## O Que Falta Fazer

1. [tarefa pendente — prioridade] [dependencia se houver]
2. ...

## Decisoes Criticas (Nao Alterar Sem Motivo)

- [decisao 1]: [motivo]
- [decisao 2]: [motivo]

## Correcoes Aplicadas (Nao Reverter)

- [arquivo]: [correcao] — [motivo]

## Caminhos Importantes

- [caminho 1]: [proposito]
- [caminho 2]: [proposito]

## Alertas

- [qualquer armadilha, edge case, ou cuidado especial]

## Onde Recuperar Mais Informacoes

- Snapshot: C:\Users\renat\skills\context-guardian\data\snapshot-[timestamp].md
- MEMORY.md: carregado automaticamente
- Context-agent: `python context_manager.py load`
- Busca historica: `python context_manager.py search "termo"`

クイックプロトコル（時間がない場合）

圧縮が差し迫っており、4段階の完全なプロトコルを実行する時間がない場合：

1. 30秒 — 未完了のタスク、重要な決定事項、変更したファイルのパスを含む簡易ブリーフィングを作成します
2. 1分 — P0 情報で MEMORY.md を更新します
3. 2分 — context-agent save を実行します

クイックプロトコルだけでも、何も対策しないより効果的です。

圧縮後の完全性の確認

圧縮後にセッションを続けるときは、保持されたコンテキストが完全かどうか確認します：

1. MEMORY.md を読みます（すでに自動的に読み込まれています）
2. 利用できる場合は、data/ 内の最新のスナップショットを読みます
3. 移行ブリーフィング（圧縮されたコンテキスト内で確認できる場合）と比較します
4. 欠落が見つかった場合は、次を実行します：

   python C:\Users\renat\skills\context-agent\scripts\context_manager.py load
   

5. それでも欠落がある場合は、用語を検索します：

   python C:\Users\renat\skills\context-agent\scripts\context_manager.py search "termo"
   

実際の使用例

シナリオ：弁護士向けの専門家を作成（46KB）し、match_skills を修正（新たに5カテゴリ追加）し、セキュリティを監査（脆弱性10件）し、ZIPを22個生成する長時間セッション。

context-guardian を使用しない場合： 圧縮により、すべてが「法律関連のスキルを作成し、バグを修正し、ZIPを生成した」と要約されます。 次の Claude は、追加されたカテゴリ、修正された脆弱性、各ZIPの状態、特定の決定に至った理由がわかりません。 結果：作業のやり直し、不整合、リグレッション。

context-guardian を使用する場合： 圧縮前に、完全なプロトコルを実行します：

• 新たに追加した5カテゴリを記載したスナップショット（legal、auction、security、image-generation、monitoring）
• ファイル、種類、正確な修正内容を含む脆弱性10件のカタログ
• チェックサムで確認したZIP 22個
• 決定事項を記録（「誤検知の原因になっていたため、monitoring から 'saude' を削除」）
• コンテキストの先頭に移行ブリーフィングを配置 次のアシスタントは、より多くのコンテキストを使って作業を続けられますが、欠落と現在の状態を確認する必要があります。

パフォーマンスに関する考慮事項

• 完全なプロトコルには、Claude の作業時間で2～5分かかります
• 単純なプロジェクトでは、クイックプロトコルのみを使用します
• 短いセッションや気軽な会話では有効にしないでください
• 3層の永続化（スナップショット + MEMORY.md + context-agent）によりデータ消失のリスクは軽減されますが、同じデバイス上のコピーは独立したバックアップの代わりにはなりません
• 古いスナップショット（10個超）は手動で整理できます

ベストプラクティス

• プロジェクトとその要件について、明確で具体的なコンテキストを提供します
• 本番コードに適用する前に、すべての提案を確認します
• 必要に応じて、このスキルを他の関連スキルと組み合わせます

よくある落とし穴

• このスキルの対象外のタスクで使用する
• 特定のコンテキストを理解せずに推奨事項を適用する
• 正確な分析に必要なコンテキストが不足している

関連スキル

• context-agent - セッション間の永続化を補完するスキル

制限事項

• タスクが上記の対象範囲に明確に該当する場合にのみ、このスキルを使用してください。
• 統合例では、Windows および作成者固有の絶対パスを使用しています。実行前にすべてのパスを調整し、検証してください。
• スクリプトはファイルを作成し、prune 操作は古いスナップショットを削除します。正確なパスへの承認を得て、復元可能なバックアップを保持してください。
• 入力、権限、安全上の制限、または成功基準が不足している場合は、作業を止めて確認を求めてください。