リリース前夜、手元のチェックリストを見ながら何か抜けている気がして考え込む開発者
テスト・品質約14分

AIにリリース前チェックリストを作らせる｜抜けを埋める使い方

リリースの前夜、確認は一通り終わっているのに、まだ何か残っている気がして手元のリストをもう一度見る。行はちゃんと埋まっている。それでも、去年の「あれ」を思い出して落ち着かない。——この感じ、身に覚えがあるかもしれません。

AIに「リリース前のチェックリストを作って」と頼むと、答えは3秒で返ってきます。しかも、それらしい。テストの実行、バックアップ、切り戻し、関係者への連絡。抜けはなさそうに見えます。

ただ、実際に当日それを持って作業に入ると、手が止まる行が出てきます。「テストを実行する」——どのテストを、誰が？「切り戻せるようにしておく」——具体的に、何をどうやって？そして、今回いちばん怖い場所、たとえば入れ替えたばかりの認証まわりや、初めて触ったバッチのことは、リストのどこにも書かれていない。

これは頼み方が下手だったからではありません。AIは「一般的なリリース」を知っていても、今回の変更と、あなたの現場が過去にどこで転んだかを知らない。それだけです。この記事では、そこをどう埋めるかを整理します。

結論：AIにリリース前チェックリストを作らせるときの要点は3つです。①「リリース前チェックリストを作って」と白紙で頼まない。今回の差分（変更したファイル・機能の一覧）を渡して、「この変更でだけ壊れうる箇所」を出させる。②リストを2階建てにする——毎回変わらない定番（10行前後、自分たちで育てる）と、AIに毎回作らせる今回だけ。混ぜると、どちらも形骸化します。③出てきた行を「どこを見て、何が見えたらOKか」の形に直す。判定できない行は、チェックリストではなく祈りです。

AIが得意なのは思い出させること、苦手なのはあなたの現場の事故を知っていること。だから、定番の10行だけはこちらが持ちます。

全部を今日やる必要はありません。まずは①の「差分を渡す」だけでも、返ってくるものは変わります。

何が起きているのか——一般論のリストは、なぜ役に立たないのか

使い込まれたバインダー、新しい紙に今回ぶんを書き足す様子、来た道を指す道しるべを並べた図
チェックリストは2階建てにする。毎回同じ「定番」、今回の変更から作る「今回だけ」、そして必ず1行入れる「戻し方」

理由は3つあります。どれも、こちらの落ち度ではありません。

1つ目は、チェックリストの価値が「網羅」ではなく「記憶」にあること。現場のリストで本当に効いている行は、たいてい過去に一度やらかした行です。「バッチを止めてから入れ替える」「キャッシュを消す」「あのお客さんにだけ先に連絡する」。これらは教科書には載っていません。社内の記憶にしかないからです。AIはその記憶を持っていないので、代わりに平均的な項目で埋めます。

2つ目は、行が増えるほど読まれなくなること。40行のリストは、当日ほぼ全部にチェックが付きます。読んで判断した結果ではなく、手を動かした記録として付きます。長いリストは安心感を生みますが、注意は分散します。ここは、AIに頼むと自然に悪化する方向です。何行でも出せてしまうので。

3つ目は、リリースが「順番のある作業」だということ。確認だけなら順不同でも構いませんが、リリースには順番があります。止めてから入れ替える、入れ替えてから流す、流す前に戻せるか確かめる。AIが出すのは項目の集まりで、順番と担当は入っていません。当日いちばん困るのは、抜けよりむしろ「これ、今やるんだっけ、誰がやるんだっけ」という一瞬の空白です。

裏を返すと、今回の差分と、過去に転んだ場所さえ渡せば、AIはかなり働きます。思い出させる相手としては優秀なので、材料だけこちらで用意する、という分担にします。

具体例——AIのリストで抜けやすい行

白紙で頼んだときに落ちやすいのは、次のあたりです。一つでも心当たりがあれば、この記事はそのまま使えます。

どれも、注意力の問題ではありません。渡していない情報は、書かれようがないというだけの話です。

影響——困るのは、いちばん引き返しにくい時間帯

リリース前の抜けが少し特別なのは、平時にはまったく害がないところです。顔を出すのは、決まって夜間や早朝の、人が少ない時間です。

ただ、ここは強調しておきたいのですが、この種の抜けは、前日までなら本当に安く埋まります。当日に足りないものを探すのは大変でも、今日「戻し方は書いてあるか」と一行問うのは1分です。いま準備の手前でこの記事を読んでいるなら、それはいちばん安いタイミングにいるということです。

明日からやること（3ステップ）

順番に、小さく始められます。今日は1だけでも十分です。

1. 今回の差分を渡して、「今回だけ」を出させる

