deliberated-review

Deliberated Code Review

When you need a thorough code review from multiple perspectives, delegate to specialist reviewers, cross-vote, and use gemot to find the crux of any disagreements.

When to Use

• PR review where security, performance, and correctness might conflict
• Architecture decisions where subagents return different recommendations
• Any multi-perspective review where you need to know WHY reviewers disagree, not just THAT they disagree

Process

Step 1: Delegate specialist reviews

Use delegate_task to spawn 3 independent reviewers. Each reviews the same code from their expertise:

delegate_task([
  {"goal": "Review this code for security vulnerabilities. Cite specific lines, explain attack vectors, suggest fixes.", "context": "<the code>"},
  {"goal": "Review this code for reliability and correctness. Cite specific lines, explain what breaks, suggest fixes.", "context": "<the code>"},
  {"goal": "Review this code for performance issues. Cite specific lines, estimate impact, suggest fixes.", "context": "<the code>"}
])

Step 2: Create a gemot deliberation

Call mcp_gemot_deliberation with:

• action: "create"
• topic: a one-line summary of what's being reviewed (e.g., "Payment processing code review")
• template: "review"
• group_id: a consistent identifier for the project or workflow (e.g., "myproject-reviews")

Step 3: Submit each reviewer's findings

For each subagent result, call mcp_gemot_participate with:

• action: "submit_position"
• deliberation_id: from step 2
• agent_id: the reviewer role (e.g., "security-reviewer")
• content: the reviewer's full findings

Step 4: Cross-vote

Call mcp_gemot_participate with action: "get_positions" to fetch all positions. Then have each reviewer vote on the other reviewers' findings:

For each position, each OTHER reviewer calls mcp_gemot_participate with:

• action: "vote"
• deliberation_id: from step 2
• agent_id: the voting reviewer's ID
• position_id: the position being voted on
• value: 1 (agree with this finding), 0 (no opinion), or -1 (disagree)