retro

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

手順

1. Skill ツールを writing-for-agents とともに呼び出し、執筆スタイルガイドを確認します。

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

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

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

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

参考

実装とレビュー

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

レビュアーエージェントは、コンテキスト圧迫が最も少ない立場です。差分を受け取るため、調査は不要です。コードを書いたり、デバッグしたりする必要もないことがよくあります。

そのため、コーディング規約の適用は実装エージェントではなく、レビュアーエージェントが担うべきです。

ファイル

リポジトリ内の複数のファイルを利用できます。

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