Skill

session-memory

Manages cross-session memory by logging sessions, decisions, patterns, and project context to .claude/memory/. Useful for queries about previous sessions, history, or continuing prior work.

developer-tools

Install

npx claudepluginhub chachamaru127/claude-code-harness --plugin claude-code-harness

Tool Access

This skill is limited to using the following tools:

ReadWriteEdit

Preview

セッション間の学習と記憶を管理するスキル。

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars594

Forks63

Last CommitApr 24, 2026

Actions

View Source View Plugin View on GitHub View README

Session Memory Skill

セッション間の学習と記憶を管理するスキル。過去の作業内容、決定事項、学んだパターンを記録・参照します。

トリガーフレーズ

このスキルは以下のフレーズで自動起動します：

「前回何をした？」「前回の続きから」
「履歴を見せて」「過去の作業」
「このプロジェクトについて教えて」
"what did we do last time?", "continue from before"

概要

このスキルは .claude/memory/ に作業履歴を保存し、セッション間での知識の継続を実現します。

あわせて、重要な情報は「どこに残すべきか」を明確にします（詳細: docs/MEMORY_POLICY.md）。

メモリ構造

.claude/
├── memory/
│   ├── session-log.md      # セッションごとのログ
│   ├── decisions.md        # 重要な決定事項
│   ├── patterns.md         # 学んだパターン
│   └── context.json        # プロジェクトコンテキスト
└── state/
    └── agent-trace.jsonl   # Agent Trace（ツール実行履歴）

推奨運用（SSOT/ローカル分離）

SSOT（共有推奨）: decisions.md / patterns.md
- 「決定（Why）」と「再利用できる解法（How）」を集約する
- 各エントリは タイトル + タグ（例: #decision #db）を付け、先頭に Index を置く
ローカル推奨: session-log.md / context.json / .claude/state/
- ノイズ/肥大化しやすいため、基本は Git 管理しない（必要なら個別に判断）

自動記録される情報

session-log.md

各セッション記録には ${CLAUDE_SESSION_ID} 環境変数を活用してセッションIDを付与します。これにより、セッション間のトレーサビリティが向上します。

## セッション: 2024-01-15 14:30 (session: abc123def)

### 実行したタスク
- [x] ユーザー認証機能の実装
- [x] ログインページの作成

### 生成したファイル
- src/lib/auth.ts
- src/app/login/page.tsx

### 重要な決定
- 認証方式: Supabase Auth を採用

### 次回への引き継ぎ
- ログアウト機能が未実装
- パスワードリセットも必要

Note: ${CLAUDE_SESSION_ID} は Claude Code が自動設定する環境変数です。セッションごとに一意のIDが割り当てられ、ログの追跡や問題調査に役立ちます。

decisions.md

## 技術選定

| 日付 | 決定事項 | 理由 |
|------|---------|------|
| 2024-01-15 | Supabase Auth | 無料枠あり、セットアップ簡単 |
| 2024-01-14 | Next.js App Router | 最新のベストプラクティス |

## アーキテクチャ

- コンポーネント: `src/components/`
- ユーティリティ: `src/lib/`
- 型定義: `src/types/`

patterns.md

## このプロジェクトのパターン

### コンポーネント命名
- PascalCase
- 例: `UserProfile.tsx`, `LoginForm.tsx`

### API エンドポイント
- `/api/v1/` プレフィックス
- RESTful 設計

### エラーハンドリング
- try-catch で囲む
- エラーメッセージは日本語

context.json

{
  "project_name": "my-blog",
  "created_at": "2024-01-14",
  "stack": {
    "frontend": "next.js",
    "backend": "next-api",
    "database": "supabase",
    "styling": "tailwind"
  },
  "current_phase": "フェーズ2: コア機能",
  "last_session": "2024-01-15T14:30:00Z"
}

処理フロー

セッション開始時

.claude/memory/context.json を読み込み
前回のセッションログを確認
Agent Trace から直近の編集履歴を取得
未完了タスクを特定
コンテキストサマリーを生成

Agent Trace 活用:

