AI を古いコードベースで動作させるカーソル ルールの作成
AI コーディング アシスタントは制約を認識していないため、レガシー プロジェクトでは不正な動作をします。短いルール ファイルにより、悪い差分の半分が修正されました。
4 年前のコードベースでのエージェント駆動開発の最初の 1 週間で、数か月にわたって議論してきた 3 つのチームの規約と 1 つのアーキテクチャ上の決定に違反する美しいコードが生成されました。この修正はプロンプトを改善するものではありませんでした。それは憲法を書き留めることだった。
優れたルール ファイルは短く、ネガティブです。私のリストでは、コードベースが決して実行してはいけないことをリストしています。新しい状態管理ライブラリは使用しない、日付は Date ではなく dayjs である、すべての API ルートは既存の zod スキーマで検証される、そして、尋ねることなく Legacy/ の下にあるファイルには決して触れないでください。モデルの動作を変えるのは願望ではなく制約です。
予想外の成果は、各ルールの理由を 1 つの条項に文書化することでした。前四半期に移行が失敗したことを知っているモデルは、単に注意するように指示されたものよりも、より慎重な移行コードを作成します。コンテキストによってルールは従うものから理解されるものに変換され、理解されたルールはリストに記載されていないケースに一般化されます。
ローカル規則用にディレクトリごとに 2 番目のルール ファイルを保持します。コンポーネント フォルダーには独自のルールがあり、グローバル フォルダーを肥大化させたいという衝動には抵抗します。最初の草稿を 40 行から 12 行に減らし、差分が改善されました。追加するたびに重要な行が薄まるからです。
6 週間後、目に見える結果が得られました。規約違反の差分は約 3 分の 1 からほとんどなくなり、コード レビューのコメントはスタイルからロジックに戻りました。ルール ファイルは、私がこれまでに雇った中で最も安価なシニア エンジニアです。