BuildBetter Docs

prs

The PRs tab surfaces open GitHub PRs that need human review. It's most useful for catching the case where automated reviewers (Codex, bots) have signed off but no human has looked yet — the "only Codex has reviewed" pattern.

Info: This tab is gated by the pr_triage_real feature flag. If you don't see it, contact your workspace admin.

The List

Each row shows:

Filter Bar

Above the list:

Plan Detection

When a PR is loaded, the system scans its diff for files matching /plan/i — markdown plan docs, design specs, RFCs. Detected files appear in the row and feed the Has plan {N} filter.

Plan detection runs in batches of 50 visible unscanned PRs on tab open, so the first few seconds may show "—" before counts populate.

The Detail Pane

Click a PR to open its detail. You'll see:

Actions

Bulk Promote

Select multiple eligible PRs (those with a conversationId and not already linked to a confirmed project), then click Promote N. The system runs a bounded-concurrency queue (max 3 parallel) to:

  1. Fetch each PR from GitHub
  2. Detect plan files
  3. Create a tracked item with the PR attached
  4. Return success or failure per PR

A toast reports the result — "Moved N PRs to projects" — and breaks down any errors per PR.

Tip: The Only Codex reviewed filter is the single highest-leverage view in Triage for engineering teams. It surfaces the exact PRs where a human hasn't weighed in yet — a fast safety net for code that's been auto-approved.