Ponytail 5: 「書く前に既存のものを探す」はしごをエージェントに守らせる(Claude Code/Codex ほか)
Ponytail はエージェントに「必要最小限しか書かない先輩」の振る舞いをさせるスキル(プロンプト1本)。v5 で作り直され、コードを読んでから、既存部品・標準ライブラリ・プラットフォーム機能・導入済みの依存を順に探し、どれも合わないときだけ最小限を書く。
どんな問題を解決する?
- 日付入力を頼むと、ライブラリを入れたりカレンダーを自作したりして数百行になる
- リポジトリにある部品や標準機能を使わず、似たコードを新しく書き足してしまう
- 削るとテストやエラー処理まで消えて危なくなる
仕組み(はしご)
問題とコードの流れを読んで理解したうえで、上から順に試し、最初に合った段で止まる。
- そもそも作る必要があるか
- このコードベースにすでにあるか
- 標準ライブラリでできるか
- ブラウザや OS などプラットフォームの機能でできるか
- 導入済みの依存でできるか
- 1行で書けるか
- ここまでで駄目なら、動く最小限を書く。分岐・ループ・パーサー・お金・セキュリティを含むロジックには小さなテストを1つ付ける
信頼境界での入力検証、データ消失に関わるエラー処理、セキュリティ、アクセシビリティは削らない。回答の最後に「省いたこと・確認していないこと・リスク」を書く。README の例では、日付ピッカーを、既存の Input コンポーネントと type="date" の組み合わせで済ませ、335行が10行になっている。
導入
- Claude Code(2回に分けて入力):
/plugin marketplace add DietrichGebert/ponytail→/plugin install ponytail@ponytail - Codex:
codex plugin marketplace add DietrichGebert/ponytail→codex plugin add ponytail@ponytail。その後/hooksで2つのライフサイクル hook を自分で確認して信頼し、新しいスレッドを始める - その他(Cursor・Copilot・Gemini など):
AGENTS.mdをプロジェクトにコピーするか、skills/ponytail/SKILL.mdをスキルとして入れる - 主なコマンド:
/ponytail [lite|full|ultra|off](強さ)、/ponytail-review(差分レビュー。差分の外で壊れる箇所も見る)、/ponytail-audit(リポジトリ全体を優先度順に)、/ponytail-debt(shortcut:コメントを台帳に集める)
注意点
- 「コード53%減・時間41%減・コスト26%減・トークン45%減」「リスクのあるロジックの98%にテスト(なしだと68%)」は作者のベンチマーク(Claude Code・39タスク・各5回)。自分のリポジトリで効くかは試して確かめる
- 常時有効になるので、他の「簡潔に書かせる」系ルールと重ねると指示がぶつかる。Occam: 「探してから読む・作りすぎない・話しすぎない」の30行ルールでコストを下げる とは併用しない
- v5.3 から Claude Code ではプロンプトの上にコストやトークンの帯(band)が出る。不要なら
/ponytail bandで隠す。集計は手元の~/.config/ponytail/band/に保存される - 作者は「GitHub の DietrichGebert/ponytail と npm の @dietrichgebert/ponytail 以外から入れない。.exe や .dll は含まない」と明記している。人気の OSS は偽物が出やすいので入手元を確かめる
- Cursor・Copilot などルールファイルだけで読むエージェントでは、コマンドは使えず常時ルールだけが効く
- MIT ライセンス。最新は v5.3.3(2026-10-29)