GitHub Pages で公開物と内部資産を分ける
選択的デプロイ
静的サイトのホスティングでは「リポジトリの中身がそのまま公開される」構成になりがちです。しかし実際のリポジトリには、設計書・作業ログ・画像の没候補・スクリプトなど、公開すべきでない内部資産が大量にあります。弊社サイトのデプロイは「公開物を選んで組み立てる」方式にしています。
公開リストを明示する
デプロイのワークフローでは、公開ディレクトリを新規に作り、公開してよいファイルだけを明示的にコピーします。HTMLの一覧・robots・sitemap・アセット類。そして最後に、アセットの中からも公開すべきでないもの（画像の候補フォルダなど）を除外します。「全部入れてから隠す」のではなく「入れるものを列挙する」ため、新しい内部ファイルを追加しても公開物に混ざる事故が起こりません。
内部資産こそ同じリポジトリに置く
公開物と分離できるようになると、逆説的ですが、内部資産を同じリポジトリに置けるようになります。画像生成の設計書、生成ログ、デザイン検討の記録、エージェント向けの運用ルール。これらをコードと同じ場所でバージョン管理することで、複数の端末・複数のセッションをまたいでも文脈が失われません。公開の境界をデプロイ工程が保証しているからこそ、リポジトリを「会社の作業場」として使い切れます。
キャッシュ運用も規約にする
細かい点ですが、CSSやJSを更新した際のキャッシュバスト（クエリ文字列の版数更新）も規約として固定し、変更のたびに全ページへ一括適用しています。静的サイトはCDNのキャッシュが素直に効くぶん、更新が届かない事故も起きやすい。デプロイの仕組みと配信の仕組みはセットで設計するのが肝要です。
関連記事
サブスクリプションの範囲でAI画像生成を運用するためのコストガード
意図しない従量課金を構造的に防ぐ。プリフライト・APIキー遮断・停止条件・記録様式という4層のガードです。
AIエージェントの成果物を組織標準に揃える、フォーマットキットと文体リンターの設計
エージェントが増えるほど、成果物の体裁と文体は揺れます。会社標準のスライドフォーマットキットの配布と同期、指摘を機械検査に変換した文体リンターまで、どのエージェントが作っても同じ品質に揃える設計を考えます。
AIエージェントの定期業務を止めない、自己延命ジョブと多層フェイルセーフの設計
実行のたびに自分を登録し直す自己延命ジョブ、起動時フックでの自動復旧、許可リストの送信ガード。無人の定期実行を回し続ける設計を解説します。
FDE Consulting生成AIの導入をご検討の方へ
自社の中で回るAIを、貴社の現場でつくる
生成AIの導入から本番運用、定着までを、FDEが現場でご支援します。
初回のご相談は30分のオンラインで、費用はかかりません。