YeonwooSung/my-claude-code-mods

My Claude Code Mods – 概要

Anthropicのコードアシスタント環境である **Claude Code 用のプラグイン（「モッド」と呼ばれます）**のコレクションです。各モッドは、開発者がコーディングセッション中にClaudeの動作を理解し制御するのに役立つ、小さなUIや診断機能を追加します。

各モッドの機能

モッド	機能（平易な説明）
agent‑profiler	セッションの時間がどこで消費されているか（モデルの待機、ツールの実行、サブエージェントの呼び出し、コードの再読み込みなど）を表示します。JaegerやTempoで表示可能なOpenTelemetryトレースをエクスポートすることもできます。
context‑inspector	Claudeがプロンプトウィンドウをどのように使用しているかを分析します。ウィンドウを埋めているテキスト、再読み込みの頻度、重複に近い出力の生成、圧縮される部分などを分析し、コンテキストの無駄を減らすためのアドバイスを提供します。
time‑machine	各ステップの後にファイルシステムの「shadow‑git」スナップショットを撮り、分岐するタイムライン上で全てのツール呼び出しを記録します。任意のステップへの巻き戻し、テストを壊した編集箇所の特定、ファイルの復元、ブランチ作成、実行結果の比較、ステップの再生が可能です。
loop‑detective	Bashの失敗や編集の再試行サイクルを監視します。ループを検出すると証拠を提示し、調査を促し、境界付き履歴を持つライブケースペインを表示します。
pin‑memo	入力ボックスの上にメモやクリック可能なTODOをピン留めできます。同じフォルダやセッションを再度開くと、メモは自動的に復元されます。
model‑effort‑band	プロンプトの上に色付きの帯を描画し、選択されているモデルとモデルが使用しているメインスレッドの負荷を表示して、ワークロードを視覚的に素早く把握できるようにします。

入手方法

Claude Code Modsマーケットプレイスを追加します（READMEにリンクされている公式ドキュメントを参照）。
マーケットプレイスから必要なモッドをインストールします。各モッドのREADMEに正確なコマンドが記載されています。
Claude Codeを実行する際、--plugin-dirでモッドを読み込みます（またはUIから有効にします）。他のインストール済みプラグインは、クリーンなベンチマークのために無効化できます。

開発とテスト

Nodeバージョン – Node 22.19.0以降が必要です。
依存関係 – package-lock.jsonで固定されています。
テストコマンド：
- npm ci --ignore-scripts – 依存関係を正確にインストールします。
- npm test – Claudeのインストールを必要としないコアロジックテストを実行します。
- CLAUDE_BIN=/path/to/claude npm run test:adapters – Claudeと通信するアダプターを含む、エンジン全体のスイートを実行します。
- npm run typecheck – ローカルで生成されたエンジン宣言に対してTypeScriptの型チェックを行います。
READMEの互換性マトリックスには、各モッドが検証済みのClaude Codeバージョン（主に2.1.292、一部早期アクセス版の注記あり）が記載されています。
UI関連のテストはコアユニットスイートとは分離されており、対話的な実行が必要です。

パフォーマンスベンチマーク（説明通り）

READMEでは、以下の制御された実験を推奨しています：

固定されたコミットの大きなリポジトリを選択します。
モッドなし、プロファイラーのみ、タイムマシンのみ、全て有効の4つの構成で同じワークロードを実行します。
--plugin-dirでモッドを明示的に読み込み、他は無効にします。
ウォームアップ後、各構成で少なくとも5回の測定を行い、順序を入れ替えます。
ウォールクロック時間、ツール呼び出し回数、モデルのトークン使用量、平均スナップショットコストを記録します。
中央値と95パーセンタイル値を報告し、純粋なモデルのレイテンシとスナップショット/フックのオーバーヘッドを分離します。

対象ユーザー

Claude Codeによるコード生成に依存しており、モデルのレイテンシ、コンテキスト使用量、ツール呼び出し履歴を可視化したい開発者。
再現性（time‑machine）が必要なチームや、Bashスクリプトの無限ループバグを検知したいチーム（loop‑detective）。
コーディングセッションに素早くメモを残したい人（pin‑memo）。

結論

My Claude Code Mods は、診断、履歴追跡、UIヘルパー機能でClaude Codeを拡張する、小規模で焦点の絞られたツールボックスです。このリポジトリには、ソースコード、Nodeベースのテストハーネス、および公式のClaude Codeマーケットプレイス経由で各モッドをインストールするための明確な手順が含まれています。これは、大規模言語モデルのコーディングアシスタントを使用する際の開発者体験を向上させることを目的とした、本格的なAI関連ソフトウェアプロジェクトです。