Skip to content

docs(agents): point to the org architecture repo - #99

Merged
kyle-sexton merged 1 commit into
mainfrom
docs/org-architecture-pointer
Oct 9, 2026
Merged

kyle-sexton merged 1 commit into
mainfrom
docs/org-architecture-pointer

Conversation

@kyle-sexton

Copy link
Copy Markdown
Member

No related issue: org-wide pointer rollout (owner-approved 2026-10-09)

Summary

Adds one fixed pointer line, under a short ## Org architecture heading in the agent instructions file, to the private melodic-software/architecture repo (cross-repo decisions, glossary, why each trust link exists, repo map).

Fix

The same line goes into every governed, non-archived repo so an agent in any of them finds the org context and knows to stop if access is denied. The section sits before ## Code Review Rules so that section stays last. A follow-up in melodic-software/standards adds a repo-policy check that fails a repo whose AGENTS.md or CLAUDE.md lacks melodic-software/architecture.

Verification

  • The added line is byte-identical to the approved text across the rollout.
  • The file diff is the new section only; no existing line changed.
  • Repo hooks and checks ran on commit and in CI.

Related

  • Owner-approved org-wide rollout, 2026-10-09.
  • Standards check: see the linked melodic-software/standards PR from this rollout.

🤖 Generated with Claude Code

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
@kyle-sexton
kyle-sexton marked this pull request as ready for review October 9, 2026 21:41
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-09T21:43:14.710124Z 68f3ee9 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@claude

claude Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

Claude finished @kyle-sexton's task in 46s —— View job


Security review complete

  • Gather context (PR diff, changed files)
  • Apply skip gate
  • Review diff for security-relevant surface
  • Check instruction-surface deletion lens
  • Report findings

Skip gate: triggered. This PR touches a single file, AGENTS.md, adding 4 lines and removing none — a purely additive ## Org architecture section pointing to the private melodic-software/architecture repo. No workflow, script, hook, permission, or config file is touched.

Instruction-surface lens: not applicable — the diff only adds a new section; it does not delete, narrow, or soften any existing rule, so there is no removed guardrail to check against the protected-class register.

Content of the add itself: no security concern.

  • It points to a repo-map lookup (gh api orgs/melodic-software/properties/values) and content read (gh api repos/melodic-software/architecture/contents/<path>) — both read-only gh api calls against a private org repo, not an injection surface.
  • It explicitly scopes the CI checkout to a read-only App token (least privilege).
  • It specifies a fail-safe: "If access is denied, stop and tell the user" rather than silently proceeding or escalating privilege.
  • No secrets, tokens, or credentials are embedded or handled in the diff.

No security issues found in this PR. No inline or summary findings to report.

@claude

claude Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

Claude finished @kyle-sexton's task in 56s —— View job


Code review (/review:code-review)

  • Gather context (PR diff, AGENTS.md, CLAUDE.md)
  • Classify request — CI code-review lane, correctness + CLAUDE.md/REVIEW.md alignment
  • Review changed lines
  • Report findings

Scope: 1 file changed, AGENTS.md (+4/-0) — adds an ## Org architecture section pointing to the private melodic-software/architecture repo, placed before ## Code Review Rules.

Findings: none.

This is a self-contained documentation addition with no executable logic, no tests, and no touched scripts/manifests — outside the high-signal bar for this lane (no correctness bug is expressible in four lines of prose with no code path). Checked specifically:

  • Section placement matches the PR's own stated rule (## Code Review Rules stays last) — confirmed in the diff.
  • The one verifiable technical claim, the gh api orgs/melodic-software/properties/values custom-properties endpoint, matches GitHub's current REST API shape for org-wide custom property values.
  • No internal repo-path links are introduced, so the repo's markdown-link-integrity and doc-conventions rules in AGENTS.md don't apply here.
  • No duplication with existing content elsewhere in AGENTS.md.

Nothing to flag as a blocking or non-blocking finding.

@github-actions

github-actions Bot commented Oct 9, 2026

Copy link
Copy Markdown

claude-security-review has reviewed this pull request through 68f3ee9; a later push is reviewed from there.

@github-actions

github-actions Bot commented Oct 9, 2026

Copy link
Copy Markdown

claude-review has reviewed this pull request through 68f3ee9; a later push is reviewed from there.

@kyle-sexton
kyle-sexton merged commit b5a76ac into main Oct 9, 2026
13 checks passed
@kyle-sexton
kyle-sexton deleted the docs/org-architecture-pointer branch October 9, 2026 21:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant