今回は、弊社の越境ECマネジメントシステム「Bynd」の公式サイト(bynd.ne.jp)で使っている、GitHubで管理したファイルをそのままWeb上で公開する仕組みの紹介です!
この仕組みにしたことで、週に5〜6時間かかっていたマニュアルの更新が、30分〜1時間ほどで終わるようになりました!
こんな人向け
- 「文言を1行直したいだけなのに、エンジニアに頼まないといけない…」と思っている方
- サイトの変更を、いつ・誰が・何を変えたか残しておきたい方
- 本番に出す前に、ちゃんと確認できる場所が欲しい方
- GitHub Actions や Clud を使った自動デプロイに興味がある方
Byndのサイトについて
Byndのサイトは、サービス紹介・料金・導入事例などのページと、19本のマニュアル記事があるヘルプセンターでできていて、全部で30ページほどです。料金改定やキャンペーン文言の差し替えなど、細かい更新がけっこう頻繁に発生します。

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

人が手を動かすのは「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.jp | main ブランチへのマージ |
ホスティングにはCloudflare Workersを使い、dist/ フォルダをそのまま配信しています。デプロイはGitHub Actionsがやってくれるので、作業する人のパソコンに特別なツールや権限はいりません。
デプロイ前の「整合チェック」
地味に効いているのがここです。GitHub Actionsはデプロイの直前にもう一度ビルドして、その結果がコミット済みの dist/ と完全に一致するかを確かめます。一致しなければ、そこでデプロイを止めます。
これで、こんなミスを防げます。
- 公開用の
dist/を直接書き換えてしまった(次のビルドで消える) - ソースを直したのにビルドを忘れた(直したはずの内容が公開されない)
- 自動生成されるマニュアル記事ページを手で直してしまった
mainへのマージ=本番反映の承認
main へのマージには「本番に出してOK」という承認の意味を持たせています。ステージングで表示を確認してから、人が意図してマージします。
⚠️AIに作業を任せる場合も、本番反映の前には必ず「今、本番に出してよいか」を単独で確認させるルールにしています。
効果:マニュアル更新が週5〜6時間 → 30分〜1時間に!
いちばん効果が大きかったのは、ヘルプセンターのマニュアル更新です。これまで週に5〜6時間かかっていた作業が、今では30分〜1時間ほどで終わるようになりました!!
毎週の更新作業で人がやることは、なんとこれだけです。
- Claude Codeに「この1週間のPRをマニュアルに反映して」と依頼する
- ステージングに上がってきた内容をチェックして、必要なところを修正する
- 公開を承認して、本番への反映を依頼する
原稿の書き換え、記事ページや検索向けデータの生成、プルリクエストの作成、ステージングへの反映は、ぜんぶClaude CodeとGitHub Actionsがやってくれます。人は「頼む」「確かめる」「OKを出す」に集中するだけなので、作業時間が一気に縮まりました!
やってよかったこと:ページが増えても更新漏れがない
個人的に一番やってよかったと思うのがここです。
マニュアルは機能が増えるたびにページ数も増えていきます。ページが多くなるほど、「1つの仕様変更がどのページに関係するのか」を人が全部把握するのは大変ですよね…。
今は、AIが全ページをチェックして、対象になるページすべてに情報を反映してくれます。人は上がってきた差分を確認するだけでOKなので、ページが増えても安心して運用できています◎
まとめ
この仕組みにしてから、週に5〜6時間かかっていたマニュアルの更新が、30分〜1時間ほどで終わるようになりました。さらに、サイト更新の「直す人」と「確かめて出す人」の役割もはっきりしました。
- 誰でも直せる:文言の修正はClaude Designの画面上で完結し、エンジニアを待たなくてOK
- 更新漏れがない:AIが全ページをチェックして、対象のページすべてに反映してくれる
- 全部残る:すべての変更がプルリクエストとしてGitHubに残り、変更前後を比べられる
- 安心して出せる:ステージングでの確認と自動の整合チェックを通らないと本番に出ない
GitHubでファイルを管理してWebで公開する、という構成自体はそこまで珍しいものではありません。ですが、「非エンジニアが編集する入り口」と「人が承認する出口」を分けて、その間を自動化するだけで、運用がぐっとラクになりました!
個人的には、小さなコーポレートサイトやヘルプセンターを持っている会社なら、ぜひ試してほしい運用だと思いました。参考にしてみてください!
Byndの機能や導入については、bynd.ne.jp をご覧ください。




