retro

ユーザーは振り返りを求めています。今後の実行を改善するため、コーディングエージェントの環境に対する改善案を提示します。

手順

1. 執筆スタイルガイドとして、write-skillsを読みます。

2. ユーザーが指定したセッションの一次資料を読みます。これには、このマシン上のセッションログを検索することが含まれる場合があります。ユーザーがセッションを指定しない場合は、現在のセッションを既定として使用します。

3. 次のカテゴリで改善候補を探します。

• ナビゲーション：エージェントは適切なファイルをどれだけ簡単に見つけられましたか？ファイル間に隠れた依存関係はありますか？ナビゲーションポインターがあれば、見つけやすくなりますか？この項目を使う状況：セッション中に情報を見つけるまでに長い時間がかかった場合。
• 自動チェック：エージェントが犯したミスを検出できる自動チェックはありますか？リンティング、型チェック、テスト、ファイルシステムのリンターなどです。まずリポジトリ独自のチェックコマンド（package.json／ビルドツールのlint／checkスクリプト、CIワークフロー）を確認してください。すでに存在するのに未接続、または気づかれないまま機能していないチェックがあれば、それが改善点であり、同じものを作り直すことではありません。ガードレール（リント／型チェック／テストのコマンドを実行するプレコミットフックもCIジョブもない）がまったくないリポジトリ自体も改善点です。リントされていないリポジトリは、見過ごされている機会が常にある状態であり、中立的な既定値ではありません。この項目を使う状況：自動チェックで検出できるミスをエージェントが犯した場合、またはリポジトリにガードレールがまったくない場合。
• コーディング規約：レビュアーエージェントに、新しいルールを適用させるべきですか？既存のルールを削除または明確化すべきですか？まず違反の種類を分類してください。機械的な違反（固定された構文パターン、禁止API、インポート形式、ファイル配置ルール）なら、例外なく決定論的なチェックを追加します。リポジトリ独自のリンターにカスタムルールを追加する、新しいプレコミットフックを追加する、新しいCIジョブを追加する、のいずれかから、そのリポジトリの言語と既存のガードレールに照らして最も手間の少ない方法を選びます。ルールを書くより、チェックを構築することを優先してください。CODING_STANDARDS.mdは、本物の判断が必要な事項（複数ファイルにまたがる一貫性、「周囲のスタイルに合わせる」といった事項、ガードレールでは代替できない事項）に限定します。この項目を使う状況：レビュアーエージェントがミスを見逃した場合。
• グローバルなAGENTS.md：コーディング規約や自動チェックに移すべき指示がAGENTS.mdにありませんか？この項目を使う状況：リポジトリ内、またはユーザーのグローバルスコープにあるAGENTS.mdが特に大きい場合。
• ツールの効率：エージェントが、効率化できる高コストなツール呼び出しを行っていませんか？特にトークン効率の悪いカスタムツール（CLIやMCP）はありませんか？この項目を使う状況：エージェントが高コストなツール呼び出しを行った場合。
• 効果のない指示：エージェントの動作を変えない、ステアリングファイル内の指示を探します。この項目を使う状況：ステアリングファイルが大きく、扱いにくい場合。
• 情報へのアクセス：エージェントが情報にアクセスできる機会を増やせませんか？開発サーバーのログを随時確認できるようにする、サードパーティーサービスへの読み取り専用アクセスを追加する、といった方法があります。この項目を使う状況：エージェントにとって重要な情報が利用できなかった場合。

4. これらの候補を、重大度の高い順にユーザーへ提示します。

参考

実装とレビュー

すべての作業は、実装とレビューの2段階で進むことを忘れないでください。実装エージェントは、最もコンテキストの余裕が少ない状態にあります。調査、コードの作成、失敗のデバッグを担当します。

レビューエージェントは、コンテキストの余裕が最もあります。差分を受け取るため、調査は不要です。多くの場合、コードの作成やデバッグも必要ありません。

したがって、コーディング規約を適用する役割は実装エージェントではなく、レビューエージェントが担うべきです。

ファイル

リポジトリ内のいくつかのファイルを利用できます。

• CLAUDE.md/AGENTS.md：これらのファイルは、このリポジトリで作業するすべてのエージェントのコンテキストウィンドウに読み込まれます。通常は他のファイルへのナビゲーション用ポインターとしてのみ、ごく控えめに使用してください。
• CODING_STANDARDS.md：このファイルは実装時ではなく、レビュー時に読み込まれます。規約ファイルが1,000行を超える場合は、ドキュメントフォルダーへのナビゲーション用ポインターを追加してください。
• ドキュメント：他のファイルから参照される資料として使用してください。新しいドキュメントを書く前に、既存のドキュメントを確認してください。
• スキル：説明がエージェントのコンテキストウィンドウに読み込まれるため、ドキュメントにはスキルを使用してください。または、ユーザーが呼び出すコマンドにも使用できます。write-skills の指示に従ってください。