【Claude Code 失敗談 #16】リリースノートを非エンジニアがClaude Codeと一緒に書く

社員ブログ

※Claude Codeを使用して記事を作成しています。

前回の記事では、障害発生時に非エンジニアが状況を整理する方法を紹介しました。

第4部「実務シーン編」の4回目は、

リリースノート

です。

  • エンジニアから届いた変更内容が、専門用語だらけで使えない
  • 何を書けばユーザーに伝わるのか、判断がつかない
  • 毎回ゼロから文章を考えるのに、時間がかかっている

リリースノートは、開発の成果をユーザーに届ける大切な文章です。

しかし、開発側の言葉とユーザーの言葉には距離があります。

Claude Codeを使って、その距離を埋めながらリリースノートを書く方法を紹介します。

リリースノートは誰のためのものか

最初に、読み手を整理します。

リリースノートの読み手は、主に次のような人たちです。

  • 一般のユーザー
    アプリやサービスで、何が変わったのかを知りたい
  • 社内の関係者
    営業やサポートが、お客様に説明するために把握したい
  • 導入企業の担当者
    業務への影響があるかどうかを確認したい

読み手によって、知りたい情報の粒度も、使える言葉も異なります。

「誰が読むのか」を先に決めること

が、リリースノート作成の出発点です。

開発側の言葉とユーザーの言葉の違い

エンジニアが書く変更内容は、開発者にとっては正確でも、ユーザーには意味が伝わらないことがあります。

【エンジニアが書く変更内容の例(仮)】
- 一覧取得APIのレスポンスをキャッシュ化
- 画像のlazy loadingを導入
- ログイン時のトークン更新処理を修正
- 検索クエリのインデックスを追加

これらは、ユーザーにとって何が嬉しいのかが見えません。

ユーザーに伝えるには、

「それによって、ユーザーの体験がどう変わるか」

に変換する必要があります。

この変換こそ、Claude Codeが得意とする作業です。

実例:変更内容をユーザー向けの言葉にする

ここでは、上記の変更内容を持つ、あるアプリのバージョンアップを例にします。
内容は説明のための仮の例です。

ステップ1:変更内容の意味を理解する

まず、自分自身が変更内容を理解するところから始めます。

【質問例】
エンジニアから、以下の変更内容が届きました。
それぞれ、ユーザーにとってどんな変化がありそうか、
非エンジニア向けに説明してください。
断定できない部分は、「エンジニアに確認が必要」と書いてください。

(変更内容を貼り付ける)

「断定できない部分は確認が必要と書いてください」と伝えることがポイントです。

Claude Codeは、実際のアプリの動作を見ることができません。
指定しないと、一般的な効果を、事実のように書いてしまうことがあります。

Claude Codeが、以下のように説明してくれます。

【回答例】

■ 一覧取得APIのレスポンスをキャッシュ化
一般的には、一度取得したデータを一時的に保存しておくことで、
一覧画面の表示が速くなる変更です。
ただし、どの画面でどの程度速くなるかは、エンジニアに確認が必要です。

■ 画像のlazy loadingを導入
一般的には、画面に表示される画像から順に読み込むことで、
画面の表示開始が早くなる変更です。
対象の画面は、エンジニアに確認が必要です。

■ ログイン時のトークン更新処理を修正
ログイン状態の管理に関する修正です。
ユーザーにとってどんな不具合が直ったのかは、エンジニアに確認が必要です。

■ 検索クエリのインデックスを追加
一般的には、検索結果が表示されるまでの時間が短くなる変更です。
効果の程度は、エンジニアに確認が必要です。

「確認が必要」と書かれた項目が、エンジニアへの質問リストになります。

ステップ2:エンジニアへの確認事項を作る

確認が必要な点を、質問の形に整えてもらいます。

【質問例】
「エンジニアに確認が必要」とされた項目について、
リリースノートを書くために確認したい質問を作成してください。
非エンジニアにも答えやすい聞き方にしてください。

Claude Codeが、以下のように質問を整理してくれます。

【確認事項の例】

- 画像の読み込みの変更は、どの画面が対象でしょうか?
  ユーザーが体感できる変化はありますか?

- ログイン関連の修正は、ユーザーにとってどんな不具合の解消でしょうか?
  (例:突然ログアウトされる、など)

- 検索の変更で、検索結果が表示されるまでの時間は
  おおよそどの程度変わりますか?
  数値が出せない場合は、「速くなった」と書いてよいかを教えてください。

「書いてよいか」を確認する聞き方にすると、エンジニアも答えやすくなります。

ステップ3:ユーザー向けの文章に変換する

エンジニアから回答が得られたら、ユーザー向けの文章にまとめてもらいます。

【質問例】
以下の確認結果をもとに、
一般のユーザー向けのリリースノートを作成してください。
専門用語は使わず、「ユーザーにとってどう変わるか」を中心に書いてください。
確認結果に書かれていない効果は、書かないでください。

【確認結果】
- 商品一覧の表示が、以前より速くなった
- 画像が多い画面で、表示の開始が早くなった
- ログイン後、しばらくすると
  突然ログアウトされることがある不具合を修正した
- 検索結果の表示が、以前より速くなった

「確認結果に書かれていない効果は、書かないでください」と伝えることも重要です。

Claude Codeが、以下のように作成してくれます。

【リリースノートの例】

バージョン〇.〇.〇

■ 快適さが向上しました
- 商品一覧の表示が速くなりました
- 画像の多い画面でも、表示が始まるまでの時間が短くなりました
- 検索結果が、これまでより速く表示されるようになりました

