PR Reviews

A GitHub PR is a review task. The worker behavior is fundamentally different from an issue worker — review workers read and report. They don't touch anything. This is why PRs have their own work type and their own config key ([launch] review).

Dispatch a review

Through your orchestrator, or directly:

wtmag create --github 234 -t pr

WTmag fetches the PR, sets up a review worktree, and starts the agent. The worker reads the diff and relevant context, then reports back.

What the worker won't do

Review workers are read-only by design. The prompt tells the agent:

• Don't edit files
• Don't commit or push
• Don't approve or merge
• Don't change labels, comments, or review state

If the agent finds a problem, it describes the fix instead of making it. The point is to get a review you can act on, not a modification you have to check.

What a good review looks like

Useful output is concrete. For each finding:

• Severity
• File and line
• What's wrong
• Why it matters
• Smallest fix that would work

If nothing's wrong, the worker should say so and note any testing gaps.

Placement

Reviews have their own placement config. The generated default is window, same as implementation work. If you want reviews to open as dedicated sessions by default, set it in config:

[launch]
review = "session"

Or force it per run:

wtmag create --github 234 -t pr -s

Windows require being inside tmux already.