From 85f4f0ee266441337678296a9fcbcf8e1bec9bfd Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Fri, 9 Oct 2026 17:39:11 -0400 Subject: [PATCH 1/2] 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 261a766..fd1e08b 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 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. From dc4fdb3cc43a78feaa55fedf076201b2203d1e72 Mon Sep 17 00:00:00 2001 From: Kyle Sexton <153232337+kyle-sexton@users.noreply.github.com> Date: Fri, 9 Oct 2026 17:58:43 -0400 Subject: [PATCH 2/2] docs(agents): fix the org architecture pointer wording Name the raw media type so the file read returns text, say when to read the architecture repo, and replace "stop and tell the user" with a rule that lets tasks not needing it continue. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01EFqTQRnCGywRxhv4nw4o4V --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index fd1e08b..8ac38a7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,7 +19,7 @@ local template and inherits the org default from ## 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. +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