このブログは、自社のCMS「writeWired」のサイトを、AIと一緒に作り直してきた記録です。この記事の作業は、2026年9月30日から10月3日にかけて、ChatGPTとClaudeの二つのAIと進めました。
やりたかったこと:機能ページで、誰の仕事が楽になるかを伝えたい
何ができるかは、全部そろっていた
writeWiredのサイトは、管理画面の機能を1画面1ページで説明したページを土台にしています。社内では機能リファレンスと呼んでいます。たとえば「組み込みコンテンツ」の機能リファレンスは、一つのコンテンツを、複数のページに部品として表示する機能だ、と説明しています。
この機能リファレンスを関連するもの同士でまとめ、CMS、フォーム、会員管理など、領域別の機能ページを10本作っていました。
この時点で、「何ができるか」は全部そろっていました。ところが、領域別の機能ページを読み返すと、その機能を誰が何のために使うのかが、ほとんど書かれていません。並んでいるのは機能の説明で、日々サイトを更新する担当者の仕事が出てこないのです。
事実は正しい。でも、読む人がそこに自分の仕事を見つけられない。機能の事実だけで全部を伝えられると思っていたのに、話に人がいませんでした。
やりたかったこと
機能の事実は変えずに、その事実で「誰のどの仕事が、どう楽になるか」を書いた章を、領域別の機能ページに載せたい。それが今回の目的です。
こうやってみた:CMSでは、旧サイトの営業の文章から拾った
旧サイトの機能ページを回収した
手がかりは、作り直す前の、旧サイトの機能ページにありました。そこには「この仕組みで、こういう仕事が楽になる」という営業の文章が残っていました。旧サイトの機能ページは、実際に実現したことを書いていたので、根拠のある話として使えます。
そこで、私がまずCMSの領域から、旧サイトの機能ページを丸ごと保存しました。Claudeが本文だけを取り出し、見出しごとに読んで、営業の文章を一文ずつ切り出しました。117文ありました。切り出した文が、原文のどこかにそのまま含まれているかは、機械で照らしています。
切り出した文章を、何を伝えているかで整理し、そこから章の候補を56本挙げました。
候補一つずつに、機能の事実で「言ってよい範囲」を確かめた
次に、章の候補一つずつに、何を根拠にしている話かを付けました。
- 機能リファレンスに書いてある、標準の機能の話
- 機能リファレンスにはないが、案件ごとにテンプレートを作り込んで実現した話
- 機能ではなく、作り方の考え方の話
標準の機能の話は、機能リファレンスの記載と突き合わせました。言い過ぎがあれば直します。たとえば「数千ページ」という言い方は、機能リファレンスに数字の根拠がないので「大量のページ」にしました。逆に、機能リファレンスのほうが旧サイトの機能ページより強く言える点も拾いました。
テンプレートで実現した話は、標準の機能のようには書きません。「テンプレートで〜を構成できます」「個別に開発します」と書き、標準でどこまでできて、どこから開発になるのかが本文で読めるようにしました。
ここで決めた整理は、こうです。
機能リファレンスは、何を言ってよいかを決める。何を言うべきかまでは決めさせない。
機能の事実は、言い過ぎを止める柵です。柵の中で何を伝えるかは、今回は、旧サイトの営業の文章と使う人の仕事を手がかりに決めました。
ChatGPTが書き、Claudeが照らし、私が決めた
章の原稿は、ChatGPTに書かせました。1つの章は、見出し、一言、本文の三つです。
Claudeは、原稿を書き直しません。原稿の言い過ぎを指摘し、足せる事実を、機能リファレンスの原文と一緒に挙げるだけです。
言い過ぎを直すための条件や制約は、原稿に反映しました。たとえばフォームの領域では、原稿に「受け付けたデータを、顧客・会員データへ自動で紐づけられます」とありました。Claudeが照らすと、機能リファレンスでは、自動で紐づくのはログイン中の会員がフォームを送信したときだけです。この条件は、原稿に入れました。
そのうえで、説明を充実させる追加の事実は、全部は足していません。同じフォームの領域で、Claudeは足せる事実を9件挙げました。私はそこから、使う人の仕事が具体的に見えるものを選んで足しました。
その一つが、問い合わせの管理についての章に足した「担当が替わっても経緯を引き継げる」です。機能リファレンスには、対応の記録が画面に残るため、担当が替わっても経緯を引き継げる、と書いてあります。これを足すと、問い合わせに対応する担当者が替わる、という仕事の場面が見えるようになります。
全部足さなかったのは、全部足すと、文章が機能リファレンスの説明に近づいて、使う人の仕事の話から離れていくからです。
できた章の例:同じ機能を、使う人の仕事から書く
今のCMSの機能ページに載っている章を一つ見せます。見出しと一言の言い回しは、この数日後に整えています。
同じ情報を複数のページやメールへ転記している
登録した情報をテンプレートや組込コンテンツで使い分けられます
本文には、こういう場面が書いてあります。
複数の商品ページに同じ送料の案内を載せているとします。従来は各ページを開いて書き換え、修正漏れがないか確認していました。組込コンテンツにすれば、案内は一度作るだけで済み、各商品ページはそれを呼び出す形になります。料金が変わったときは部品だけを修正すると、参照している全ページに反映されます。
「組み込みコンテンツ」の機能リファレンスは、「一つのコンテンツを、複数のページに部品として表示する」と説明しています。章のほうは、同じ機能を、各ページを開いて書き換え、漏れを確認していた担当者の仕事から書いています。機能の事実は一つも増えていません。変わったのは、誰のどの手間が消えるのかを書いたことです。
どうなったか
CMSの5章で形を決め、翌日10領域44章に広げた
9月30日にCMSの領域で5章を作り、CMSの機能ページに載せました。章をページに組み込むための入れ物も、このとき用意しました。
翌日には、残りの9領域にも広げました。2領域目からは、旧サイトの機能ページの回収はせず、ChatGPTの原稿から始めています。ChatGPTが原稿を書き、Claudeが機能の事実と照らし、私が採否を決める分担で進め、10領域、合計44章になりました。
章の要約が、領域別の機能ページの入口になった
44章がそろうと、各領域の章の要約に、その領域で伝えたい仕事がまとまっていました。そこで、要約を領域別の機能ページの冒頭の説明に使いました。差し替えた画面を見て、私は「めっちゃリズムが良くなった」と思いました。冒頭で仕事の話をして、下で機能の事実を見せる順になったからです。
Aboutとトップは、章から引いて作った
製品全体を説明するAboutのページは、44章がそろう前に一度作っていました。ただ、各機能の章がそろうまでは、何をまとめればいいのかがはっきりしていませんでした。章がそろってから作り直すと、各領域で誰のどの仕事が楽になるかを、そこから引いてまとめられました。
トップページも、その上に作り直しました。このとき私は、原稿に一言も手を入れず、指示を出しただけです。それでも組めたのは、トップに載せる話が、下の章にもう全部あったからだと思っています。
この作業の間、土台の機能リファレンスは書き換えていません。
その後
数日後、44章の見出しと一言を見直しました。見出しは、お客さんの困りごとや実現したいこと。一言は、それに対するwriteWiredの答え。上の例は、この形です。本文、機能の事実、構成は変えていません。
このあと、同じ章を、使い道ごとの案内ページにも載せていきました。
今回の作業で分かったこと
機能の説明だけでは、使う人の仕事を伝えきれていなかった
機能の事実は、何ができるかを正確に書いています。でも、今回の領域別の機能ページでは、それで誰の仕事が楽になるかまでは伝わっていませんでした。CMSの領域では、その言葉が、旧サイトの機能ページに載せていた営業の文章の中にありました。そこで、機能の説明だけでなく、使う人の仕事や場面が書かれたその文章を材料にして、ChatGPTに章を書かせました。
事実は「言ってよい範囲」を決める。「何を言うべきか」は別に決める
機能の事実と突き合わせると、言い過ぎは止められます。「数千ページ」を「大量のページ」に戻したように。でも、事実を照らすだけでは、何を推すかは決まりませんでした。事実は柵として使い、柵の中で何を伝えるかは、使う人の仕事から選ぶ。この二つを分けて考えると、言い過ぎず、かつ機能の説明に戻らない文章になりました。
足せる事実を全部足すと、機能の説明に戻る
原稿を事実と照らすと、足せる事実はたくさん見つかります。フォームの領域では9件ありました。言い過ぎを直すための条件は反映したうえで、残りの追加の事実まで全部足せば詳しくはなりますが、文章は機能の一覧に近づき、使う人の仕事が見えなくなります。足すのは、「担当が替わっても経緯を引き継げる」のように、使う人の仕事が具体的に見えるものだけ。今回は、その取捨を私が一つずつ決めました。