From 68f3ee90e8781b3424e3232b413761f4495c687f Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Fri, 9 Oct 2026 17:39:12 -0400 Subject: [PATCH] docs(agents): point to the org architecture repo Add the fixed org-architecture pointer so an agent working in this repo knows where cross-repo decisions, the glossary and the repo map live. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01EFqTQRnCGywRxhv4nw4o4V --- AGENTS.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 1208227..853e00f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -165,6 +165,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 with `gh api 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 access is denied, stop and tell the user. + ## Code Review Rules Each line names a rule CI does not enforce; the linked file states it in full.