From 68f0cbc06d4a8b0c0d1eff8ecdd9f00f638e967c 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 <noreply@anthropic.com>
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 195c857..e6718b7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -136,6 +136,10 @@ Read [the Cursor Cloud environment notes](docs/CURSOR-CLOUD-ENVIRONMENT.md)
 when working in a Cursor Cloud VM: toolchain, the test, validate, and run
 commands, and the `npm install` caveat.
 
+## 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/<path>`; 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.