diff --git a/AGENTS.md b/AGENTS.md index 261a766..8ac38a7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -17,6 +17,10 @@ to that shape before opening the pull request: this repository carries no local template and inherits the org default from [`melodic-software/.github`](https://github.com/melodic-software/.github/blob/main/.github/PULL_REQUEST_TEMPLATE.md). +## Org architecture + +Org architecture (cross-repo decisions, glossary, why each trust link exists): private repo `melodic-software/architecture`; repo map: `gh api orgs/melodic-software/properties/values` (system and role per repo). Read it before cross-repo or infrastructure changes: `gh api -H 'Accept: application/vnd.github.raw' repos/melodic-software/architecture/contents/`; on Claude Code on the web, attach it at session start; in CI, check it out with a read-only App token. If you need it and cannot read it, say so instead of guessing its contents; tasks that don't need it continue. + ## Code Review Rules Each line names a rule CI does not enforce; the linked file states it in full.