ponytail（DietrichGebert/ponytail）：Claude Codeが書くコードを必要最小限に絞るルールを常時追加するプラグイン

ponytail（DietrichGebert/ponytail）は、AIコーディングエージェントに「コードを書く前に、本当に必要か、既存の機能で済まないかを順に確認させる」ルールを追加するプラグイン（スキル）です。GitHubの claude-code トピックでは、2026年10月1日時点で約14.9万スターの3位に入っています。Claude Codeのほか、Codex、Gemini CLI、Cursorなど約20のエージェントに対応します。Claude Codeに機能追加を頼むと、本来はHTMLの標準部品で済む箇所にライブラリやラッパーまで作られてしまうことがあります。ponytailはこうした作り過ぎを抑える目的のツールです。自社サイトや社内ツールの修正をClaude Codeに任せていて、生成されるコードの量やトークン消費が気になる方が主な対象です。

何をするツールか
導入方法（Claude Code）
注意点
まとめ

何をするツールか

エージェントはコードを書く前に、次の順で最初に当てはまる段階で止まります。READMEでは「ラダー」と呼ばれています。

1. そもそも必要か（不要なら作らない）
2. このコードベースに既にあるか（あれば再利用）
3. 標準ライブラリで足りるか
4. ブラウザなどプラットフォームの標準機能で足りるか
5. 導入済みの依存パッケージで足りるか
6. 1行で書けるか
7. 上記のいずれでもない場合のみ、必要最小限を書く

READMEの例では、日付選択を頼まれたエージェントがライブラリを入れる代わりに、HTMLの <input type="date"> 1行で済ませます。READMEは、入力検証、エラー処理、セキュリティ、アクセシビリティは削らない方針だと明記しています。また、問題を理解する段階（関連コードを読む作業）は省かず、省くのは解決策の作り込みだけだと説明しています。

効果についてREADMEは、FastAPIとReactの実在リポジトリでClaude Codeに12件の機能追加をさせた自己計測の結果を載せています。何も入れない場合と比べて、コード行数は平均約54%減、コストは約20%減、所要時間は約27%減です。モデルはHaiku 4.5、各4回の試行で、すでに最小のコードに対しては差がほぼ出ないとも書かれています。これは作者側の計測で、当ブログでは未検証です。

導入後は次のコマンドが使えます。

/ponytail [lite | full | ultra | off]：強度の切り替え。引数なしで現在の強度を表示
/ponytail-review：現在の差分を過剰設計の観点でレビューし、削除候補を返す
/ponytail-audit：差分だけでなくリポジトリ全体を同じ観点で監査
/ponytail-debt：先送りにした簡易対応を台帳にまとめる
/ponytail-gain：ベンチマークに基づく効果の表示
/ponytail-help：コマンドの一覧

導入方法（Claude Code）

Claude Code上で、次の2つのコマンドを実行します。READMEには、2回に分けて別々のプロンプトとして送らないとインストールできないと書かれています。

/plugin marketplace add DietrichGebert/ponytail

/plugin install ponytail@ponytail

インストール後は、新しいセッションから常時有効になります。既定の強度は full です。既定値を変えるには、環境変数 PONYTAIL_DEFAULT_MODE（lite / full / ultra / off）か、~/.config/ponytail/config.json の defaultMode を使います。設定ファイルは必須ではありません。

export PONYTAIL_DEFAULT_MODE=lite

有効な間は、Agentツールで起動されるサブエージェントにも同じルールが注入されます。範囲を絞るには、環境変数 PONYTAIL_SUBAGENT_MATCHER にエージェント種別の正規表現を指定します（例：explore|general）。Claude Code以外では、Codexは codex plugin marketplace add、Gemini CLIは gemini extensions install など、エージェントごとに手順が用意されています。ルールファイル（AGENTS.mdなど）をコピーするだけの方法もありますが、その場合は上記のコマンド類は使えません。

注意点

Node.jsが必要です。Claude CodeとCodex向けのプラグインは、小さなNode.jsのライフサイクルフック2つを実行します。node が非対話シェルのPATHに無い場合、スキル自体は動きますが、常時有効化の機能が働かなくなります。
フックはローカルで実行されるコードです。プラグインを入れると、毎回のプロンプト送信時にこのフックが動き、ルール文がエージェントに注入されます。サーバー上の作業環境に入れる場合は、事前にリポジトリの hooks/ の中身を確認しておくと安心です。私はフックのソースコードまでは読んでいません。
認証情報と外部通信：READMEには、APIキーやアカウント登録を求める記述、および外部への通信に関する記述は見当たりませんでした。ただしこれはREADMEの範囲の話で、実際の通信の有無は未確認です。
作者の計測値は自己計測です。効果はモデルやタスクによって変わり、READMEでも、思考トークンを多く使う推論型モデルでは逆効果になりうると書かれています。
READMEにはウェイトリストのバナーや提携先の紹介があります。本体の導入には関係しませんが、リンク先に入力を求められた場合は目的を確認してからにしてください。

ライセンスはMITです。