外部・可変な契約はコードコメントでなく一次情報で再照合してからレビュー判断する
運用
レビューの合否が外部の可変な契約(プロトコルの MIME タイプ、メタデータのキー、仕様が定めるフィールドの意味など)に依存するとき、リポジトリ内のコードコメントや実装当時の前提を根拠にしない。その契約は仕様側の更新で変わりうるため、判断の直前に現行の公式ドキュメント(一次情報)で値と意味を再照合してから指摘の重大度を決める。
コメントは実装時点の仕様に固定されがちで、それを信じると古い契約のまま承認してしまう。可変契約が絡む箇所は「コードが何をしているか」だけでなく「今の仕様がそれを正しいと認めるか」を一次情報で確かめるのがレビューの筋になる。