FACTUAL ACTIVITY RECORD · 実際の作業をもとにした活動記録
親workspaceを組織ガバナンスの入口に定める
組織ルール、child固有の技術情報、repository別のGit状態を文書上で分離する
目的
AI組織のルールを親workspaceで管理する一方、配下には独立したchild repositoryが置かれていた。childだけをworkspaceとして開くと親のproject設定や組織ルールが適用されない可能性があり、どこから作業を始めるかを一意にする必要があった。
また、組織全体のガバナンスとchild固有の構成・command・環境変数・deploy手順を同じ文書へ重複させず、親子のbranch、working tree、diff、commit、remoteをrepositoryごとに確認する境界を揃えることを目的とした。
実装
AGENTS.mdのstanding rulesへ、親をCodex workspace rootとして使うこと、child repositoryを独立したGit repositoryとして扱うこと、child固有の技術情報を各childのproject guideとdocs/へ置くことの3項目を追加した。組織ガバナンスの入口と技術仕様の置き場所を分け、親のinstructionへchildの技術詳細を複製しない構成にした。
- 組織・agent governanceは、親workspaceの
AGENTS.md、.codex/、.agents/を入口にする。 - child固有の構成、command、環境変数、deploy手順は、各childのproject guideと
docs/を参照する。 - 親rootの
git statusやgit diffがchildの変更を統合するとは扱わず、branch、working tree、commit、remoteをrepositoryごとに確認する。
the root project guide、setup guide、operating modelにも同じ境界を同期した。setupでは親をworkspace rootとして開き、trust後にproject-scopedな設定、rules、hooks、Custom Agent、Skillを再読み込みする流れを示した。operating modelでは、child単体で開始すると親ガバナンスが適用されない可能性と、AI組織workflowを親から始める運用を説明した。
brand workspace guideとproduct workspace guideでは、child側のAGENTS.mdを補足ルールとして尊重する旧記述を削除した。その代わりに、childの技術情報をchildのproject guideとdocs/へ置くこと、親子のGit状態を変更前後に個別確認することを記載し、配置場所の案内とガバナンス本文の責務を分けた。
検証では、変更した文書を対象に旧方針、旧repository名、絶対pathの残存を検索し、git diff --checkで差分の空白errorを確認した。親とchildのbranch、working tree、diffも別々に確認し、親instructionの大きさを設定上限と照合した。
一次Commitの差分へ照合し、公開禁止識別子を削除または一般化したAGENTS.mdの抜粋を示す。
## Standing Rules
- Codex は `<workspace-root>` を workspace root として使い、配下の child repository 単体を organization / agent governance の入口にしないこと
- child repository は独立した Git repository として扱い、親子それぞれの branch、working tree、diff、commit、remote、PR を個別に確認すること
- child 固有の構成、コマンド、環境変数、deploy 手順は child の reader-facing and technical guides を参照し、親 `AGENTS.md` に技術詳細を重複させないこと図を描画しています…
確認したこと
確認結果
6文書の差分で、親workspaceを組織ガバナンスの入口とする説明、child固有技術情報の参照先、repositoryごとのGit境界が同じ方針へ揃った。
旧child AGENTS.md尊重方針の残存検索とgit diff --checkが成功した。親instructionは28,279 bytesで、設定された65,536 bytesの上限内だった。
変更後の6文書を再確認し、親workspace、child固有情報、repository別Git状態の責務境界が同じ説明になっていることを確認した。
この作業で確認したのは文書差分、残存検索、instruction size、repository別Git状態までである。childだけを新しいCodex sessionで開いたときのruntime挙動や、productの実行時動作は検証していない。
完了とした根拠
組織ガバナンスの入口、child固有技術情報の置き場所、repository別Git状態の確認方法が6文書で一致し、残存検索、差分検査、instruction sizeの確認が成功したことをもって、この文書化の範囲を完了とした。