■ 不具合を修正しました
- ログイン後しばらくすると、
  突然ログアウトされることがある不具合を修正しました

今後も、より使いやすいアプリを目指して改善を続けてまいります。

エンジニアが書いた4行の変更内容が、ユーザーに伝わる文章になりました。

ステップ4:読み手別に書き分ける

同じ変更内容でも、読み手によって伝え方を変えられます。

【質問例】
上記のリリースノートをもとに、社内のサポートチーム向けの共有文を作成してください。
お客様から問い合わせがあった場合に、どう説明すればよいかがわかる内容にしてください。

Claude Codeが、以下のように提案してくれます。

【サポート向け共有文の例】

今回のバージョンアップの主な変更点です。

【お客様に案内できること】
- 一覧画面や検索結果の表示が速くなりました
- ログイン後に突然ログアウトされる不具合を修正しました

【問い合わせが想定されること】
- 「ログアウトされる不具合は、本当に直ったのか」
  → 今回のバージョンで修正済みです。
    解消しない場合は、状況をお聞きし、開発担当へ連絡してください

【お客様に伝えるときの注意】
- 速度の改善について、具体的な秒数などの数字は案内しないでください
  (確認が取れていないため)

同じ内容でも、サポートチームには「お客様に何と言えばよいか」まで添えると、実際の対応に使いやすくなります。

ステップ5:公開前のチェックをしてもらう

公開前に、読み手の目線でチェックしてもらいます。

【質問例】
以下のリリースノートを、一般のユーザーの立場で読んでください。
わかりにくい表現、誤解を招きそうな表現、言い切りすぎている表現があれば
指摘してください。

(作成したリリースノートを貼り付ける)

Claude Codeが、以下のような指摘を返してくれます。

【指摘例】

- 「速くなりました」は、すべての環境で体感できるとは限りません。
  「より速く表示されるようになりました」など、やわらかい表現も検討できます
- 「不具合を修正しました」とだけ書くと、どんな不具合かが伝わりにくいため、
  現在の表記は適切です
- 「今後も改善を続けてまいります」は定型的ですが、問題はありません

自分では気づきにくい言い切りすぎを、公開前に確認できます。

公開前に必ず確認したいこと

Claude Codeがチェックしてくれても、最終的な確認は人が行います。

【公開前の確認ポイント】
- 書かれている内容が、実際の変更と合っているか
- エンジニアが内容を確認したか
- 社内の責任者や広報の確認を経ているか
- 実現していない機能を、書いていないか
- 今後の予定を、約束のように書いていないか

特に、

実際には行っていない改善を書いてしまう

ことは、ユーザーの信頼を損なう大きなリスクです。

エンジニアの確認を必ず挟んでください。

リリースノートでやってはいけないこと

AIが補った効果を、そのまま書く

Claude Codeは、一般的な効果を補って書くことがあります。

例えば「表示が2倍速くなりました」のような数値は、確認が取れていなければ書くべきではありません。

元の変更内容と照らし合わせて、

これはエンジニアが確認した内容か、AIが補った表現か

を確認してください。

技術的な内容をそのまま載せる

「APIのキャッシュ化」のような表現は、ユーザーにとっては意味がわかりません。

何が変わるのかを、ユーザーの言葉で書くことが基本です。

未公開の情報を入力する

リリース前の情報は、社外に出せない内容を含むことがあります。

入力する前に、

  • 未公開の機能名や取引先名は置き換える
  • 社内のAI利用ルールに従う

ことを確認してください。

リリースノート作成のテンプレート

【リリースノート作成テンプレート】

1. エンジニアから届いた以下の変更内容について、
   ユーザーにとってどんな変化がありそうか、非エンジニア向けに説明してください。
   断定できない部分は「エンジニアに確認が必要」と書いてください。
   (変更内容を貼り付ける)

2. 「エンジニアに確認が必要」とされた項目について、
   リリースノートを書くために確認したい質問を作成してください。

3. 以下の確認結果をもとに、一般のユーザー向けのリリースノートを作成してください。
   専門用語は使わず、「ユーザーにとってどう変わるか」を中心に書いてください。
   確認結果に書かれていない効果は、書かないでください。
   (確認結果を貼り付ける)

4. 上記のリリースノートをもとに、社内のサポートチーム向けの共有文を作成してください。

5. 以下のリリースノートを、一般のユーザーの立場で読んで、
   わかりにくい表現や言い切りすぎている表現を指摘してください。
   (リリースノートを貼り付ける)

まとめ

リリースノートを非エンジニアがClaude Codeと一緒に書く方法をまとめます。

  • 最初に「誰が読むのか」を決める
  • 変更内容の意味を理解し、不明な点はエンジニアへの質問に変える
  • 「ユーザーにとってどう変わるか」を中心に書く
  • 確認結果に書かれていない効果は書かない
  • 読み手別に、伝え方を書き分ける
  • 公開前に、エンジニアと責任者の確認を必ず挟む

リリースノートは、

開発の成果を、ユーザーに届けるための窓口

です。

エンジニアの仕事をユーザーに正しく伝えることは、非エンジニアだからこそ担える役割です。

Claude Codeを、開発側とユーザー側をつなぐ翻訳の補助として活用してみてください。

次回予告

次回から第5部「組織・マネジメント編」に入ります。

「マネージャーがチームの技術的負債を理解するために使う」

をテーマに、

  • 技術的負債とは何か
  • マネージャーが押さえておきたい基本的な考え方
  • エンジニアとの対話で確認すべきポイント

を紹介します。

タイトルとURLをコピーしました