From fbbf502584baddb9ab1dfb94b1c9f37d8648f651 Mon Sep 17 00:00:00 2001 From: Richard Levasseur Date: Mon, 3 Aug 2026 23:33:20 +0000 Subject: [PATCH] agents(pr): prohibit per-file edit lists in PR descriptions Update the pull request rules to explicitly prohibit per-file edit lists or individual file changelog items in PR descriptions and commit messages. Reinforce that PR descriptions must provide a high-level overview explaining why a change is made and how at a conceptual level, and mandate linking related issues. --- .agents/rules/pr.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/.agents/rules/pr.md b/.agents/rules/pr.md index ba8236d072..caacb07519 100644 --- a/.agents/rules/pr.md +++ b/.agents/rules/pr.md @@ -1,6 +1,6 @@ --- trigger: model_decision -description: Apply when drafting pull request descriptions. +description: rules to apply to pull request descriptions --- @CONTRIBUTING.md @@ -18,3 +18,7 @@ Before drafting any pull request description, strictly adhere to the rules in * Once a Pull Request is created, always make new commits or merge commits. * **NEVER** amend or rebase commits on an active PR branch to avoid breaking code review threads. +* **NEVER** include a list of per-file edits or changelog bullet points of + individual file modifications in PR descriptions or commit messages. +* High-level overview only: state *why* the change is made and *how* at a + conceptual level. Link related issues (e.g. `Work towards #`).