Session Management

セッション管理

目的

AI エージェントのセッション間で継続性を維持するために、構造化された作業トラッキング、技術的負債の管理、レポートのアーカイブを提供します。このスキルにより、セッション間でコンテキストが失われないことが保証されます — エージェントは常に、何が行われたか、何が保留中か、何に注意が必要かを把握できます。

レポートレジストリ

レポートレジストリ (.claude/reports/_registry.md) は、セッションをまたいで実行されたすべての作業の中央インデックスです。

エントリを追加するタイミング

• 意味のある作業単位 (バグ修正、機能追加、リファクタリング、調査) を完了した後
• 保存する価値のある知見を生み出した調査の後
• 今後対応が必要な問題を特定したとき

使用方法

1. セッション開始時にレジストリを読み、最近の作業を把握します
2. セッション中に作業が完了するたびにエントリを追加します
3. 過去の作業を再訪する際にエントリのステータスを更新します (Active → Resolved)
4. 整理のために 15 カテゴリの構造に従います

エントリの形式

### [Category] Short descriptive title
- **Date:** YYYY-MM-DD
- **Status:** Active | Resolved | Archived
- **File:** `.claude/reports/<category>/<filename>.md`
- **Summary:** One-line description of findings or changes

15 カテゴリすべてを含む完全なテンプレートについては references/registry-template.md を参照してください。

技術的負債トラッカー

技術的負債トラッカー (.claude/reports/_tech-debt.md) は、開発中に発見された技術的負債を記録します。

負債を追加するタイミング

• 改善すべきだが現在の焦点ではないコードに気づいたとき
• 適切な解決策ではなく回避策が使われているとき
• テストがスキップされている、またはカバレッジの不足が特定されたとき
• 依存関係の更新が先送りされているとき
• アーキテクチャ上の懸念が発見されたとき

優先度レベル

優先度	意味	対応
P0	開発または本番をブロックする	今回のセッションで修正
P1	DX またはパフォーマンスを低下させる	今週中に修正
P2	コード品質上の懸念	今月中に修正
P3	あると望ましい改善	都合のよいときに修正

項目の形式

### [P{0-3}] Short title
- **Added:** YYYY-MM-DD
- **Category:** code-quality | performance | security | architecture | testing | dependency | documentation
- **Location:** `path/to/file.ts:123`
- **Impact:** What happens if this isn't addressed
- **Suggested Fix:** Brief approach description
- **Status:** Open | In Progress | Resolved

例を含む完全なテンプレートについては references/tech-debt-template.md を参照してください。

アーカイブ戦略

レジストリと負債トラッカーは簡潔に保ちます:

• レポート: 7 日より古い解決済みの項目を .claude/reports/archive/ にアーカイブします
• 技術的負債: 解決済みの項目は参照用に 90 日間保持し、その後アーカイブします
• レジストリのサイズ: アクティブなエントリは 50 件を超えないようにします — 積極的にアーカイブします
• 月次クリーンアップ: もはや価値を提供しないアーカイブ済みの項目を削除します

詳細なアーカイブガイドラインについては references/archive-strategy.md を参照してください。

MEMORY.md による自己改善

MEMORY.md は Claude Code の自動メモリファイルです — すべてのシステムプロンプトに自動的に読み込まれます。セッションをまたいでプロジェクト固有の教訓を蓄積する自己改善ループとして活用してください。

場所

~/.claude/projects/<project-path-with-dashes>/memory/MEMORY.md

MEMORY.md を更新するタイミング

• ユーザーからの修正があった後 — 最も重要なトリガーです。ユーザーがあなたのアプローチを修正したら、その教訓をすぐに保存してください。
• コードベース内で自明ではないパターンや落とし穴を発見した後
• ユーザーの好み (例: 「常に X ライブラリを使う」、「決して自動コミットしない」) を把握した後
• 根本原因が自明ではなかった厄介なバグを解決した後

MEMORY.md の構造

時系列ではなくトピックごとに整理します:

# Project — Lessons Learned

## Build & Tooling
- [lesson]

## Architecture Patterns
- [lesson]

## Testing
- [lesson]

## Common Pitfalls
- [lesson]

## Owner Preferences
- [lesson]

サイズの目安

200 行未満に保ちます — これはすべてのシステムプロンプトに読み込まれます。大きくなりすぎた場合:

1. 関連するエントリを統合します
2. コンテキストから明らかになった教訓を削除します
3. 個別のトピックファイル (例: debugging.md) を作成し、MEMORY.md からリンクします

保存すべきでないもの

• セッション固有のコンテキスト (現在のタスク、進行中の作業)
• CLAUDE.md やプロジェクトのドキュメントにすでにある情報
• 推測的または未検証の結論
• 適切に修正済みの一時的な回避策

セッション開始ワークフロー

セッション管理が設定されたプロジェクトで作業を再開する場合：

1. レジストリを読み込む: cat .claude/reports/_registry.md
2. 技術的負債を読み込む: cat .claude/reports/_tech-debt.md
3. git の状態を確認する: git log --oneline -10 および git status
4. 作業対象の領域に関連する MEMORY.md の教訓を確認する（MEMORY.md はシステムプロンプトに自動的に読み込まれます）
5. 要約する: 何が進行中で、何が保留中かをユーザーに伝え、何に取り組むべきかを提案します
6. P0 の負債を確認する: P0 の項目が存在する場合は、直ちに対応が必要であることを示します

セッション終了ワークフロー

セッションを終了する前に：

1. レジストリを更新する — このセッションで完了した作業を反映します
2. 技術的負債を追加する — 発見したが未対応の項目を記録します
3. MEMORY.md を更新する — このセッションで得た修正や教訓を反映します
4. アーカイブする — 保持期間を過ぎた解決済みの項目をアーカイブします
5. 要約する — 何を達成し、次に何を行うかをまとめます

相互参照

• references/registry-template.md — 15 のカテゴリを含む完全なレジストリテンプレート
• references/tech-debt-template.md — 例を含む技術的負債トラッカーのテンプレート
• references/archive-strategy.md — アーカイブのルールとライフサイクル管理