終わったセッションを7つの観点で振り返り、リポジトリ側を直す（mattpocock の /retro）
mattpocock/skills v1.3 の /retro は、直近のエージェントとの会話を読み返して「次の回が楽に進むようにリポジトリのどこを直すか」を、深刻な順に出す。観点は7つで、機械的に止められる違反はルール文ではなくチェック（lint・スクリプト）にするのが基本方針。
どんな時に使う？
- エージェントがファイル探しや同じ失敗で時間を使ったセッションの後
- 振り返りを自分で一からやる時間がない。案を読むところから始めたい
手順
claude plugin install mattpocock-skills@claude-plugins-officialで入れ、作業が一区切りしたら/retroを明示的に呼ぶ（自動では発火しない設定disable-model-invocation）- 7つの観点で見させる
- Navigation: 目的のファイルを見つけるのに時間がかからなかったか。ファイル間の隠れた依存はないか。道しるべ（navigation pointer）を置けば早くなるか
- Automated checks: エージェントのミスを止められるチェック（lint・型・テスト・ファイル配置の linter）はあるか。提案の前にリポジトリの
lint/checkスクリプトや CI を読み、「あるのに配線されていない・黙って壊れている」ならそれを指摘にする。pre-commit も CI もないリポジトリはそれ自体が指摘になる - Coding standards: レビュー役に新しい規則を渡すべきか、古い規則を消すべきか。決まった構文・禁止 API・import の形・ファイルの置き場のような機械的な違反は、linter のカスタムルールや pre-commit、CI のジョブにする。CODING_STANDARDS.md に書くのは判断が要るものだけ
- Global AGENTS.md: AGENTS.md（リポジトリ内・個人のグローバル両方）が大きすぎるとき、規約やチェックに移せる指示はないか
- Tool economy: 高くつくツール呼び出しはなかったか。トークン効率の悪い自作 CLI や MCP はないか
- No-ops: 指示ファイルの中に、書いてあっても挙動を変えていない指示はないか
- Information access: 必要な情報に届いたか。開発サーバーのログを tee で残す、外部サービスに読み取り専用で入れる、など
- 出てきた案は深刻な順に読み、上から採用する
- 置き場の原則も SKILL.md に書かれている: CLAUDE.md / AGENTS.md は全エージェントの文脈に入るので道しるべだけにする。CODING_STANDARDS.md は実装中ではなくレビュー中に読ませる（1,000行を超えたら docs への道しるべを足す）
注意点
- 似た発想の既存記事: /retro: 繰り返す作業は「CLI + skill」に落とす、/retro: チームのPRレビューコメントから CODING_STANDARDS.md を育てる、Claude Code: /insights のレポートを毎週読み、そのまま Claude に渡して使い方を直させる
- 「ルールより hook」の考え方は Claude Code: 「〜したら〜して」はルールではなく hooks（settings.json）に書く
- 同じ v1.3 の
/prは AI に書かせる PR 説明は「要約・根拠・取り込む危険度」の3節に固定する（mattpocock の /pr）