ds-lessons

ds-lessons

エージェントが無視できる指示は、単なる希望です。繰り返し起こるミスは、確実に検出できるようにしましょう。

手順

1. ミスを集めます。現在のセッション、最近のコミット、取り消し、レビューコメント、エージェント向け指示ファイル、回避策に関するコメントを読みます。ミスをクラスに分類します。同じミスが2回起きたら、1つのクラスとして扱います。
2. 各クラスについて、機能する最も上位のレベルを選びます。
   1. 構造：状態の各要素に所有者を1つだけ設け、各タスクでサポートする方法を1つにし、内部の詳細を隠し、エージェントがまねる可能性のある古いパターンを削除します。
   2. 型：誤った状態を記述できないようにします。
   3. リンターまたは CI チェック：エラーメッセージで、使用すべきファイル、型、関数を明示します。誤ったパターンがすでに一般的な場合は、新たに追加されたものだけを失敗させます。
   4. テスト：内部の実装ではなく、動作を検証します。
   5. ドキュメントまたはエージェント向けルール：チェックでは検証できない判断に限ります。失敗例を短く追加します。
3. 発生頻度の高いクラスから、今すぐ修正します。各修正は1つずつコミットします。
4. 新しいチェックを1つずつ検証します。過去に実際にあったミスを再現してチェックを実行し、失敗することを確認します。その後、再現したミスを取り除いて、チェックが通ることを確認します。
5. エージェント向け指示ファイルに、ルールと、そのルールを強制する仕組みを表にまとめます。ルールがすでに存在していても、強制する仕組みがなければ、再発したものとして今すぐ対処します。
6. セッション終了時に振り返りを行います。うまくいかなかったこと、余分な手戻りが発生したこと、ユーザーから修正されたことを列挙します。各項目をチェック、スキルの修正、またはルールに反映します。一度限りの問題は対象外にします。

ここで終了します

• 選んだ各クラスに対し、実際のミスで失敗することを確認した強制策を設けた場合。
• または、今のセッションで上位3つのクラスに対処した場合。残りは記録します。

ルール

• 修正が構造によるものなら、説明文も追加しないでください。説明文は症状にすぎません。
• 各クラスについて、根拠、選択したレベル、より上位のレベルが機能しなかった理由を報告します。