Skip to content

Agent Review

Agent Review is VibePro's structured review workflow for AI subagents.

The goal is not to ask an agent for generic feedback. The goal is to request a role-specific review, record the agent lifecycle, attach evidence, and make the review result part of PR readiness.

Prepare review requests

bash
vibepro review prepare /path/to/repo \
  --id <story-id> \
  --stage gate

VibePro chooses required roles based on the change risk. You can also request a specific role.

bash
vibepro review prepare /path/to/repo \
  --id <story-id> \
  --stage gate \
  --role security

Start and close agent lifecycle

When using parallel subagents, VibePro expects lifecycle evidence.

bash
vibepro review start /path/to/repo \
  --id <story-id> \
  --stage gate \
  --role <role> \
  --agent-system codex \
  --agent-id <agent-id>

After the subagent finishes, close it before recording the result.

bash
vibepro review close /path/to/repo \
  --id <story-id> \
  --stage gate \
  --role <role> \
  --agent-id <agent-id> \
  --close-reason completed

Record the review result

bash
vibepro review record /path/to/repo \
  --id <story-id> \
  --stage gate \
  --role <role> \
  --status pass \
  --summary "<review summary>" \
  --agent-system codex \
  --execution-mode parallel_subagent \
  --agent-id <agent-id> \
  --agent-closed

Human reviews can be recorded for audit context, but required Agent Review gates expect the configured agent lifecycle evidence.

Check status

bash
vibepro review status /path/to/repo --id <story-id>

If pr prepare still blocks on review evidence, rerun review status and inspect .vibepro/pr/<story-id>/review-cockpit.html.

Released under the Apache-2.0 License.