Napkin（ナプキン）: Claude Code向け失敗メモスキル

AI/ML
Napkin（ナプキン）: Claude Code向け失敗メモスキル

Napkin（ナプキン）: Claude Code向け失敗メモスキル

Claude Codeエージェントに「失敗の持続的記憶」を与える小さなスキルです。リポジトリ単位で .claude/napkin.md というマークダウンのスクラッチパッドを管理し、セッション開始時に読み取り、作業中に継続的に追記します。これにより数回のセッションで既知のミスを繰り返さなくなり、事前に問題を回避するよう振る舞いが変化します。軽量で導入が容易な「ベビー継続学習」的アプローチを提供します。（約300字）

https://github.com/blader/napkin

概要

NapkinはClaude Code用のスキルで、エージェントが過去の失敗や修正履歴をリポジトリ単位で持ち続けられるようにする仕組みです。エージェントはリポジトリ内の .claude/napkin.md をセッション開始時に読み込み、作業中に発生した問題・それに対する修正・成功した手順などを逐次追記します。学習モデル自体を更新するわけではなく、ファイルベースの「スクラッチパッド」を用いることで、数回のやり取りを経ると既知のミス回避や事前対策が顕著になります。軽量で導入が簡単な補助的継続学習手法です。

GitHub

リポジトリの統計情報

  • スター数: 27
  • フォーク数: 1
  • ウォッチャー数: 27
  • コミット数: 3
  • ファイル数: 3
  • メインの言語: 未指定

主な特徴

  • リポジトリごとの永続メモリとして .claude/napkin.md を使用
  • セッション開始時に読み込み、作業中に継続的に書き込むワークフロー
  • モデル本体は変えずに「行動の改善」を狙う軽量な継続学習的アプローチ
  • 導入が容易で既存ワークフローへ干渉が少ない

技術的なポイント

Napkin のコアは非常にシンプルです。Claude Codeのスキルとして動作し、各リポジトリに単一のマークダウンファイル（.claude/napkin.md）を置いてエージェントの「気付き」を保存します。技術的に注目すべき点は次の通りです。

  1. セッションライフサイクルとの統合
    セッション開始時にファイルを読み込み、エージェントの内部コンテキスト（プロンプトや短期的な会話履歴）に過去の問題と修正の要約を注入します。作業中は随時追記し、終了時または適切なタイミングでコミットすることで次回セッションへ持ち越します。これにより短期記憶と永続記憶の橋渡しが可能になります。

  2. ファイルベースの状態管理（シンプルさと可視性）
    外部データベースや学習パイプラインを必要とせず、マークダウンで人間にも読める形式にすることで透明性を高めています。これにより開発者が手動で編集・注釈追加・問題のクローズが可能で、エージェントが参照するメモを明確にコントロールできます。

  3. 継続的改善の挙動（実用的な「ベビー継続学習」）
    Napkinはモデルの重みを更新するのではなく、プロンプト的に過去の失敗を参照させる方式です。このため「モデルが学習した」わけではありませんが、セッション3〜5回を経るとエージェントの振る舞いが変化し、既に修正した問題を繰り返さず、事前に回避策を講じるようになります。実務ではこれが即効性のある改善策になります。

  4. 制約と運用上の注意点

  • 同期・競合管理: 複数人や複数セッションから同時に書き込むと競合が起きる可能性があるため、扱い方やコミットルールの整備が必要です。
  • スコープの限定: 長期的かつ大規模な学習には向かず、局所的・反復的な問題修正に適しています。
  • セキュリティとプライバシー: 保存されるメモに機密情報が含まれないよう注意が必要です（自動的にマスクする機能は含まれていない想定）。

Napkinは設計上「シンプルで見える化された記憶」を重視しており、エンジニアリングの手戻りを減らすための実用的なツールです。SKILL.mdやREADMEの実装例を参照すれば、既存のClaude Codeワークフローへ短時間で組み込めます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • LICENSE: file
  • README.md: file
  • SKILL.md: file

まとめ

軽量なファイルベースの永続メモで、短期間にエージェントのミスを減らす実用的なスキルです（約50字）。

リポジトリ情報：

READMEの抜粋：

Napkin

A skill for Claude Code that gives the agent persistent memory of its mistakes.

The agent maintains a markdown file in your repo (.claude/napkin.md) where it tracks what went wrong, what you corrected, and what worked. It reads the file at session start and writes to it continuously as it works. By session 3-5 the behavior shift is significant — the agent stops making mistakes you’ve already corrected and starts pre-empting issues before you catch them.

Baby continual learning in a…