Repository navigation
AGENTS.md: add the version skew rules - #3151
Merged
Tim Hockin (thockin) merged 3 commits intoOct 28, 2026
Merged
Conversation
Benjamin Elder (BenTheElder)
left a comment
Benjamin Elder (BenTheElder)
left a comment
Collaborator
There was a problem hiding this comment.
ok now this is a PR I'm definitely having an agent review :-)
big +1 for the concept, I think we need to nail down the details, agents take things very literally.
List the version skew rules a code change is most likely to break, so agents follow them without opening the policy. They apply from v1.0.0. Signed-off-by: Haven Xia <[email protected]>
Until v1.0.0, the Backward Compatibility section of AGENTS.md tells agents not to add compatibility code, and every agent session loads the file. So the version skew section is a pointer to the policy for now. The summary can come back when that section goes. Fix two gaps in the policy. Components that upgrade before ate-controller run against the N CRDs, and atelet watches WorkerPool and SandboxConfig. ateworker reads sandbox-runtimes.json, which atelet writes, and decodes it strictly, so a new field there takes two releases. Signed-off-by: Haven Xia <[email protected]>
Co-authored-by: Davanum Srinivas <[email protected]> Signed-off-by: Haven Xia <[email protected]>
Haven Xia (HavenXia)
force-pushed
the
agents-version-skew
branch
from
October 26, 2026 23:10
7c28c8e to
b7d966e
Compare
Tim Hockin (thockin)
added
prio/P0
Bowei Du (bowei)
added
area/dev-infra
kind/docs
Tim Hockin (thockin)
approved these changes
Oct 28, 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
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.
List the version skew rules a code change is most likely to break, so developers' agents follow them without opening the policy.
They apply from v1.0.0.