This project has been archived. The approach described below was found to be structurally flawed. See the postmortem for details.
Claude Code セッション中の「学び」を TIL (Today I Learned) メモとしてキャプチャするプラグイン。
Claude Code で WebSearch/WebFetch を使って調査した際、得られた知識を自動的に TIL メモとして保存するプラグイン。「学びの瞬間を逃さない」が目標だった。
構造的矛盾: 「学びを記録する」ために「学びを邪魔する」設計になっていた。
- 割り込みタイミングの問題 — Stop hook は「セッション終了時」ではなく「Claude の応答完了時」に発火する。ユーザーが調査結果を受け取って次の質問をしようとした瞬間に、TIL 記録の確認ダイアログが割り込む。
- コンテキスト汚染 — TIL の保存先、タグ選択、内容確認といった会話がメインコンテキストに残り、直後の会話品質に影響する。Transformer の注意機構は直前の会話ターンに強くバイアスされるため、トークン量（全体の 1-2%）以上に質的な影響がある。
- LLM 生成 TIL の価値の低さ — TIL の本質は「自分の言葉で学びを整理する行為」そのものにある。LLM に委譲した時点で、記録の価値がゼロになる。
- 市場シグナル — 同様のプラグインが世の中に存在しないのは、技術的に作れないからではなく、作っても価値がないから。
- 自動化すべきでないものがある。「手間を省く」と「価値を消す」が同義になるタスクは自動化してはいけない。
- Hook の発火タイミングを正確に理解せずに設計すると、想定と実際の UX が大きく乖離する。
- init wizard を LLM 会話でやるのは間違い。初回設定のような手続きはシェルの世界で完結させるべき。
- ADR（Architecture Decision Record）を書く習慣は、失敗の原因分析を容易にする。このポストモーテムが書けるのは ADR のおかげ。
プラグインとしては失敗だが、開発過程で得た技術的知見は有用だった:
- Claude Code プラグインアーキテクチャ（hooks, skills, config）の理解
- bats-core による Shell スクリプトのテスト手法（47 テスト、完全隔離環境）
- Hook の出力プロトコル（Stop:
{"decision":"block","reason":"..."}, SessionStart:{"hookSpecificOutput":{...}}） - jq を使った JSON 処理パターン
以下は v1.1.0 時点のドキュメント（参考）
til-capture は、Claude Code での調査・開発中に得た知識を自動的に検知し、構造化された Markdown ファイルとして保存するプラグインです。
WebSearch や WebFetch を使った調査の後、セッション終了時に TIL 記録を自動で提案します。手動での記録にも対応しており、/til-capture:til コマンドでいつでも学びを保存できます。
保存された TIL はフロントマター付きの Markdown ファイルで、個人の知識整理や振り返りに活用できます。
- 自動検知: WebSearch/WebFetch を使った調査後、セッション終了時に TIL 記録を自動提案
- 手動記録:
/til-capture:tilコマンドでいつでも TIL を記録 - TIL 検索・一覧:
/til-capture:til-listで蓄積した TIL の検索・一覧表示・タグ集計 - タグ自動補完: 既存 TIL のタグを抽出して新規 TIL のタグ表記を統一
- ストック表示: セッション開始時に既存 TIL 数をリマインド
- 意図的な保存先設定: CWD 内ディレクトリ → config.json の 2 段階で保存先を解決（未設定時はアラート表示）
- 信頼度ベースの確認: 保存先の信頼度に応じてユーザー確認を制御
- セキュリティ: 入力バリデーション、パストラバーサル対策、アトミックな状態管理
- Claude Code
jqコマンド
claude plugin add ~/src/github.com/qaTororo/til-capture/til-capture:til
カテゴリやトピックを指定:
/til-capture:til docker networking
蓄積した TIL を検索・ブラウズ:
/til-capture:til-list # 直近 10 件の一覧
/til-capture:til-list search docker # キーワードで全文検索
/til-capture:til-list tags # タグ別の件数を表示
WebSearch や WebFetch を使って調査を行った後、セッション終了時に自動で TIL 記録を提案します。不要な場合はスキップできます。
保存先の信頼度（CWD 内の既存ディレクトリか、未確認のパスか）に応じて動作が変わります:
- 高信頼（CWD 内ディレクトリ or config の既存パス）: 保存先を明示して記録を実行
- 低信頼（未存在のパス）: ユーザーに保存先を確認してから記録
- 未設定: アラートを表示し、設定方法を案内（保存は行わない）
毎セッション開始時に、TIL の自動キャプチャ状態が表示されます。
TIL auto-capture: ON (WebSearch/WebFetch) | Author: your-username | Stock: 42 entries (/path/to/til)
保存先が未設定の場合:
TIL auto-capture: ⚠ No save destination configured. Set defaultTilDir in ~/.config/til-capture/config.json or create a til/ directory in your project.
デフォルトの保存先を設定するには ~/.config/til-capture/config.json を作成します:
mkdir -p ~/.config/til-capture
cat > ~/.config/til-capture/config.json << 'EOF'
{
"defaultTilDir": "/home/user/my-knowledge-base/til",
"author": "your-username"
}
EOFdefaultTilDir には TIL ファイルを保存したいディレクトリの絶対パスを指定してください。
author には TIL の著者名を指定します（省略可）。チームで共有リポジトリを使う場合に「誰が書いたか」を記録するために設定してください。
以下の順でディレクトリを検索し、最初に見つかった場所に保存します:
| 優先度 | ソース | 信頼度 |
|---|---|---|
| 1 | CWD 内のプロジェクトディレクトリ (src/content/til/ → content/til/ → til/) |
高（確認なし） |
| 2 | config.json の defaultTilDir（ディレクトリが存在する場合） |
高（確認なし） |
| 2 | config.json の defaultTilDir（ディレクトリが存在しない場合） |
低（確認あり） |
| — | 上記すべて該当なし | アラート表示（保存しない） |
---
title: "学びのタイトル"
date: 2026-01-01
author: "your-username"
tags: [tag1, tag2]
draft: true
---
## 概要
...
## 詳細
...git clone https://github.com/qaTororo/til-capture.git
cd til-capture
npm installclaude --plugin-dir ~/src/github.com/qaTororo/til-capturenpm testテストフレームワークに bats-core を使用しています。テストは完全に隔離された環境で実行されます（HOME、TMPDIR 等を差し替え）。
技術的な詳細は docs/architecture.md、セキュリティ対策は docs/security.md を参照してください。
| ADR | 決定 |
|---|---|
| ADR-001 | 信頼度ベースの確認/自動切り替え |
| ADR-002 | F-102 + F-107 の 2 機能。TIL = 個人の知識整理ツール |
| ADR-003 | 慎重待機。Stop + SessionStart のみ |
| ADR-004 | ~/til/ フォールバック削除。config.json 実質必須化 |
| ADR-005 | チーム利用対応（author）、F-103 永久除外、UX 改善は v1.2 |