大規模リポジトリでは「一部だけ見せる」が要る
Augment Codeは、巨大なコードベース全体の文脈を踏まえて変更を提案できるのが強みです。生成されるのは既存プロジェクトに溶け込む形のコードなので、確認したい部分だけをローカルで動かしている状態になりがちです。
プロジェクト全体をデプロイして見せるのは重く、レビュアーにとっても確認対象が広すぎます。新しく作った画面やコンポーネントだけを切り出し、そこにフォーカスして見てもらうほうが効率的です。
対象画面を静的プレビューにする
Augment Codeが生成したUIをStorybookや単体のHTMLとしてレンダリングし、静的な成果物として書き出します。データ依存の部分はサンプルデータに固定しておくと、外部でもそのまま表示できます。
切り出した静的プレビューはサーバー不要で開けるため、関係者は環境構築なしで確認できます。統合前にデザインや挙動の合意を取れるので、後工程の手戻りが減ります。
AI生成HTMLを共有する前の安全チェック
Augment Codeで生成したHTMLを共有では、AIツールの画面上で完成して見えても、共有用HTMLとして安全とは限りません。外部script、form送信先、APIキーらしき文字列、画像パス、ダミーデータではない個人情報を分けて確認します。
ツールの書き出し形式や共有機能は時期・プラン・作り方で変わります。この記事では特定機能の有無を断定せず、静的HTMLやZIPとして取り出せた成果物を安全に見せる前提で進めます。安全チェックが終わったら、HTMLまたはZIPをアップロードし、必要に応じて認証と期限を付けたURLとして共有します。
- 外部送信: form action、fetch、script src、iframeの向き先を確認する
- 秘密情報: APIキー、トークン、社内URL、顧客名が残っていないか検索する
- 表示再現: 画像・CSS・フォントが公開URLでも読み込めるか見る
- 共有設定: 相手、期限、認証方式、差し替え時の連絡方法を決める
一時URLで配布する手順
書き出した静的プレビューは、ドロップで共有URLになるサービスに渡すのが手早い方法です。ギガサイト便での手順を示します。
発行されるURLは 〇〇.giga-site.com 形式のサブドメインで、HTTPSは自動、CDNのエッジ配信で表示が速くなります。大規模リポジトリのCIに手を入れたりステージング環境を用意したりせずに、対象画面だけを切り離してレビューに回せるため、本筋の開発フローを止めずに合意形成を進められます。
- Augment Codeで生成した画面を静的プレビューとして書き出す
- サンプルデータを固定し、アセットごとZIPにまとめる
- ギガサイト便にZIPをドロップして共有URLを取得する
- カスタムスラッグでわかりやすいURL末尾に変更する
- 認証方式と公開期限を設定して関係者に送る
社内資産を含む場合の公開設定
大規模コードベース由来のプレビューには、社内固有の文言やレイアウトが含まれることがあります。検索結果に出ないよう一時公開ページにはnoindexが付きますが、これはアクセス制御ではないため、社外秘の内容は認証で守ります。
会社ドメイン認証を選べば、自社ドメインのメールを持つ人だけが閲覧できます。レビュー期間に合わせて公開期限を設定すれば、期限切れ後は自動的に見られなくなります。
差し替えとログで進行を管理する
統合前のプレビューは何度も微調整するのが普通です。同じURLのまま中身だけ差し替えられるので、レビュアーは同じリンクから常に最新を確認できます。
アクセスログで誰がいつ見たかを確認でき、誰の承認待ちかを把握できます。複数の画面を別々のスラッグで公開すれば、レビュー対象を整理して渡せます。
よくある質問
プロジェクト全体を公開する必要がありますか
全体を公開せず、Augment Codeで生成した画面だけを静的に切り出して共有するのがおすすめです。レビューの焦点が絞れます。
サンプルデータはどう扱えばよいですか
外部公開では実データを避け、サンプルやダミーに固定してから書き出してください。機微な情報を含めないことが重要です。
社外秘の内容を見せる場合の認証は
会社ドメイン認証やメール認証で対象を限定します。noindexはアクセス制御ではないので、限定公開には必ず認証を併用します。
複数の画面をまとめて渡したいときは
1つのZIPに複数ページを含めて公開するか、画面ごとにスラッグを分けて発行する方法があります。用途に応じて使い分けてください。
AIツールで作ったHTMLはそのまま共有しても安全ですか?
そのまま共有せず、外部送信先、フォーム、APIキー、社内URL、画像パスを確認してからURL化します。ツールの共有機能や書き出し仕様は変わるため、最新画面も確認してください。