local repositoryとは
local repositoryは、自分のPC上にあるGit管理された作業フォルダです。保存しただけではGitHub側へ反映されず、commitやpush、pullの流れを分けて考える必要があります。
このページでわかること
- PC上の作業場所とGitHub上のremoteを分けて理解する
- commitは履歴、pushはGitHubへの反映として見る
- pullは他の変更を取り込む操作として扱う
まず確認すること
- 作業フォルダが正しいrepoか見る
- 未追跡ファイルに.envや不要データがないか見る
- branchとremoteの向き先を確認する
やってはいけないこと
- ローカル保存だけで共有済みと考える
- 不要な生成物や認証情報をまとめてstageする
- 複数repoの作業フォルダを混同する
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さなbranchとPRに分け、CIとreviewで確認する。
CodexやAI作業時の注意
AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。
公式情報で確認する領域
Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。
.gitフォルダの中身(git公式)
local repositoryの実体は、作業フォルダの直下にある .git フォルダです。gitの公式文書は、主なものを次のように説明しています。
HEAD: いま作業中のbranchを指す参照です。commit IDを直接持つ「detached HEAD」の状態もあります。有効なリポジトリにはこのファイルが必須です。config: そのリポジトリだけの設定ファイルです。objects: commitやファイルの中身を保存する場所です。1つずつのファイルは、オブジェクト名の最初の2文字で256個のサブフォルダに分けて置かれ、まとめたものはobjects/packに入ります。refs: branchの先頭(refs/heads/名前)やタグ(refs/tags/名前)の参照を置く場所です。index: ステージングエリアにあたるファイルです。hooks: gitの各コマンドが実行するスクリプトの置き場です。git initで見本が入りますが、すべて無効です。有効にするには、ファイル名から.sampleを外します。info/exclude: そのリポジトリ全体に効く除外パターンの置き場です(慣例上)。フォルダごとの.gitignoreとは別の場所です。
AIに作業を任せる時、.git の中は手で編集させないのが基本です。hooksはcommit前などに自動で動かせる仕組みなので、見知らぬスクリプトが入っていないかは、clone直後に確かめる価値があります。
出典: gitrepository-layout/確認日 2026年11月2日
git statusの3つの区分と短い表示
gitの公式文書によると、git status は次の3つのグループを表示します。
- ステージ済み(次のcommitに入る): indexと最新のHEADの差分があるパス。
- 未ステージ(変更したがまだ
git addしていない): 作業ツリーとindexの差分があるパス。 - 未追跡: gitが管理しておらず、gitignoreでも除外されていないパス。
.envのようなファイルが並んでいたら、git addの前に止まって確認する場面です。
git status -s の短い表示は、1行が「2文字の記号 + パス」です。1文字目がステージ済み、2文字目が未ステージの状態を表し、空白は変更なしです。M は変更、A は追加、D は削除、R は名前変更、?? は未追跡、!! は無視(--ignored を付けた時だけ)を示します。たとえば「M 」はステージ済みの変更、「 M」は未ステージの変更、MM は両方です。merge中の衝突は UU(両方が変更)などの記号で出ます。
出典: git-status/確認日 2026年11月2日