STERFIELD
ビジネス2026.11.20

マニュアル更新が週5〜6時間→最大1時間に!GitHubで管理したファイルをWeb上で公開する仕組みを作ってみた

今回は、弊社の越境ECマネジメントシステム「Bynd」の公式サイト(bynd.ne.jp)で使っている、GitHubで管理したファイルをそのままWeb上で公開する仕組みの紹介です!

この仕組みにしたことで、週に5〜6時間かかっていたマニュアルの更新が、30分〜1時間ほどで終わるようになりました!

こんな人向け

  • 「文言を1行直したいだけなのに、エンジニアに頼まないといけない…」と思っている方
  • サイトの変更を、いつ・誰が・何を変えたか残しておきたい方
  • 本番に出す前に、ちゃんと確認できる場所が欲しい方
  • GitHub Actions や Clud を使った自動デプロイに興味がある方

Byndのサイトについて

Byndのサイトは、サービス紹介・料金・導入事例などのページと、19本のマニュアル記事があるヘルプセンターでできていて、全部で30ページほどです。料金改定やキャンペーン文言の差し替えなど、細かい更新がけっこう頻繁に発生します。 スクリーンショット 2026-11-20 17.42.37.png

そこで、GitHubを中心にした今の運用を作りました。

全体の流れ

サイトの「原本」は Claude Design 上のプロジェクトです。Claude Design は画面上のテキストをクリックしてそのまま書き換えられるので、経営陣もエンジニアも同じ画面でサクッと直せます。直した内容は Claude Code が GitHub に取り込んでくれて、そこから先は自動です。 Gemini_Generated_Image_ve6qpyve6qpyve6q.jpeg

人が手を動かすのは「1. 編集」「3. レビュー」「6. 本番の承認」の3か所だけで、あとは Claude Code と GitHub Actions にお任せです!

ポイント① 編集するファイルと公開するファイルを分ける

リポジトリの中身は、人が編集する「ソース」と、ビルドで自動生成される「公開用HTML」にはっきり分けています。

場所中身人が編集するか
*.dc.html各ページのソース。共通ヘッダー・フッターもここする(Claude Design 上で)
content/*.mdマニュアル記事19本の原稿(Markdown)する
assets/ロゴやスクリーンショットなどの画像する
tools/ビルドスクリプトと設定(記事一覧など)エンジニアのみ
dist/実際に公開されるビルド済みHTMLしない(自動生成)

node tools/run-build.js を1回実行するだけで、マニュアルの原稿から記事ページを作り、全ページを dist/ に書き出してくれます。

さらにビルドのときに、毎回手で入れると忘れがちなものも自動で差し込んでいます。

  • 検索エンジン向けの構造化データ(会社情報、料金、よくある質問、パンくずリスト)
  • Google アナリティクスのタグと、「無料相談」「資料請求」ボタンのクリック計測
  • 共通ヘッダー・フッター

たとえば「よくある質問」に質問を1つ足すと、検索エンジン向けのFAQデータも勝手に更新されるので、ページを書く人は本文だけに集中できます。

マニュアルの原稿はMarkdownで管理しているので、記事ごとの差分がGitHub上で一目で分かります。これはすごく便利です!

ポイント② マージすれば公開、食い違いがあれば止める

公開先は2つで、どちらもGitHubのブランチにマージするだけで自動で反映されます。

環境URL反映のきっかけ
ステージング非公開(社内のみ閲覧可)development ブランチへのマージ
本番bynd.ne.jpmain ブランチへのマージ

ホスティングにはCloudflare Workersを使い、dist/ フォルダをそのまま配信しています。デプロイはGitHub Actionsがやってくれるので、作業する人のパソコンに特別なツールや権限はいりません。

デプロイ前の「整合チェック」

地味に効いているのがここです。GitHub Actionsはデプロイの直前にもう一度ビルドして、その結果がコミット済みの dist/ と完全に一致するかを確かめます。一致しなければ、そこでデプロイを止めます。

これで、こんなミスを防げます。

  • 公開用の dist/ を直接書き換えてしまった(次のビルドで消える)
  • ソースを直したのにビルドを忘れた(直したはずの内容が公開されない)
  • 自動生成されるマニュアル記事ページを手で直してしまった

mainへのマージ=本番反映の承認

main へのマージには「本番に出してOK」という承認の意味を持たせています。ステージングで表示を確認してから、人が意図してマージします。

⚠️AIに作業を任せる場合も、本番反映の前には必ず「今、本番に出してよいか」を単独で確認させるルールにしています。

効果:マニュアル更新が週5〜6時間 → 30分〜1時間に!

いちばん効果が大きかったのは、ヘルプセンターのマニュアル更新です。これまで週に5〜6時間かかっていた作業が、今では30分〜1時間ほどで終わるようになりました!!

毎週の更新作業で人がやることは、なんとこれだけです。

  1. Claude Codeに「この1週間のPRをマニュアルに反映して」と依頼する
  2. ステージングに上がってきた内容をチェックして、必要なところを修正する
  3. 公開を承認して、本番への反映を依頼する

原稿の書き換え、記事ページや検索向けデータの生成、プルリクエストの作成、ステージングへの反映は、ぜんぶClaude CodeとGitHub Actionsがやってくれます。人は「頼む」「確かめる」「OKを出す」に集中するだけなので、作業時間が一気に縮まりました!

やってよかったこと:ページが増えても更新漏れがない

個人的に一番やってよかったと思うのがここです。

マニュアルは機能が増えるたびにページ数も増えていきます。ページが多くなるほど、「1つの仕様変更がどのページに関係するのか」を人が全部把握するのは大変ですよね…。

今は、AIが全ページをチェックして、対象になるページすべてに情報を反映してくれます。人は上がってきた差分を確認するだけでOKなので、ページが増えても安心して運用できています◎

まとめ

この仕組みにしてから、週に5〜6時間かかっていたマニュアルの更新が、30分〜1時間ほどで終わるようになりました。さらに、サイト更新の「直す人」と「確かめて出す人」の役割もはっきりしました。

  • 誰でも直せる:文言の修正はClaude Designの画面上で完結し、エンジニアを待たなくてOK
  • 更新漏れがない:AIが全ページをチェックして、対象のページすべてに反映してくれる
  • 全部残る:すべての変更がプルリクエストとしてGitHubに残り、変更前後を比べられる
  • 安心して出せる:ステージングでの確認と自動の整合チェックを通らないと本番に出ない

GitHubでファイルを管理してWebで公開する、という構成自体はそこまで珍しいものではありません。ですが、「非エンジニアが編集する入り口」と「人が承認する出口」を分けて、その間を自動化するだけで、運用がぐっとラクになりました!

個人的には、小さなコーポレートサイトやヘルプセンターを持っている会社なら、ぜひ試してほしい運用だと思いました。参考にしてみてください!

Byndの機能や導入については、bynd.ne.jp をご覧ください。

WRITER

M.Niwaya

なんとなく入った学校で、ITの知識を叩き込まれる。 エンジニアをしたり、カスタマーサクセスをしたり、マーケを楽しんだり。美味しいものと洋服を愛してます。最近はバイクも◎

この著者の記事を見る

CONTACT

記事の内容について
相談したい方へ

実際の進め方は、状況を伺ってからご提案します。

2営業日以内にご返信します
資料ダウンロード無料相談に申し込む