記録される内容と分析の仕組み

すべてのセッションで記録される内容

セッションごと：プロジェクト、ブランチ、Claude Code のバージョン、開始／終了、経過時間と実稼働時間（15 分を超えるアイドル時間は除外）、 人間のプロンプト（Claude の作業中にキューに入れたものを含む）、スラッシュコマンド、中断、コンパクション、所要時間と成否付きのすべての ツール呼び出し、行数付きの読み込み・編集ファイル、固有の使用量を持つサブエージェントとワークフロー、スキル、MCP サーバー、フック、 PR と成果物、そして API 呼び出しごとのトークン使用量（メッセージ単位で重複除去）と API 定価による費用の見積もり。見積もりは、 単一プロセスのセッションでは Claude Code 自身の cost-state とセント単位で一致します。サブスクリプションの請求とは異なります。

分析済みのセッションごと：タイトル、要約、目的、結果、作業の種類、タグ、ハイライト、未解決の事項、つまずき、雰囲気、そしてナレッジ項目：

種類	意味
fix	失敗、その根本原因、修正方法
gotcha	落とし穴と、その避け方
learning	技術やコードベースについての気づき
decision	設計上の判断と、その理由
pattern	再利用できる手法やスニペット
command	役立つコマンドの使い方
fact	プロジェクトの構成、設定、エンドポイント、デプロイ
preference	Claude にどう作業してほしいか
reference	外部への参照
todo	後で対応すること

Claude 自身の自動メモリーノート（projects/*/memory/*.md）と Codex のメモリーノートも、ナレッジとして取り込まれます。

Codex、Copilot、Bob のセッションも、ログにデータがある範囲で同じ項目を埋めます。たとえば Copilot Chat のログにはキャッシュの内訳がない （そのため費用の見積もりもない）、Bob のタスクには呼び出しごとの所要時間がない、といった違いがあります。

分析の仕組み

1. セッションは、終了した時点（フック）か、idle_minutes の間アイドルになった時点でキューに入ります。
2. トランスクリプトは、chunk_chars に収まる範囲で最も詳しいレベルの要約にまとめられます（プロンプトと応答の全文、ツール呼び出しは 1 行ずつ、 エラーの抜粋、サブエージェントの報告）。非常に長いセッションはプロンプトの境界で分割し、map-reduce で処理します。機密情報は最初に伏せ字にします。
3. ダイジェストは analysis.backend で選んだエージェントに、あなた自身のログインを通じて送られます。サンドボックス内で動くので、 分析そのもののセッションは書き出されず、あなたのフック・プラグイン・MCP サーバー・指示ファイルは読み込まれず、 モデルは回答することしかできません：
4. Claude Code（backend = "claude"、既定）：claude -p --no-session-persistence --safe-mode --tools "" --strict-mcp-config。
5. Codex（backend = "codex"）：codex exec --ephemeral --ignore-user-config --sandbox read-only。 ツール機能（シェル、コード実行、サブエージェント、アプリ、プラグイン、Web 検索、画像）をすべて切り、フック、AGENTS.md、 スキルの指示も切り、Codex 自身の指示の代わりに Chronicle の指示を使います。Codex はすべてのツールをフラグで切れるわけでは ないため、Chronicle はイベントストリームも読みます：ツール呼び出しのあとに来た応答は捨てられ、その分析は失敗として扱われます。

これらの実行中は CHRONICLE_INTERNAL=1 によって Chronicle 自身のフックが無効になります。エージェントは Status › Analysis、chronicle config set analysis.backend codex、または 1 回の実行だけなら chronicle analyze --backend codex で切り替えられます。 4. JSON の応答は寛容に検証され（修復は 1 回まで）、保存されます。プロジェクトに min_new_items 件の新しい項目がたまると、 そのプロジェクトのナレッジベースが再統合され、古くなった項目や重複した項目は superseded（置き換え済み）になります （ピン留めした項目とメモリー項目は置き換えられません）。終わった週のセッションがすべて分析されると、モデルがその週の振り返り （3 行の要約、テーマ、成果、学び、未解決の事項、繰り返し起きたつまずき、作業の進め方への具体的な提案）を書きます。 ナレッジベース、プレイブック、振り返りは流し読みできるように書かれます：3 行の要約、短い概要、ナレッジベースの各項目の見出し、 すべての項目への字数の上限。振り返りの数値とグラフはモデルではなくデータベースから作られます。 5. 使用量の上限や認証のエラーが出ると、分析を 1 時間停止します。その他の失敗は 30 分 → 2 時間 → 8 時間と間隔を空けて再試行します。 呼び出しには実時間の期限があり、Mac のスリープで止まった呼び出しは復帰直後に強制終了され、失敗としては数えずにキューに戻されます。 分析後に続きが行われたセッションは、再び分析されます。

費用：分析はあなた自身の Claude Code または Codex のログインを通じて行われます。Claude の場合、表示される費用は API 定価に換算した 金額です。Sonnet ではセッションあたり平均約 $0.38 でした（要約の平均は約 15 万文字）。max_budget_usd で 1 回の呼び出しの上限を 設定できます。Codex はトークン数を報告しますが価格は報告しないため、Codex による分析には費用が表示されません。Claude や ChatGPT の サブスクリプションでは、請求ではなくプランの使用枠から消費されます。chronicle analyze --pending --dry-run で、使う前に未分析分の 規模を確認できます。