Skip to content

Commit 8ee2bfd

Browse files
docs: add shared agent and Bugbot guardrails
- AGENTS.md: agentic guardrails (fresh tip, no force-push, verify before review) - .cursor/BUGBOT.md: global Bugbot expectations (latest head, behavior-first, CI)
1 parent 0993b45 commit 8ee2bfd

2 files changed

Lines changed: 25 additions & 0 deletions

File tree

.cursor/BUGBOT.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Bugbot review guidance
2+
3+
## Global expectations
4+
5+
- **Latest head:** Assume the PR branch reflects the latest pushed commits; if review context looks stale relative to GitHub, refresh before commenting.
6+
- **No force-push:** Do not suggest force-pushing shared branches as the default fix.
7+
- **Prioritize behavior:** Flag correctness, security, compatibility, and API or contract risks ahead of style-only feedback unless style obscures a defect.
8+
- **Trust CI:** When CI already enforces formatting or static analysis, avoid duplicating that noise in comments unless the check is wrong or misleading.
9+
10+

AGENTS.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,20 @@
11
# AGENTS.md
22

3+
## Agentic guardrails
4+
5+
These apply to human and automated contributors (including Cloud Agents).
6+
7+
1. **Work from the latest branch tip**
8+
Before you start work on a branch: `git fetch origin`, check it out, then `git merge --ff-only origin/<branch>` (or `git pull --ff-only` when upstream is configured). If you cannot fast-forward, stop and align with the repository's normal merge or rebase workflow. Do not silently work on a stale checkout.
9+
10+
2. **Never force-push shared history**
11+
Do not `git push --force`, `git push --force-with-lease`, or rewrite published branch history unless a maintainer explicitly authorizes that operation for the exact repository and branch.
12+
13+
3. **Focused changes and verification**
14+
Keep pull requests scoped; run this repository's standard build, test, and lint commands (see README, Makefile, or CLAUDE.md) before requesting review.
15+
16+
---
17+
318
## Cursor Cloud specific instructions
419

520
This is a **pure Go test-utility library** with zero external dependencies beyond the Go toolchain and `git` CLI. There are no services, databases, or containers to start.

0 commit comments

Comments
 (0)