diff --git a/.github/reviewers.md b/.github/reviewers.md index f2d5d988c8..f4d8f3ecc8 100644 --- a/.github/reviewers.md +++ b/.github/reviewers.md @@ -2,23 +2,23 @@ Live list of automated reviewers for this repository (elsa-core). Agents read it before opening a PR. -Last verified: 2026-10-03 +Last verified: 2026-10-04 | Reviewer | Status | How to request | Notes | | --- | --- | --- | --- | | Greptile (`greptile-apps[bot]`) | live | Automatic when a PR is opened; comment `@greptileai` after every push | **Required for merge** on this repository (see Rules). Posts a "Confidence Score: N/5" summary and a "Greptile Review" check. Reviews only allow-listed authors; others get "PR author is not in the allowed authors list". | | CodeRabbit (`coderabbitai[bot]`) | live | Automatic on PRs into `main`; comment `@coderabbitai review` for other base branches or a re-review after a push | Advisory. Skips PRs into other base branches unless requested. Reviews draw on an hourly allowance, so do not request it while its automatic review is pending. | | GitHub Copilot code review (`copilot-pull-request-reviewer[bot]`) | live | Add reviewer `@copilot`: `gh pr edit --add-reviewer @copilot` (GitHub CLI 2.88 or later) | Advisory. A `@copilot review` comment does not trigger it. Bot-authored PRs need the org policy that lets Copilot review them. | -| Cursor Bugbot | not live | Top-level PR comment `cursor review` (once enabled) | Must first be enabled in the Cursor dashboard. `cursor[bot]` comments on PRs come from Cursor cloud agents, not Bugbot. | +| Cursor Bugbot (`cursor[bot]`) | live (elsa-core only) | Mention-only: top-level PR comment `cursor review` (also `@cursor review` or `bugbot run`); comment again after a push to review the new head | Advisory. Enabled on elsa-core only, not on elsa-studio or elsa-extensions. Posts a review whose body starts with `` and names the reviewed commit; first verified on #8598 (review landed about 3 minutes after the comment). Cloud agents also comment as `cursor[bot]`, so identify Bugbot by that review marker. | | GitHub Code Quality (`github-code-quality[bot]`) | informational | Automatic; cannot be requested | CodeQL code-quality comments. Not an advisory pick and not part of the merge gate. | ## Rules - Greptile is a required reviewer on this repository. It reviews automatically when a PR is opened; after every push, comment `@greptileai` so it reviews the new head. -- Besides Greptile, request at most one additional advisory reviewer (CodeRabbit or Copilot) once the PR is open. If your pick reviews automatically on this PR (CodeRabbit does on PRs into `main`), wait for that run instead of requesting it; request it manually only if no run appears, the PR targets another base branch, or you need a re-review after a push. -- If the additional reviewer declines or skips the PR, you may request the other one instead. +- Besides Greptile, request at most one additional advisory reviewer (CodeRabbit, Copilot, or Bugbot on elsa-core) once the PR is open. If your pick reviews automatically on this PR (CodeRabbit does on PRs into `main`), wait for that run instead of requesting it; request it manually only if no run appears, the PR targets another base branch, or you need a re-review after a push. +- If the additional reviewer declines or skips the PR, you may request another eligible reviewer instead. - The PR author (human or agent) never reviews or approves its own PR. - Merge gate: an Elsa 3 Code Review `APPROVE + HIGH @ ` (the full 40-character SHA of the PR's current head commit), green CI, and Greptile 5/5 on that same head. Any push after the approval needs a re-confirm on the new head. - Exception: if Greptile cannot review the head (unavailable, skipped, declined, or out of credits), `APPROVE + HIGH @ ` plus green CI is enough, and the Code Review must state that Greptile was required and unavailable. -- CodeRabbit and Copilot reviews are advisory and never replace the merge gate. +- CodeRabbit, Copilot and Bugbot reviews are advisory and never replace the merge gate. - Update this file whenever a reviewer is added, removed, or changes how it is requested.