What changes
The GitHub experience remains familiar. Charlie still reviews pull requests, and your team can still request a review by addingCharlieHelps as a reviewer or mentioning him in a pull request comment.
The main change is who controls the review policy:
Policy changes take effect after they reach the repository’s default branch. Charlie loads the updated policy within a few minutes.
Start with the reference policy
We recommend starting with the referencepr-review daemon so you have a known baseline for migration. It is based on Charlie’s existing review behavior, with focused correctness and repository guidance perspectives, an evidence bar for findings, and rules that avoid low-value feedback such as personal style preferences or problems the pull request did not introduce.
The reference daemon does not review every new commit by default. This is the
main cadence change from agent-powered reviews.
- A non-draft pull request is opened.
- A draft pull request is marked ready for review.
CharlieHelpsis requested as a reviewer.- A pull request comment requests a review from
CharlieHelps.
COMMENT review. When a completed review is clean, Charlie adds one +1 reaction to the pull request body instead of posting an empty review or summary.
How reviews are routed during the transition
You do not lose review coverage while the new experience rolls out.Agent-powered automatic reviews are a temporary fallback. Install the
pr-review daemon to keep automatic reviews enabled after the transition.Migrate your repository to daemon-powered reviews
- Follow Set up PR reviews to install the reference daemon. Installing from the Charlie dashboard or asking Charlie creates a pull request for your team to review.
- Review the starting policy. Before merging the installation pull request, you can optionally:
- Add
A new commit is pushed to an open non-draft pull request.towatchinDAEMON.mdif you want Charlie to review every new commit pushed to the pull request. - Update Review outcomes in
DAEMON.mdto allow Charlie to submitAPPROVEorREQUEST_CHANGESreviews in addition toCOMMENT. Define when each outcome should be used.
- Add
- Merge the installation pull request into the repository’s default branch.
- Allow a few minutes for Charlie to load the policy. Observe a few representative reviews in GitHub and Dashboard Activity.
- Keep the reference policy if it works for your team. When you find a specific behavior to change, use Configure PR reviews and adjust one decision at a time.
pr-review before the transition ends to keep automatic reviews running.
Next steps
Set up PR reviews
Install the reference daemon and merge its policy into your default branch.
Configure PR reviews
Change cadence, review perspectives, evidence rules, and review output.
Control review costs
Tune review frequency and scope after observing representative reviews.