改修の「完了の定義」を依頼者と合わせる｜手戻りを防ぐ確認の型
「CSV出力、直しておきました」。 そう伝えたら、少しして返ってきたのは「ありがとうございます。……あ、でも、先月分のデータも出るようになってますか？」。 いや、そこは聞いていなかった——と思いつつ、もう一度コードを開く。一人で保守をしていると、こういう「直したのに終わらない」改修、けっこうありますよね。
これは、あなたの理解力や確認不足のせいではありません。多くの場合、「どうなったら完了か」を、依頼者と自分で別々に思い描いたまま進んでいただけです。依頼者の頭の中には「これができたら完了」という絵があって、こちらの頭の中にも別の絵がある。その2枚を、着手前に1回だけ重ねておく。それだけで、手戻りはかなり減らせます。
この記事では、改修の「完了の定義」を依頼者と合わせるための確認の型を、そのまま使えるメモの書き方と一緒に整理します。
結論：改修に着手する前に、①「誰が・どの画面で・何をしたら・何が見えればOKか」を1文で書く → ②「やらないこと」と例外ケースの扱いを決める → ③「本番に出たら完了」か「依頼者が確認したら完了」かを決める → ④その完了条件を依頼者に書き戻して「これで合っていますか」と聞く。完了の定義は、作り始める前の数分で合わせるのがいちばん安上がりです。
依頼の「何を・なぜ・どこまで」を聞き出す段階は、あいまいな改修依頼を要件に落とすヒアリングの型で整理しています。この記事はその続きで、聞き出した要件を「確かめられる完了条件」に変えるところを扱います。
何が起きているか：「直した」と「終わった」がずれる理由
手戻りが起きた改修をふり返ると、たいてい次のどれかが当てはまります。
- 完了の基準が「動いた」だけだった：こちらは「エラーが出なくなった＝完了」、依頼者は「月末の締め作業が今までどおりできる＝完了」。どちらも間違っていないのに、見ている場所が違います。
- 例外ケースを誰も決めていなかった：新しいデータでは直ったけれど、過去のデータ、0件のとき、権限の違うユーザーのときはどうするのか。決めていないので、依頼者は「当然含まれる」、こちらは「対象外」と、自然に別の前提を置いてしまいます。
- 「完了」のタイミングが違った：こちらは本番に反映した時点で完了、依頼者は自分で触って確かめた時点で完了。この差があると、「もう終わったはずの案件」が数日後に戻ってきます。
どれも、誰かがサボったから起きるわけではありません。完了の定義は、言葉にしないと自然にずれるものです。だから、ずれを前提に「合わせる手順」を一つ持っておく。それが手戻りを減らすいちばん確実な方法です。
完了の定義を合わせる4つの確認
① 完了条件を「確かめられる1文」で書く
まず、依頼内容を依頼者が自分で確かめられる形の1文にします。型はこれだけです。
「（誰が）（どの画面で）（何をしたら）（何が見えれば）OK」
- 悪い例：「CSV出力の不具合を修正する」
- 良い例：「経理担当が、売上一覧画面で期間を指定して『CSV出力』を押したら、指定した期間の売上がすべて、Excelで開いても文字化けせずに出ればOK」
「修正する」「改善する」「対応する」で終わる文は、どこまでやれば終わりなのかが読み取れません。最後が「〜が見えればOK」「〜ができればOK」で終わる文にすると、自然と確かめ方まで決まります。条件が2つ3つに分かれるなら、箇条書きで並べて構いません。
② 「やらないこと」と例外ケースの扱いを決める
次に、完了条件の外側を決めます。手戻りの多くは、ここから来ます。
- 過去データ：すでに登録済みのデータにも効くのか、これから登録する分だけか。
- 境目のケース：0件のとき、件数がとても多いとき、日付が月をまたぐとき。
- 人の違い：権限が違うユーザー、別の部署、スマホから使う人。
- 今回やらないこと：「ついでに」出てきそうな話を、先に「今回は対象外、必要なら別件で」と書いておく。
全部を対応する必要はありません。大事なのは、「やる」「やらない」「別件で相談」のどれかに決まっていることです。決まってさえいれば、あとから「あれは？」と聞かれても、「そこは今回対象外にしましたよね」と落ち着いて話せます。
③ 「完了」のタイミングを決める
同じ改修でも、どの時点を「完了」と呼ぶかで、案件の閉じ方が変わります。
- 本番反映で完了：小さな表示修正など、こちらで確かめれば十分なもの。
- 依頼者の確認で完了：業務の流れに関わるもの、数字が絡むもの、依頼者しか判断できないもの。
- 一定期間の様子見で完了：月末処理やバッチなど、実際の運用で1回通して初めて確かめられるもの。
迷ったら、「依頼者が確認して『OK』と言ったら完了」にしておくのがおすすめです。そのうえで、「確認はいつまでに、誰がしてくれるか」も一緒に決めておくと、案件が宙ぶらりんのまま残りません。
④ 依頼者に書き戻して「これで合っていますか」と聞く
①〜③をまとめたら、依頼者に短い文章で書き戻します。チャットやチケットのコメントで十分です。
「今回の改修、こうなったら完了と考えています。ずれていたら教えてください。
・完了条件：経理担当が売上一覧で期間指定してCSV出力したら、指定期間の売上がすべて、Excelで文字化けせず出る
・対象外：過去に出力済みのCSVファイルの修正（必要なら別件で）
・完了の時点：本番反映後、○○さんに実際の月で1回出力して確認してもらい、OKをもらった時点」
ここで「あ、先月分も出てほしいです」と返ってきたら、それは手戻りが着手前に見つかったということです。コードを書く前の数分で見つかれば、直す手間はほとんどありません。
具体例：「検索結果が多すぎるので絞れるようにして」
社内の顧客管理システムに、こんな依頼が来たとします。
- 1文で書く：「営業担当が、顧客一覧画面で担当者名を選んで『検索』を押したら、その担当者の顧客だけが一覧に出ればOK」。
- やらないこと・例外：担当者が未設定の顧客は「担当者なし」として選べるようにする（やる）。複数担当者での絞り込みは今回対象外（別件で相談）。退職者の名前は選択肢に出さない（やる）。
- 完了の時点：本番反映後、営業の○○さんに自分の担当顧客で試してもらい、OKをもらった時点。確認は反映の翌営業日中にお願いする。
- 書き戻す：この3点をチャットで送ったら、「退職者の顧客は、引き継ぎ先の人で出てほしいです」と返事が来た。
4の返事は、もし書き戻していなければ、リリース後に「退職した人の顧客が見つからない」という問い合わせとして戻ってきていたはずの話です。書き戻した時点で見つかったので、設計の段階で織り込めました。
影響：完了の定義を合わせると、何が変わるか
完了の定義を着手前に合わせておくと、作業の質だけでなく、気持ちの面でもずいぶん楽になります。
- 手戻りが着手前に見つかる：ずれが「書き戻し」の段階で出てくるので、作り直しではなく、作る前の調整で済みます。
- テストの範囲が自然に決まる：完了条件と例外ケースが、そのまま確認項目になります。何を確かめればいいかで迷いません。
- 「終わった案件」が戻ってこない：完了の時点と確認者が決まっているので、案件をきちんと閉じられます。
- 断るときも角が立ちにくい：「やらないこと」を先に合意しているので、追加の要望を「別件で相談しましょう」と自然に切り分けられます。
一人で保守をしていると、依頼者との認識合わせまで全部自分の仕事になります。だからこそ、毎回ゼロから考えず、決まった型で数分だけ確認する。その数分が、あとの数時間を守ってくれます。
明日やること：次の改修依頼で「完了条件メモ」を1枚書く
いきなり全部の案件でやる必要はありません。次に来る改修依頼1件だけで十分です。
- 依頼を受けたら、着手する前に完了条件を「（誰が）（どの画面で）（何をしたら）（何が見えれば）OK」の1文で書いてみる。
- その下に、「対象外」を1行だけ書く（思いつかなければ、過去データと例外ケースを一度だけ考える）。
- 完了の時点と確認者を1行で書く。
- その3行を依頼者に送って、「これで合っていますか」と一言添える。
返事が「それで大丈夫です」なら、安心して作り始められます。返事でずれが見つかったら、それは大きな手戻りを1つ防げたということです。どちらに転んでも、損はありません。
「完了の定義」チェックリスト
着手前に、ざっと当ててみてください。全部に○が付かなくても大丈夫です。
- 完了条件が「〜が見えればOK」「〜ができればOK」で終わる1文になっているか
- その1文に「誰が」「どの画面で」「何をしたら」が入っているか
- 過去データ・既存データにも効くのかを決めたか
- 0件・大量・月またぎなど、境目のケースを一度考えたか
- 権限や部署など、使う人の違いを一度考えたか
- 「今回やらないこと」を1つ以上書いたか
- 完了の時点（本番反映／依頼者確認／様子見）を決めたか
- 確認する人と、確認の期限を決めたか
- 完了条件を依頼者に書き戻し、返事をもらったか
まずは「1文で書く」と「書き戻す」の2つだけでも、手戻りはぐっと減ります。残りは、次の改修のときに1つずつ足していけば十分です。
よければ、こちらも
完了の定義は、依頼のヒアリングと、改修後の確認のちょうど間にある工程です。前後の記事とあわせて使うと、改修がひと続きで落ち着いて進みます。
- あいまいな改修依頼を要件に落とすヒアリングの型｜5つの質問：「何を・なぜ・どこまで」を聞き出す段階。今日の完了条件メモの材料になります。
- 「これはバグか仕様か」の決め方｜判断が割れたときの合意の取り方：完了の定義がずれたまま揉めてしまったときの、合意の取り直し方です。
- 改修後のデグレを防ぐ｜回帰確認する範囲の決め方：完了条件の「外側」で壊れていないかを確かめる範囲の決め方です。
- 直したつもりが直っていない｜改修の効果を確かめる4つの手順：反映後に、本当に直ったかを確かめる手順です。
「直したのに終わらない」改修は、本当に疲れます。でも、それはあなたの腕のせいではなく、完了の絵を一緒に描く時間がなかっただけです。 今日は次の依頼で、完了条件を1文書いて、依頼者に「これで合っていますか」と送ってみてください。その3行が、依頼者とあなたを同じゴールに立たせてくれます。
ほかの実務ヒントは記事一覧からどうぞ。保守運用の小さな備えを、メールでも少しずつお届けしています。