1ポイント
コード図書館として使う
GitHubはコードを置くだけでなく、いつ何を変えたかを追う場所です。
まなぶちゃんファイル置き場として使えばいい？
GPTガイドくん置くだけでなく、差分と履歴を確認できるのがGitHubの強みです。
Code library
GitHubをコードの図書館として使う方法
GitHubをまずはコード置き場、あとから見返せる図書館として使う考え方を整理します。
このページは非公式の実践ガイドです。GitHubの画面や機能、仕様は変わる可能性があります。最新情報が必要な場合は、提供元が公開している情報も確認してください。コードやファイルの変更後は人間が確認してください。
このページで分かること
サイトやアプリのコードをまとめて保管し、どのファイルがどこにあるか分かるようにします。
READMEやフォルダ構成で、将来の自分やAIツールが読みやすい状態にします。
Codexに見せる対象をリポジトリとして整理し、作業範囲を明確にします。
GitHubをコードの図書館として使うとは
コードの図書館とは、サイトやアプリのファイルをまとめて置き、後から探しやすくする使い方です。最初から高度なチーム開発を目指さなくても、個人サイトのHTMLやCSSを整理して保管するだけで価値があります。
図書館として使う時は、置くもの、置かないもの、説明の残し方を決めることが大切です。コードを保存するだけでなく、READMEで目的や使い方を書いておくと、後から見返した時に迷いにくくなります。
コード図書館に入れるもの
| 入れるもの | 理由 |
|---|---|
| index.html | トップページの内容を管理できる |
| about/index.html | 下層ページも同じ場所で見返せる |
| assets/css/style.css | 見た目のルールをまとめて確認できる |
| robots.txt | 検索エンジン向けの基本設定を確認できる |
| sitemap.xml | 公開ページの一覧を確認できる |
| README.md | サイトの目的や作業ルールを残せる |
コード図書館に入れないもの
注意 GitHubは便利な保管場所ですが、外へ出せない情報の置き場ではありません。接続情報、ログイン情報、DB dump、ログファイル、個人情報、業務上の非公開情報は置かないでください。
Codexに見せる作業対象として使う
リポジトリが整理されていると、Codexに「どのファイルを見ればよいか」「どこを触ってよいか」を伝えやすくなります。ただし、Codexに見せる前に、外へ出せない情報が混ざっていないか人間が確認してください。
悪い例 / 良い例
| 悪い例 | 良い例 |
|---|---|
| ファイルを全部同じ場所に置く | HTML、CSS、画像、READMEを分けて置く |
| 説明なしでコードだけ置く | READMEに目的と更新ルールを書く |
| 外へ出せない情報も一緒に置く | 公開してよいファイルだけ置く |
| どれが最新か分からない | リポジトリを1つの正本として扱う |
コード図書館としての使い方チェックリスト
- サイトの目的を書いた
- READMEを書いた
- HTMLとCSSの場所が分かる
- 外へ出せない情報を置いていない
- Codexに見せる前に人間が確認した
- フォルダ名が分かりやすい
- 古いファイルを放置しすぎていない
やってはいけないこと
- mainへ大きな変更を直接入れる
- 外へ出せない情報を通常ファイルへ置く
- AIレビューだけで完了扱いにする
- 複数サイトやリポジトリを同じ前提で混ぜる
- 差分や報告書を読まずに次へ進む
関連ページ
GitHubをCodexで使える作業場所に育てる
GitHubを接続しただけで終わらせず、リポジトリ整理、ブランチ、Pull Request、AGENTS.md、Actionsを段階的に整える考え方を確認できます。
このカテゴリの親ページへ戻る
同じカテゴリのページを続けて読む場合は、親ページの一覧から選ぶと迷いにくくなります。
近いテーマの読み分け
GitHubはコード履歴と差分確認の置き場です。秘密情報を避け、Codex作業場所として整えます。