# AGENTS Instructions
This repository is a git superproject that pins child repositories as submodules for local development and integration work. Treat it as a coordination workspace, but do **not** automatically fan out branch names, PRs, or status checks across child repositories.
## Required behavior for submodule changes
If your work changes files inside a submodule:
1. make the code change in that child repository using whatever branch and PR flow makes sense for that repo
2. update the monorepo gitlink only when the superproject should consume the new child commit
3. keep unrelated submodules untouched
There is no mandatory monorepo fanout helper, no child branch mirroring requirement, and no generated manifest that must accompany submodule pointer changes.
## Validation expectations
Before finishing:
- validate newly added or changed workflow files
- preserve `pull_request` validation and `push` to `main` validation
- keep monorepo automation focused on visibility and validation rather than cross-repo orchestration
## Source of truth files
- `.gitmodules` — declared child repositories
- `.github/workflows/submodule-governance.yml` — lightweight monorepo validation for submodule pointer visibility