The Engineering of Intent 第26章:現場のエンジニアのためのチェックリスト
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第26回です。前回の記事では、デバッグ・プレイブックをパラパラとめくりました。第26章は本書で最も短い章です──私が作業の途中で実際に手に取る、1ページに収まる6つのチェックリストを紹介します。
チェックリストは弱さの証ではない
印刷してください。机のそばに置いてください。そして使ってください。チェックリストは、プレッシャーの下では記憶が当てにならないことを学んだエンジニアの証です。
6つのチェックリスト
- 事前確認:新機能。8項目。「この機能が何であり、何でないかを1文で言えるか」から、「テストがパスする以外に、『完了』がどういう状態かわかっているか」まで。
- 事前確認:プルリクエスト。品質ゲートのスタックをローカルで実行し、出力を読む。一貫性チェック・プロンプト(Consistency-Check Prompt)を実行する。敵対的レビュー・プロンプト(Adversarial Review Prompt)を自分自身の差分に対して実行する。Specsを更新する。ロールバックの計画を立てる。
- 事前確認:本番デプロイ。フィーチャーフラグはデフォルトでオフ。5分以内に機能するロールバック計画。リグレッションを見るメトリクスを特定済み。オンコール担当に通知済み。「自分の頭は冴えているか?」(金曜の18時のデプロイは、よく知られたアンチパターンです。)
- インシデント後。24時間以内に文章で報告をまとめる。症状ではなく根本原因。リグレッションテスト。ある種類の問題が明らかになったなら規約のルールを追加。非難しない形で共有。1週間後にフォローアップ。
- コンテキストパックの健全性(毎週)。正確さ、最新性、サイズ予算の順守、例の代表性、そしてオンボーディング・テスト──新しく入ったエンジニアがこれを読んで、正しい変更を行えるか?
- 面接:AIネイティブなエンジニア。公開しているプロジェクト。書かれた計画。デバッグのトランスクリプト。簡潔で的確なコンテキストパック。いつ監督し、いつ引き渡すかの判断力。教訓ファイル。エージェントが生成したバグを自分で見つけたエピソードが少なくとも1つ。
「チェックリストはあなたを遅くしません。チェックリストが遅くするのは、高くつくミスを犯そうとしていたほうのあなたです。そのあなたは、自分がどちらのあなたなのかを知りません。チェックリストは知っています。」
次回 ── 第27章「アンチパターン──やってはいけないこと」 チェックリストが「やるべきこと」を示すものだとすれば、第27章は、チームが実践でつまずく25のパターンを集めた長いカタログです──スピードに見えて、四半期を丸ごと犠牲にする魅力的な近道の数々です。
📖 さらに詳しく知りたい方へ
本章では、各チェックリストを全項目そろった完全な形で紹介しています。一度印刷して、モニターにテープで貼ってください。コストは紙1枚。見返りは、出荷を取り消さずに済んだすべてのものです。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