Skip to content

[no-ci] Support organization-owned forks in AGENTS.md#2378

Open
rwgk wants to merge 1 commit into
NVIDIA:mainfrom
rwgk:agents_md_update_intra-org_repos
Open

[no-ci] Support organization-owned forks in AGENTS.md#2378
rwgk wants to merge 1 commit into
NVIDIA:mainfrom
rwgk:agents_md_update_intra-org_repos

Conversation

@rwgk

@rwgk rwgk commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Description

This updates the repository-wide agent guidance to support approved forks owned by either personal accounts or organizations.

The existing guidance assumes that every contributor uses a personal fork and can always open a pull request with gh pr create. That command currently cannot identify some renamed organization-owned forks (cli/cli#10093), even though GitHub's GraphQL API supports selecting the head repository explicitly through headRepositoryId.

The update:

  • requires agents to distinguish the canonical repository and fork by complete OWNER/REPOSITORY names;
  • keeps the canonical repository read-only by default, with a narrowly scoped exception when the user explicitly requests a specific upstream test branch;
  • uses gh pr create when it can identify the fork unambiguously;
  • documents the GraphQL headRepositoryId fallback for organization-owned forks; and
  • preserves pull-request template, assignee, label, and milestone requirements regardless of how a pull request is created.

The wording is intentionally repository-neutral so the guidance remains applicable across supported development setups.

Review focus:

  • Is the upstream-push exception narrow enough while still supporting workflow testing?
  • Is the API fallback clear enough for agents to use reliably?
  • Are the fork and repository identity checks sufficiently explicit?

This PR does not have an associated GitHub issue.

Validation:

  • pre-commit run --files AGENTS.md
  • git diff --check

Checklist

  • New or existing tests cover these changes. (Not applicable: this is an agent-guidance-only change.)
  • The documentation is up to date with these changes.

@rwgk rwgk added this to the cuda.bindings 13.4.0 & 12.9.8 milestone Jul 16, 2026
@rwgk rwgk added the documentation Improvements or additions to documentation label Jul 16, 2026
@rwgk rwgk self-assigned this Jul 16, 2026
@copy-pr-bot

copy-pr-bot Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

@rwgk rwgk added the P0 High priority - Must do! label Jul 16, 2026
@rwgk rwgk marked this pull request as ready for review July 16, 2026 05:57
@rwgk rwgk requested a review from rparolin July 16, 2026 05:57
@rwgk rwgk added the cuda.bindings Everything related to the cuda.bindings module label Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cuda.bindings Everything related to the cuda.bindings module documentation Improvements or additions to documentation P0 High priority - Must do!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant