FACTUAL ACTIVITY RECORD · 実際の作業をもとにした活動記録
親workspaceと独立repositoryの境界を定める
clone先、Gitの確認単位、限定したignore ruleをonboarding文書へ揃える
目的
AI組織の設定を置く親workspaceと、実際のproductやbrand presenceを扱う複数のrepositoryを同じdirectory treeで使うために、どこへcloneし、どの単位でGitの状態を確認するかを明確にする必要があった。
親workspaceがchild repositoryのsource codeや履歴まで管理しているように見えると、親rootのgit statusやgit diffだけで変更を確認できるという誤解につながる。親とchildを独立したGit repositoryとして扱いながら、共通ルールとrepository固有ルールの両方を辿れるonboardingを目指した。
実装
rootの読者向け説明へ、最初に親workspaceをcloneし、その配下のproduct containerとbrand-presence containerへ必要なchild repositoriesを個別にcloneするQuick Startを追加した。親はAI組織の設定とworkspaceのcontainerを担い、childのsource codeやGit履歴は管理しない構成とした。
product containerの案内とbrand-presence containerの案内をcontainerごとの案内として追加した。各文書にはrepositoryの目的、clone先、clone commandを記載し、親workspaceのAGENTS.mdを全体ルールの入口、child側にAGENTS.mdが存在する場合はrepository固有ルールとして併用する読み順を示した。
Gitの確認境界も同じ3つのreader guideへ揃えた。cloneしたdirectoryは親から独立したGit repositoryであり、親rootで実行したgit statusやgit diffはchildの状態を自動では統合しない。作業時は対象のrepository rootへ移動し、そのrepository自身の状態を確認する手順とした。
ignore configurationには、予定した3つのproduct repositoryと1つのbrand-presence repositoryのpathだけを追加した。product containerやbrand-presence container全体はignoreせず、containerのreader guideと親側のworkspace説明を引き続き追跡できるようにした。
検証では、4ファイルだけが変更対象であることを確認し、差分の空白errorを検査した。さらに、4つのchild pathがignore ruleへ一致し、product containerの案内とbrand-presence containerの案内はignore対象にならないこと、文書内のclone先と親子Git境界が要求と一致することを確認した。
確認したこと
確認結果
rootのQuick Start、2つのcontainer reader guide、ignore configurationが、親workspaceの下へ独立したchild repositoriesを配置する同じ階層を示す状態になった。
親workspaceはchildの内容やGit履歴を管理せず、親rootのgit statusとgit diffはchildの状態を統合しないため、対象repositoryごとに状態を確認する境界が文書化された。
3つのproduct pathと1つのbrand-presence pathがignore対象となり、container directory全体と2つのreader guideは親側の追跡対象に残ることを確認した。
最終差分は4ファイル、89行追加、4行削除だった。差分の空白error、ignore対象と非対象、clone先、共通ルールとrepository固有ルールの読み順を確認した。
この作業では、child repositoriesを実際にcloneできること、各repositoryの内容、URLの到達性までは確認していない。確認範囲はworkspace説明、clone command、Git境界、ignore ruleの静的な整合までだった。
完了とした根拠
親workspaceとchild repositoriesの配置、clone手順、ルールの読み順、Git状態の確認単位、限定したignore対象が4ファイルで一致し、差分とignore境界の検査を完了したことをもって、このActivityの作業範囲を完了とした。