Claude Code メモリ・設定体制
最適化レポート

2026年3月4日 実施
5分で読めます

今回やったこと

6
新規ファイル
4
更新ファイル
15
rules/ ファイル数
44
スキル総数

最適化後の設定体制

┌─────────────────────────────────────────────────┐ │ ~/work/ │ │ ├── AGENTS.md ← LLM中立（全AIツール共通） │ │ └── HANDOFF.md ← セッション引き継ぎ │ └─────────────────────────────────────────────────┘ ▼ Claude Code が参照 ┌─────────────────────────────────────────────────┐ │ ~/.claude/ │ │ ├── CLAUDE.md ← グローバルルール(93行)│ │ ├── settings.json ← 権限・フック設定 │ │ ├── rules/ (15ファイル) ← ドメイン別ルール │ │ │ ├── agents.md エージェント制御 │ │ │ ├── coding-style.md コーディング規約 │ │ │ ├── defense-line.md AI防衛ルール │ │ │ ├── google-workspace.md gog CLI [NEW] │ │ │ ├── handoff.md 引き継ぎルール [NEW] │ │ │ ├── python-analysis.md *.py専用 [NEW] │ │ │ ├── r-scripts.md *.R専用 [NEW] │ │ │ ├── sdd.md 仕様駆動開発 [NEW] │ │ │ └── ... (他7ファイル) │ │ ├── commands/ (44スキル) ← ユーザー呼び出し │ │ │ └── data-anonymize.md 匿名化 [NEW] │ │ ├── hooks/ ← 自動実行スクリプト │ │ │ └── stop-notify.py HANDOFF警告追加 [UPD]│ │ └── projects/memory/ ← セッション間記憶 │ │ └── MEMORY.md 体制概要追記 [UPD] │ └─────────────────────────────────────────────────┘
~/work/ 全AIツール共通
AGENTS.md LLM中立ワークスペース概要
HANDOFF.md セッション引き継ぎ
Claude Code が参照
~/.claude/ Claude Code 専用
CLAUDE.md グローバルルール (93行)
settings.json 権限・フック設定
rules/ (15ファイル)
agents.md
coding-style.md
defense-line.md
google-workspace.md NEW
handoff.md NEW
python-analysis.md NEW
r-scripts.md NEW
sdd.md NEW
... 他7ファイル
commands/ (44スキル)
data-anonymize.md NEW
hooks/
stop-notify.py UPD
projects/memory/
MEMORY.md UPD

6つのポイント詳細

完了 AGENTS.md の再設計

Claude Code だけでなく、Codex や Gemini CLI でも読めるLLM中立のワークスペース概要に書き換えました。

Before

gog CLI（Google Workspace）のコマンドリファレンスが入っていた。Claude Code 専用の内容。

After

プロジェクト一覧、共通規約、データ取扱いルールを記載。どのAIツールでも活用可能。

gog CLI ルールは ~/.claude/rules/google-workspace.md に移動し、Claude Code 専用ルールとして正しい場所に配置。

完了 HANDOFF.md の導入

セッション終了時の作業状態を次のセッションに引き継ぐ仕組みを構築しました。

ハイブリッド方式の仕組み

層役割タイミング
ルールClaude 自身が HANDOFF.md を更新セッション終了前
Stop フック30分以上未更新なら Slack 警告セッション終了時
セッションログバックアップとして全操作を記録常時

HANDOFF.md の構造

## Last Session: 2026-03-04 10:30
### What was done
- 完了したタスクの概要
### In Progress
- 進行中のタスク
### Next Steps
- 次にやるべきこと
### Blockers / Notes
- 注意点

最大3セッション分を保持し、古い情報は自動的に削除されます。

完了 MEMORY.md の充実

Before: 15行

Hooksの構成とWindows注意点のみ

After: 38行

設定ファイル体制の全体像、フック一覧、セッションログ情報を追加

MEMORY.md は毎セッション自動読み込みされるため、体制の全体像を記載することで、新しいセッションでも即座に現状を把握できます。

完了 glob パターン別ルール

ファイルの拡張子に応じて自動的に適用されるルールを追加しました。

ファイル対象パターン主な内容
r-scripts.md *.R *.r *.Rmd tidyverseスタイル、異常系チェック、日本語フォント
python-analysis.md *.py pandas/polars推奨、Windows固有設定、エンコーディング対応

両ルールとも defense-line Rule 2（異常系対応）を組み込み済み。CSV列名不一致、欠損値、型不整合、ID重複、日付形式混在などを自動的にチェック対象とします。

完了 SDD（仕様駆動開発）ルール

既存のスキルと統合した軽量SDDフローを定義しました。

PLAN
/plan
→
SPEC
仕様定義
→
IMPLEMENT
/tdd
→
VERIFY
/code-review

適用基準も明確化: 新規機能、仕様が曖昧な要件、複数ファイル変更、外部連携時に適用。軽微な修正には不要です。

完了 /data-anonymize スキル

患者データの匿名化処理テンプレートを3段階のレベルで生成するスキルです。

レベル処理用途
L1: 仮名化氏名→ID、住所→市区町村社内分析
L2: 匿名化L1 + 年齢帯化、相対日数化学会発表
L3: 統計的匿名化L2 + k-匿名性、一般化外部共有

defense-line 準拠: スクリプト生成はクラウドAI上で行い、実データの処理は必ずオフラインで実行する手順を組み込み済み。

期待される効果

改善項目効果
LLM中立のAGENTS.md Claude Code 以外のAIツール（Codex, Gemini CLI等）でもプロジェクト概要を共有可能に
HANDOFF自動更新 セッション間のコンテキスト喪失を防止。次回セッション開始時に前回の状態を即座に把握
glob別ルール R/Pythonファイル編集時に defense-line 異常系チェックが自動適用。ルール漏れを防止
SDDルール統合 既存の /plan, /tdd, /code-review スキルとシームレスに連携。新たな学習コスト不要
匿名化スキル データ匿名化の標準手順をテンプレート化。法令準拠・オフライン実行を確実に

変更ファイル一覧

新規作成（6件）

ファイル目的
rules/google-workspace.mdgog CLIルール移動先
rules/handoff.mdHANDOFF更新ルール
rules/r-scripts.mdR向けglob別ルール
rules/python-analysis.mdPython向けglob別ルール
rules/sdd.md仕様駆動開発ルール
commands/data-anonymize.md匿名化スキル

更新（4件）

ファイル変更内容
~/work/AGENTS.mdLLM中立ワークスペース概要に全面書き換え
~/work/HANDOFF.md新規作成（引き継ぎテンプレート）
hooks/stop-notify.pyHANDOFF未更新Slack警告追加
memory/MEMORY.md15行→38行に拡充