Back to Research

Cursor Agents Team Checklist

A Cursor Workshop guide for using Cursor agents, rules, skills, and Bugbot in reviewable team workflows.

Het papaverveld bij Vaux Field of Poppies, landscape painting by Charles-François Daubigny (1872).
Rogier MullerJune 17, 20266 min read

Cursor agents work best when your team treats them as reviewable teammates, not private shortcuts. A Cursor agent is the AI coding workflow inside Cursor, Anysphere's AI code editor, that plans, edits files, runs commands, and prepares a change you can read before it merges. The team part is simple: bind every run to shared rules, scoped skills, and a human review gate.

You know the moment this matters. A ticket is blocked, the pull request queue is full, and someone asks whether Agent mode or a background run can just clean it up. The answer is yes, as long as the agent's work is easy for the next engineer to inspect.

Why does a faster agent need slower process?

Cursor's changelog from June 10, 2026 has good news. Bugbot review now takes about 90 seconds, down from roughly 5 minutes. It finds 0.62 bugs per review on average, up from 0.56, and costs about 22% less per run. Composer 2.5 powers it now, and it respects model block lists.

That is a release note, not a governance plan. Faster review does not remove team process. It just makes a weak process fail faster.

The real problem is rarely the agent's ability. It is missing context. Rules, AGENTS.md boundaries, skills, MCP access, and review checklists tend to live in five different places, so the agent sees the task but not the team's contract. Give it that contract and the speed becomes safe to use.

Where does agent work usually break?

Five failure modes show up again and again. Each has a small, boring fix.

  • Prompt drift. One engineer says "refactor safely," another says "clean this up." Those are wishes, not instructions. Put the team default in a .cursor/rules file: test boundaries, migration rules, logging policy, review expectations.
  • Skill sprawl. A handy skill for API migrations gets copied into five repos with no owner. Treat a skill like a maintained asset with a narrow name and a review path. It should fire because the task matches it, not because someone remembers where it lives.
  • Unsafe integration. MCP can connect an agent to GitHub, Jira, or your docs. Apply the production-credentials rule: least privilege first, allowed actions defined before the first run.
  • Review theater. Bugbot getting faster does not make it the approver. It is review input. A human still owns accountability.
  • Channel mismatch. Agent mode in the IDE, background agents, and the CLI can all touch the same repo. If each path carries different context, you get split-brain automation. Use one convention for every entry point.

The thread running through all five: if the agent's reasoning, commands, and constraints cannot be reviewed by another engineer, the work is not ready.

What does the convention look like?

Here is a starter you can copy into a repo today. Put the policy in AGENTS.md, the durable implementation rules in .cursor/rules/*.mdc, and any repeatable workflow in a skill once the pattern actually repeats.

# Cursor agent team convention

Purpose:
- Speed up implementation and review without removing engineer ownership.

Applies to:
- Agent mode in the IDE
- Background agents
- Cursor CLI workflows used for repository work
- Bugbot review comments

Required context before a run:
- Read AGENTS.md for repository boundaries.
- Load the relevant .cursor/rules/*.mdc files.
- Use a skill only when its name and description match the task.
- Do not reach external systems via MCP unless the task needs it and the server is approved.

Run checklist:
- State the task and expected files before editing.
- Ask before touching public APIs, schema, auth, billing, or deploy config.
- Run the narrowest useful tests, or explain why tests were skipped.
- Summarize changed files, commands run, and unresolved risks.
- Leave a diff a human can review line by line.

Bugbot rule:
- Treat findings as input, not approval.
- A human resolves or rejects each material finding before merge.
- If Bugbot is blocked by policy, cost, or config, note it in the PR.

Ownership:
- Whoever starts the agent owns the diff.
- The reviewer owns the merge.

Adoption is one pull request. One engineer proposes the first version, two maintainers review it, and the team iterates from there.

What should we standardize first?

Start with the smallest artifact your reviewers already look at, then make agent runs leave a receipt against it. This keeps the first step inspectable without replaying the whole chat.

- [ ] Name the artifact first: a .mdc rule stub, an AGENTS.md boundary, or a review checklist.
- [ ] Write the review checklist before generation: scope, owner, tests, rollback.
- [ ] Keep the first step small enough to inspect without rerunning the session.
- [ ] Add the fastest safe undo path next to the change.

If you want to practice this with a reviewer in the room, the subagents and skills topic is the natural next stop. The goal is not more ceremony. It is fewer invisible decisions.

Common questions

  • How should a team start with Cursor agents?

    Turn the agent into one visible team rule instead of a loose preference. In practice that is a short repository convention, a review checklist, and a single owner who can reject agent output when the evidence is thin. Start with one repo, ship the convention as a pull request, and let the rest of the team adopt it from a working example rather than a memo.

  • Which artifact should we standardize first?

    Pick the smallest thing your reviewers already touch: a .mdc rule, an AGENTS.md note, or a review checklist. Volume of documentation is not the point. The point is one shared place where scope, allowed tools, expected tests, and the rollback path are visible before generated code reaches review. Everything else can grow later.

  • Does faster Bugbot mean we can skip human review?

    No. The June 2026 changelog shows Bugbot can make review loops cheaper and quicker, which is genuinely useful. It does not show that teams can drop human accountability. Treat Bugbot findings as input to the review, not the approval itself, and require a person to resolve or reject each material finding before the change merges.

  • How do we know the convention is working?

    It works when a reviewer can approve or reject from the artifact and the evidence alone. Watch whether pull requests name the rule they used, include the checks they promised, and avoid forcing the reviewer to replay a long session just to understand what changed. If approvals still need a chat replay, the convention has a gap worth closing.

Take it to a real PR

Try the convention on one open pull request and check whether a fresh reviewer can defend the merge without replaying the chat. If they can, see the subagents and skills topic or a hands-on training session to roll it out wider.

Further reading

Related training topics

Related research

Continue through the research archive

Ready to start?

Transform how your team builds software.

Get in touch