diffとは、変更前後の差分を見ること
diffを見ると、Codexがどのファイルのどの部分を変えたかを確認できます。本文、sitemap、news、canonical、robotsのような変更も、merge前に気づきやすくなります。
rollbackとは、問題があった時に戻す考え方
rollbackは、問題が起きた変更を戻すための考え方です。GitHubがあれば変更単位で履歴を追えますが、DBやサーバー全体を戻す保険とは別に考えます。
| 項目 | 役割 | 得意なこと | 戻せるもの | 注意点 |
|---|---|---|---|---|
| GitHub | 変更履歴つきコード図書館 | diff、PR確認、rollback、誰が何を変えたかの確認 | HTML、CSS、JS、画像、docsなどの変更単位 | サーバーバックアップの完全代替ではない |
| サーバーバックアップ | 本番全体を戻す保険 | サーバー側の状態を時点で戻す | 公開環境全体 | なぜ壊れたか、どの差分かは見えにくい |
| Codex報告書 | 作業内容の記録 | 何を確認し、何を直したかを残す | 判断や確認の文脈 | ファイルそのものを戻す仕組みではない |
| 正本 | 今後も使う判断基準 | 採用した構成や運用ルールを残す | 考え方、ルール、テンプレート | 実ファイルの履歴とは別に管理する |
| Search Console | 公開後の反応を見る計器 | 検索語、表示、クリック、順位を見る | 戻すものではなく観測するもの | 即時の品質保証ではない |
GitHubに入れてよいもの・入れてはいけないもの
| 種類 | GitHubに入れてよいか | 理由 | 注意 |
|---|---|---|---|
| HTML / CSS / JS | 公開前提なら候補 | 変更履歴を残しやすい | 秘密情報を含めない |
| 画像 / sitemap.xml / robots.txt / ads.txt | 公開用なら候補 | 公開サイトの構成として管理できる | 権利や設定の意味を確認する |
| README / docs / 公開用work-log / news | 候補 | 作業ルールや公開情報を残せる | 内部情報を書きすぎない |
| .env / APIキー / token / password | 入れない | 認証情報や秘密情報だから | 実値をREADMEやHTMLにも書かない |
| DB情報 / SQL dump / FTP・SFTP情報 / SSH鍵 | 入れない | 漏れると本番やデータに影響する | private repoでも直書きしない |
| GitHub Secrets実値 / 個人情報 / 顧客情報 / log / backup丸ごと | 入れない | 不要な共有や漏えいにつながる | AIやCodexに貼る時も伏せる |
Codex作業での注意
- PR前にdiffを見る
- main直pushを避ける
- Secretsや.envを入れない
- 本番deployは別管理にする