local repositoryとは

local repositoryは、自分のPC上にあるGit管理された作業フォルダです。保存しただけではGitHub側へ反映されず、commitやpush、pullの流れを分けて考える必要があります。

このページでわかること

  • PC上の作業場所とGitHub上のremoteを分けて理解する
  • commitは履歴、pushはGitHubへの反映として見る
  • pullは他の変更を取り込む操作として扱う

まず確認すること

  • 作業フォルダが正しいrepoか見る
  • 未追跡ファイルに.envや不要データがないか見る
  • branchとremoteの向き先を確認する

やってはいけないこと

  • ローカル保存だけで共有済みと考える
  • 不要な生成物や認証情報をまとめてstageする
  • 複数repoの作業フォルダを混同する

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さな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日

関連ページ