Skip to main content

Customize

The agent follows your instructions file when it writes a review. For Claude Code that is CLAUDE.md; for Codex, AGENTS.md; for Copilot CLI, AGENTS.md or .github/copilot-instructions.md. Add the lines below, or your own wording, to the project's file or to your personal one. Ideally, put them in a section titled # Review Raven.

Verbosity of the narrative​

The walkthrough is as long as the agent judges necessary. Tell it otherwise:

In Review Raven reviews, keep each narrative passage to one or two sentences.
In Review Raven reviews, explain each diff chunk in detail; I do not know this codebase.

When a review is written​

By default, the agent writes a review after any non-trivial change, and whenever you ask for one.

Always review:

Run /review-raven when you are done implementing something.

Only on request:

Write a Review Raven review only when I ask for one.

Asking the agent to "prepare a review" starts one at any time; in Claude Code, so does /review-raven.

What a later review round shows​

After you request changes, the agent answers your comments in a new review round. By default, that round's walkthrough shows only what changed since the previous round, that is, how the agent addressed your comments. The diagram and the design always describe the whole change. To have every review round show all changes:

In Review Raven reviews, always show all changes from all rounds, not only the changes since the previous round.
Keep the first round's `base` in every later round.

After approval​

On Approve, the agent makes no further changes, except for the follow-up steps and instructions you add in the approval dialog. To have it always continue, say what comes next:

Commit after I approve the review.
After I approve a review, commit, push and open a pull request.

You can always override these default directives in a review comment. For example, when your CLAUDE.md asks to push the changes after approval, comment that the change is fine and should be committed, but not pushed. Your agent should honor the more specific instruction in a review comment over the general one in CLAUDE.md.