agents: update news and PR conventions (#4138)
Update agent rules based on recent review feedback.
- Refine `.agents/rules/news.md` to mandate focusing on user-visible
outcomes and restrict `{obj}` to documented API symbols.
- Update `.agents/rules/pr.md` to preserve author wording and wrap PR
description bodies at 72 columns.diff --git a/.agents/rules/news.md b/.agents/rules/news.md
index 7946967..71e63f9 100644
--- a/.agents/rules/news.md
+++ b/.agents/rules/news.md
@@ -12,9 +12,13 @@
`CONTRIBUTING.md` above.
## Sphinx MyST Cross-Reference Syntax (`{obj}`)
-* Use `{obj}\`<symbol>\`` in news entries for rules, macros, targets, providers,
- attributes, args, and any other cross-referencable Starlark or Python
- objects.
+* Use `{obj}\`<symbol>\`` only for cross-referencable Starlark or Python API
+ symbols (rules, macros, targets, providers, attributes, args).
+* Never use `{obj}` on metadata files (e.g. `RECORD`), file paths, or tools.
+
+## Content
+* State user-visible behavior and outcomes (what now works, what changed).
+* Omit internal implementation and refactoring details.
## GitHub Issue Link Formatting
* Append GitHub issue cross-references at the end of news entries in markdown
diff --git a/.agents/rules/pr.md b/.agents/rules/pr.md
index 20690eb..7c49497 100644
--- a/.agents/rules/pr.md
+++ b/.agents/rules/pr.md
@@ -43,3 +43,5 @@
conceptual level. Link related issues (e.g. `Work towards #<issue>`).
* **Conciseness & Style (Strunk & White)**: Omit needless words. Use clear,
active, and direct phrasing for *why* and *how*.
+* **Preserve Existing Descriptions**: Preserve the author's wording unless
+ instructed to change it. Wrap bodies at 72 columns.