/retro: チームのPRレビューコメントから CODING_STANDARDS.md を育てる
過去のPRレビューコメントをエージェントに読ませ、繰り返し指摘されている事項をコーディング規約ファイルへの追記案にさせる。エージェントのセッション終了後にも「何に手こずったか」を振り返らせる。
どんな時に使う？
- 同じレビュー指摘（命名、エラー処理、テストの書き方…）が何度も出る
- エージェントが毎回同じ回り道（ワークアラウンド）をしている気がする
手順
- PR コメントから規約を起こす（
ghが使える環境で）チームの GitHub PR レビューコメントを、アクセスできる範囲でできるだけ多く読んで。 繰り返し出ている指摘を CODING_STANDARDS.md への追記案にまとめて（必要ならテーマ別に複数ファイルへ分割）。 各ルールに元になったPRのリンクを付けて。 - エージェントの作業セッションごとに振り返り
このセッションを振り返って、非効率だった所・ワークアラウンドで回避した所を挙げ、 スキル / 規約 / hooks のどれを直せば次回防げるか提案して - 提案は人がレビューしてからマージ。AGENTS.md には「規約は CODING_STANDARDS.md を参照」と1行だけ書く（本文を AGENTS.md に積まない）
注意点
- 1回の指摘を規約化しない。複数回出たものだけに絞らないと規約が肥大化する。
- 機械的に検査できるもの（import 順など）は規約文より lint に回す（AIコーディング: 「指示を書く」は最終手段。lint・ビルドエラー・hook・skillで機械的に縛る）。
- Matt Pocock の skills（
mattpocock/skills）には/retroスキルとして入っている。成功したセッションでも回す価値がある、とのこと。