Ponytail

新しいコードが必要かを先に考える

Ponytailは実装前の判断手順を示します。まず作業の必要性を確認し、既存の実装を調べ、標準機能やプラットフォーム側の解決策を探してから、新しい抽象化を検討します。必要な動作を保ちながら、保守の負担を小さくすることが目的です。

例えばURLの解析なら、プラットフォームのURLパーサーで対応できるかもしれません。大切なのは、代替実装の行数の少なさではなく、実際の入力やエラーケースを処理できるかどうかです。

追加予定の小さな機能でスキルを試す

1. 公式リポジトリで 、使用するホストのインストール手順を選びます。
2. スキルをインストールまたは有効化し、該当する場合はプラグインのフックとNode.jsの要件を確認します。
3. 新しいエージェントタスクで小さな機能を依頼し、最初に既存コードを確認するよう指定します。
4. 変更を採用する前に、差分で再利用、テスト、検証、エラー処理を確認します。

行数だけでなく保守コストを測る

追加される依存関係、公開APIの範囲、レビュアーが理解すべき概念の数を比較してください。短くても不透明な抽象化より、少し長くても明示的な実装が適切な場合があります。Ponytailはこうした選択を見直すための継続的な指針として使い、正しさは引き続き自分でレビューしてください。