docs: document the branch model in AGENTS.md - #159
Merged
Merged
Conversation
Describe the baseline / working / topic branch split generically so the section stays correct both in a fork checkout and in the upstream repository. Condition the dev references on the branch existing, which avoids dangling pointers upstream.
lql341
added a commit
to lql341/OneFLOW
that referenced
this pull request
Sep 19, 2026
- Fix the ahead count: the earlier 100 missed commit bc6d395, the real value is 102. - Stop pinning the doc's own commit: its own commit advances dev, so point at git rev-parse instead of a hard-coded sha. - Scope the gate claim correctly: only PR eric2003#160 ran the Kunshan gates; PR eric2003#159 is docs-only and rule 1 does not apply to it. - Add the exact commands used to reproduce T1 and T2, including the amd_comgr_DIR caveat on the upstream runner.
eric2003
approved these changes
Sep 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a short "Branch model" section to AGENTS.md so agents and new contributors know how branches are meant to be used here.
master): mirror of the upstream default branch, read-only PR baseline.dev, when the checkout has one): long-lived daily-work branch; keep it current by merging the upstream default branch, not by rebasing once pushed.The wording is deliberately generic: the fork-specific names appear only in parentheses and the dev references are conditioned on the branch existing, so the section stays correct in the upstream repository as well.
Docs-only change: no code and no numerical impact, so it does not touch the CPU five-case regression gate described in AGENTS.md working rule 1.