白紙で頼まず、変更したものの一覧を先に渡します。差分そのものを貼ってもいいですし、量が多ければ「変更したファイルの一覧と、機能の要約」でも構いません。差分の扱い方はAIに複数ファイルの変更を任せる｜差分を見失わない追い方と同じ考え方です。

そのまま使える頼み方の例：

以下は、今回のリリースに含まれる変更の一覧です。一般的なリリース手順は書かなくて結構です。 この変更でだけ壊れうる箇所に絞って、リリース前に確認しておく項目を10個以内で挙げてください。それぞれ、①何を確認するのか ②どこを見れば分かるのか ③何が見えたらOKか、の3点で書いてください。

あわせて、次の観点で抜けていそうなものを指摘してください。

1. コードの外の作業（ジョブ・バッチの停止と再開、キャッシュ、機能フラグ、初回だけのデータ投入）
2. 本番にしかない条件（設定値・秘密情報・データ量・他システムとの実接続・権限）
3. 戻せなくなる変更（データベースの構造変更、消してしまうもの、外部へ送ってしまうもの）
4. 他チーム・他システムへの影響（先に伝えるべき相手はいるか）

前提：
（利用者の規模、リリース時間帯、使っている仕組みを2〜3行で）
変更の一覧：
（ここに差分またはファイル一覧と要約）

「一般的な手順は書かなくて結構です」を先に伝えるのが要点です。これを言わないと、返事の半分が教科書的な項目で埋まり、今回だけの数行が埋もれます。

返ってきたものは、そのまま信じずに1つずつ「これは本当に今回関係あるか」を見てください。関係ない行を丁寧に落とすほど、リストは強くなります。落とす判断の付け方はAIレビューの指摘を取捨選択する判断軸｜直す・保留・落とすが使えます。

2. 「定番」の10行を、自分たちの記憶から作る

こちらは毎回変わらない土台です。AIに考えさせるのではなく、思い出す手伝いをさせます。材料は、過去の障害の記録、リリース後に慌てた日のやりとり、当時のチャットのログ。手元にあるものを渡して、こう頼みます。

以下は、過去のリリースで起きたトラブルの記録です。再発を防ぐために、毎回確認すれば防げたはずの項目だけを抜き出して、短い行にしてください。同じ趣旨の行はまとめて、全体で10行以内にしてください。1行は、当日その場で見て判断できる言い方にしてください。

ここで出てきた10行が、あなたの現場の「定番」です。教科書には載っていない代わりに、実際に一度は転んだ場所が入っています。これは資産なので、ファイルに置いてリポジトリで一緒に管理し、事故があるたびに1行足す。増えたら、効かなくなった行を1行削る。10行前後を保つのが、読まれ続けるコツです。

そして、定番には必ず「戻し方」の行を1本入れます。図の右側です。「アプリを前の版に戻す手順が書いてあるか」「データベースの変更も戻せるか、戻せないならその判断は誰がするか」。ここだけは、毎回書いてある状態にしておくと、当日の気持ちがずいぶん違います。

3. 各行を「見る場所とOKの条件」に直す

最後に、定番＋今回だけを並べて、1行ずつ言い換えます。直すのは3点だけです。

例：

書き換えは面倒に見えますが、実際にやってみると、この作業自体が抜けの発見になります。「見る場所が書けない」行は、たいてい確認方法が決まっていません。「OKの条件が書けない」行は、正常の姿を誰も定義していないということです。当日に気づくより、今日気づくほうがずっと安く済みます。

順番と担当が入ったら、上から実行できる形に並べ替えて完成です。作業の並べ方はAIに実装タスクを分解させる｜WBSの抜けを見つける使い方の考え方がそのまま使えます。

リリース前チェックリストのチェックリスト

全部に○が要るわけではありません。気になった行だけで十分です。

① AIに頼む前に

② 出てきたリストを見るとき

③ 出す前に

この記事のまとめ

AIはリリース前チェックリストを、驚くほど速く、それらしく書きます。得意なのは思い出させることと、今回の差分から効く項目を絞ること。苦手なのは、あなたの現場が過去にどこで転んだかを知ることです。それは、渡していない情報だからです。

やることは3つだけです。①差分を渡して「今回だけ」を出させる／②過去の記録から「定番」10行を作る／③各行を「どこを見て、何が見えたらOKか」に直す。この3つがあると、チェックリストは「安心のための儀式」から、「当日その場で判断できる道具」に近づきます。

リリースを終えて、静かな安堵の表情で顔を上げている開発者

リリース前の落ち着かなさは、たぶん一生なくなりません。責任のある仕事をしている証拠のようなものだからです。それでも、リストが「見れば判断できる形」になっていると、不安の量は確実に減ります。今日、手元のリストから役に立たない1行を消して、戻し方の1行を足せたなら、それだけで次のリリースの夜は少し静かになります。

よければ、こちらも

関連用語