Skip to content

Commit 2bc9395

Browse files
[repo] Update AGENTS.md with dependency allowance and versioning guidance (flutter#12579)
Updates `AGENTS.md` to add guidance on common presubmit validation requirements: - Clarifies that modifying non-exempt files (such as `pubspec.yaml` or tool configs) triggers version and `CHANGELOG.md` requirements during repository validation unless explicit override labels are requested. ## Pre-Review Checklist - [x] I read the [Contributor Guide] and followed the process outlined there for submitting PRs. - [x] I read the [AI contribution guidelines] and understand my responsibilities, or I am not using AI tools. - [x] I read the [Tree Hygiene] page, which explains my responsibilities. - [x] I read and followed the [relevant style guides] and ran [the auto-formatter]. - [x] I signed the [CLA]. - [x] The title of the PR starts with the name of the package surrounded by square brackets, e.g. `[shared_preferences]` - [x] I updated/added any relevant documentation (doc comments with `///`). - [x] All existing and new tests are passing. <!-- Links --> [Contributor Guide]: https://github.com/flutter/packages/blob/main/CONTRIBUTING.md [AI contribution guidelines]: https://github.com/flutter/flutter/blob/main/docs/contributing/Tree-hygiene.md#ai-contribution-guidelines [Tree Hygiene]: https://github.com/flutter/flutter/blob/master/docs/contributing/Tree-hygiene.md [relevant style guides]: https://github.com/flutter/packages/blob/main/CONTRIBUTING.md#style [the auto-formatter]: https://github.com/flutter/packages/blob/main/script/tool/README.md#format-code [CLA]: https://cla.developers.google.com/ [Discord]: https://github.com/flutter/flutter/blob/master/docs/contributing/Chat.md [linked to at least one issue that this PR fixes]: https://github.com/flutter/flutter/blob/master/docs/contributing/Tree-hygiene.md#overview [the version and CHANGELOG instructions]: https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#version-and-changelog-updates [semantic versioning]: https://dart.dev/tools/pub/versioning#semantic-versions [repository CHANGELOG style]: https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changelog-style [test exemption]: https://github.com/flutter/flutter/blob/master/docs/contributing/Tree-hygiene.md#tests --------- Co-authored-by: Reid Baker <[email protected]> Co-authored-by: Reid Baker <[email protected]>
1 parent 5620e65 commit 2bc9395

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

‎AGENTS.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,8 +150,10 @@ dart run $REPO_ROOT/script/tool/bin/flutter_plugin_tools.dart update-release-inf
150150
--changelog="A description of the changes."
151151
```
152152

153-
- `--version=minimal`: Bumps patch for bug fixes, and skips unchanged packages. This is usually the best option unless a new feature is being added.
153+
- `--version=minimal`: Bumps patch for bug fixes and non-breaking changes, and skips unchanged packages. This is usually the best option unless a new feature is being added.
154154
- When making public API changes, use `--version=minor` instead.
155155
- `--base-branch=origin/main`: Diffs against the `main` branch to find changed packages.
156156

157+
If a change is strictly internal/exempt (e.g., repo-wide CI tooling) and should not bump package versions, explain the exemption in the PR description and request the `override: no versioning needed` and `override: no changelog needed` labels.
158+
157159
If you update manually, follow semantic versioning and the [repository's CHANGELOG style](https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changelog-style).

0 commit comments

Comments
 (0)