要件定義で、エンジニアは何を持ち寄るのか
要件定義の場で、自分はどんな判断材料を持ち寄れているんだろう。一括承認の仮の例と各社の公開事例を手がかりに、既存設計の見方や、判断が外れたときにどこまで戻せるかを考えました。
要件定義の場で、自分はどんな判断材料を持ち寄れているんだろう、と考えることがあります。
何かを相談されると、まず「今のシステムならどう作れるか」を考えます。どの画面を変えて、どのデータを使うか。そこは考え始めやすいです。ただ、その先まで考えたところで、そもそも相手が何に困っているのか、自分はどれくらい分かっていただろうと思うことがあります。
今の設計を知っている分、その設計の中で答えを探してしまう。既存の仕組みを知っていることを、もう少し違う形で使えないか。いくつか公開されている実践を読みながら、自分が次の打ち合わせで何を聞けるか考えてみました。
一括承認がほしいと言われたら、何を聞くだろう
たとえば、PMから「申請をまとめて承認できるようにしたい」と相談されたとします。自分なら、一覧にチェックボックスを置いて、選んだ申請をまとめて処理するところまで、頭の中で考え始めそうです。
そこでいったん、直近で承認に時間がかかった申請を見せてもらうと、何が分かるでしょうか。金額や添付書類の有無を見るために、毎回詳細画面を開いているのかもしれません。あるいは、承認待ちに気づかず、処理に取りかかるまでに時間がかかっているのかもしれません。前者なら一覧に判断材料を出す案があり、後者なら承認待ちを見つけやすくする方が効きそうです。
AtlassianのTeam Playbookを読むと、案を比べる前に、いろいろな職種の人と問題の背景を確かめる時間を取っています。Marty Caganの「Four Big Risks」にも、技術的に作れるかと並んで、使う人に価値があるか、使いこなせるか、事業として成り立つか、という問いがありました。この例で考えると、「一括承認できます」と答える前に、「いちばん時間がかかっているのはどの作業ですか」と聞くだけでも、持ち帰る話は変わりそうです。Atlassian Team Playbook / SVPG – The Four Big Risks
詳細画面を開くのは、何のためだったんだろう
もうひとつ、自分が見落としそうなのは、今の仕様がそうなった理由です。「詳細画面を開いてから承認する」と聞くと、画面の作り方の話に思えます。でも、承認者に書類の中身を必ず見てもらうために、その順番になっている可能性もあります。申請の種類によっては、金額と添付の有無が分かれば判断できるかもしれない。そこは、実際に承認する人に聞いてみたいです。
一方、担当者以外は承認できないことや、誰がいつ承認したかを追えることが業務上必要なら、どの案でも考慮します。要求を出す人に確認したいのは、その業務で何を守りたいか。自分から出せそうなのは、どの情報をどの画面に出せて、承認すると次に何が動くか。「詳細を開く回数は減らせそうです。書類を見ないと判断できないのは、どの申請ですか?」くらいまで話せると、現行画面を見ながらでも、どういう流れが業務に合うのかを一緒に考えられそうです。
「戻せる」と言うとき、自分は何を想像しているか
Amazonの株主向け書簡では、あとから戻せる判断を「双方向のドア」にたとえていました。Google SREでは、変更を限られた範囲で一定期間動かし、結果を見て広げるか判断します。Spotifyの公開事例にも、段階公開で見る指標を決めて、途中で止めたり判断を保留したりする仕組みがありました。読みながら考えたのは、案を選ぶ段階で「うまくいかなかったらどうするか」まで話しておくと、試し方そのものが変わるのでは、ということです。Amazon – 2016 Letter to Shareholders / Google SRE – Canarying Releases / Spotify Engineering – Experimentation Platform
一括承認の例に戻ると、「機能フラグを切れば戻せます」と、自分も言ってしまいそうです。フラグを切れば、新しい一括承認は止められます。では、すでに承認した申請はどうなるか。通知を受けた人が、次の作業に取りかかっていたらどうするか。誰が何を戻すのかまで考えると、同じ「戻せる」でも話が違ってきます。MicrosoftのAzure Well-Architected Frameworkでも、データの状態が変わると復旧が複雑になり、その扱いを事前に考えておく必要があると説明しています。Microsoft Learn – Safe Deployment Practices
試す人数や一回に承認できる件数を絞れば、影響を受ける範囲は小さくできます。すでに起きた承認の取り消し方は、それとは別に考える必要があります。取り消しの手間が大きいなら、まず実際の承認が発生しない試作品で操作を見てもらうこともできる。「戻せるか」という問いは、案を決めたあとに考えるものだと思いがちでしたが、案を並べた時点で聞いてみると、最初に試すものが変わりそうです。
次の打ち合わせに持っていきたい問い
今回の例で自分が途中で考え直したことを、次の打ち合わせでも思い出せるように書いておきます。
- 誰のどの作業が、どうなったら楽になるんだろう。
- 今の手順は何を守っているんだろう。変えられるところはどこだろう。
- この案で楽になる人は誰だろう。例外が出たときは誰が対応するんだろう。
- 手元の仕組みでどこまでできるか。作ったあとにどんな手間が増えるだろう。
- 判断が外れたらどこまで影響するか。誰が、何を、どこまで戻せるだろう。
- 何が分かれば案を選び直せるか。作り込む前にどう確かめよう。
一括承認の相談なら、まずは「一覧にこの情報が出ていれば、詳細を開かずに判断できますか」と聞いてみたいです。その答え次第で、自分が持っていく案も変わるはずです。今のところ、要件定義で少し意識してみたいのはそこです。どこを直せそうか思いついたときに、その案で何が変わると思っているのかを、相手と一緒に確かめるところまでやってみたいです。