# 前回の編集ファイル一覧を取得
tail -50 .claude/state/agent-trace.jsonl | jq -r '.files[].path' | sort -u

# プロジェクト情報を取得
tail -1 .claude/state/agent-trace.jsonl | jq '.metadata'

セッション中

重要な決定を decisions.md に記録
新しいパターンを patterns.md に追加
ファイル生成を session-log.md に記録

セッション終了時

セッションサマリーを生成
context.json を更新
次回への引き継ぎ事項を記録

メモリ最適化（CC 2.1.49+）

Claude Code 2.1.49 以降、セッション再開時のメモリ使用量が 68% 削減 されました。

推奨ワークフロー

# 長時間作業は --resume を活用
claude --resume

# 大規模タスクは分割してセッション再開
claude --resume "続きから"

シナリオ	推奨
長時間実装	1-2時間ごとにセッション再開
大規模リファクタ	機能単位でセッション分割
メモリ不足警告	即座に `--resume` で再開

メモリ効率が大幅に改善されたため、セッション再開を積極的に活用してください。

/recap — セッション中の状況確認（CC 2.1.108+）

CC 2.1.108 で追加された /recap コマンド（/rewind のエイリアス）は、現在のセッション内でこれまでに何をしたかを素早く振り返るために使用します。 --resume で別セッションに戻る前や、長時間作業の途中確認に組み合わせると効果的です。

推奨タイミング:

タイミング	使い方
`--resume` で再開する直前	`/recap` でコンテキストを整理してから `claude --resume`
Breezing の Worker 再開前	セッション内の進捗を `/recap` で確認してから次タスクへ
長時間実装 (1時間超) の中間点	`/recap` で状況確認 → 必要なら `session-log.md` に手動追記

# 典型的な使用フロー
# 1. 現在の作業状況を確認
/recap

# 2. 必要に応じて session-log.md に手動追記後、セッションを再開
claude --resume

/recap はセッション内の振り返りのみ。前回セッションの内容は session-log.md または claude --resume でのコンテキスト継承で確認する。

使用例

前回の続きから開始

ユーザー: 「前回の続きから」

Claude Code:
📋 前回のセッション（2024-01-15）

完了したタスク:
- ユーザー認証機能
- ログインページ

未完了:
- ログアウト機能
- パスワードリセット

「ログアウト機能を作って」と言えば続きを実装します。

プロジェクトの状況確認

ユーザー: 「このプロジェクトについて教えて」

Claude Code:
📁 プロジェクト: my-blog

技術スタック:
- Next.js + Tailwind CSS + Supabase

現在のフェーズ: コア機能開発
進捗: 40% 完了

最近の決定:
- Supabase Auth を採用
- App Router を使用

Claude Code 自動メモリとの関係（D22）

Claude Code 2.1.32+ には「自動メモリ」機能があり、~/.claude/projects/<project>/memory/MEMORY.md にセッション間の学習を自動保存します。

Harness のメモリシステムとは3層アーキテクチャとして共存します:

層	システム	内容	管理
Layer 1	Claude Code 自動メモリ	汎用的な学習（ミス回避、ツール使い方）	暗黙的・自動
Layer 2	Harness SSOT	プロジェクト固有の決定事項・パターン	明示的・手動
Layer 3	Agent Memory	エージェント別のタスク学習	エージェント定義

使い分け:

Layer 1 の知見がプロジェクト全体に重要 → /memory ssot で Layer 2 に昇格
日常的な学習は Layer 1 に任せる（無効化しない）
Agent Teams 使用時は並列書き込みに注意

詳細: D22: 3層メモリアーキテクチャ

注意事項

自動保存: hooks/Stop により、セッション終了時に session-log.md へ要約を自動追記する運用を推奨（未導入の場合は手動運用でOK）
プライバシー: 機密情報は記録しない
Git方針: decisions.md/patterns.mdは共有推奨、session-log.md/context.json/.claude/state/はローカル推奨（詳細: docs/MEMORY_POLICY.md）
容量管理: ログが大きくなったら「セッションログを整理して」を推奨