Pull Requests

The main review workspace in Baz.

Instead of splitting review work across GitHub tabs, CI , preview deployments, and review tools, Baz brings the entire review flow into a single interface. You can understand the change, inspect implementation details, review comments, validate merge readiness, and approve the PR without leaving the page.

Review Flow

A typical review session in Baz follows a progressive workflow:

Step
Purpose

Walkthrough

Understand what changed and why

File Tree

Navigate impacted areas

Commits

Review incremental updates

Comments

Resolve findings and discussions

Merge Status

Validate merge readiness

The interface is designed around continuous review rather than one-time approval. Baz tracks review state as the pull request evolves so reviewers can focus only on what changed since the last pass.

AI Walkthroughs

When a pull request opens, Baz generates a structured walkthrough of the implementation.

Instead of starting with raw diffs, the walkthrough explains the change in terms of intent, architecture, and impact. This gives reviewers context before they inspect the actual code.

Each walkthrough is divided into implementation sections. For example:

Section
Description

Multi-line selection in diff view

Adds range selection support inside the diff viewer

Comment context

Updates interaction state and comment creation logic

Selection commenting

Handles active ranges and multi-line discussion behavior

Each section links directly to the relevant implementation area in the diff.

This becomes especially useful in large pull requests where understanding the purpose of a change matters more than scanning modified lines sequentially.

Pull Request Overview

The Overview tab acts as the operational summary of the pull request.

Baz surfaces the current review state directly inside the PR:

State
Meaning

Open reviewer comments

Review findings still requiring action

External comments

Comments created outside Baz

Checks passed

CI and validation state

Merge blockers

Missing approvals or unresolved discussions

Instead of manually checking GitHub branch protection rules or CI dashboards, reviewers can immediately see whether the PR is ready to merge.

The File tree tab organizes all modified files hierarchically.

Each file displays:

Signal
Purpose

Added / removed lines

Understand change size

Review indicators

Identify active discussions

Directory grouping

Navigate large changesets faster

This allows reviewers to quickly identify high-impact areas before diving into implementation details.

Files with high churn or concentrated review activity become immediately visible.

Reviewing Commits

The Commits tab focuses on incremental review.

Baz tracks reviewed and unreviewed commits automatically.

During active review cycles, authors often push multiple follow-up commits after feedback. Instead of rereading the entire pull request, reviewers can focus only on changes introduced since the previous review pass.

This makes iterative reviews significantly faster, especially in long-running pull requests.

Managing Review Comments

The Comments tab centralizes all review discussions.

Every finding includes:

Capability
Description

File and line references

Jump directly into implementation

Resolution state

Track open and resolved findings

Fix prompts

Generate implementation guidance

Cursor integration

Send fixes directly into Cursor

Baz is designed to reduce context switching between review and implementation. Reviewers can move directly from a finding to a fix workflow without manually reconstructing the issue.

Merge Status

The Merge status tab aggregates all merge requirements into a single view.

Baz combines:

Merge Signal
Source

CI checks

GitHub Actions and validations

Approval requirements

Repository merge rules

Open review threads

Reviewer discussions

Merge blockers

Outstanding requirements

AI Reviewer Reports

Baz reviewers generate structured reviewer reports directly inside the pull request.

Reviewer reports include:

Component
Description

Requirement validation

What the reviewer verified

Evidence references

Supporting implementation details

File and line mappings

Direct references into code

Findings

Problems identified during review

Severity classification

Priority and impact level

Each finding is actionable and connected directly to the relevant implementation area.

Reviewers can resolve findings, rerun reviewers, copy prompts, or apply fixes directly in Cursor without leaving the PR.

Continuous Review

Baz is optimized for iterative development workflows.

Instead of treating review as a static approval step, Baz continuously tracks:

Review State
Purpose

Unreviewed commits

Detect newly introduced changes

Open reviewer findings

Keep review state actionable

Merge readiness

Track release eligibility

CI progression

Monitor validation state

Reviewer activity

Understand review coverage

Last updated