Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions .agents/rules/news.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,15 @@
---
trigger: news/*.md
trigger: glob
description: Apply when drafting news entries.
globs: "news/*.md"
---

@CONTRIBUTING.md

# News Entry Conventions

Before drafting any news entry, strictly adhere to the rules in `CONTRIBUTING.md`
above.
Before drafting any news entry, adhere strictly to the rules in
`CONTRIBUTING.md` above.

## Sphinx MyST Cross-Reference Syntax (`{obj}`)
* Use `{obj}\`<symbol>\`` in news entries for rules, macros, targets, providers,
Expand All @@ -17,4 +18,9 @@ above.

## GitHub Issue Link Formatting
* Append GitHub issue cross-references at the end of news entries in markdown
link format: `([#3283](https://github.com/bazel-contrib/rules_python/issues/3283))`.
link format:
`([#3283](https://github.com/bazel-contrib/rules_python/issues/3283))`.

## Unreleased and Internal Changes
* Do not add news entries for internal refactoring or fixes to unreleased code.
News entries are only for released, user-visible behavior.
2 changes: 2 additions & 0 deletions .agents/rules/pr.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Before drafting any pull request description, strictly adhere to the rules in
`fix(tests):`).
* `agents:` / `agents(<scope>):`: Agent rules, skills, and prompts
(`.agents/`).
* `refactor:`: Internal refactoring and fixes for unreleased changes. Never use
`fix:` or `feat:` unless modifying released, user-visible behavior.

## PR Commit Workflow Invariant
* Once a Pull Request is created, always make new commits or merge commits.
Expand Down
3 changes: 3 additions & 0 deletions .agents/rules/workspace.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,7 @@ basis:
.agents/scripts/setup_triangle_branch.sh <branch>
```
* Never use `git push -u` or `--set-upstream` (it breaks upstream tracking).
* When pushing to a checked-out PR branch from an external fork, push
explicitly to that remote (`git push <remote> HEAD:<branch>`). Do not rely on
a bare `git push`.