docs: remove review judges handoff · Entire

docs: remove review judges handoff

Sessions

d4e3cdad151aView transcript

Changes

1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168

Handoff — entire review + Judge Panel

Last updated: 2026-06-14 · branch review-profiles @ ead8c12dc

TL;DR

entire review is the evolved multi-agent code-review command. A profile runs a crew of reviewers (parallel review agents) and then a panel of judges that render the verdict; with ≥2 judges a chair merges them. The command, profiles, guided setup, scripted config, --list, and the judge panel are implemented, building, and green. The Pi-specific work lives in a separate stacked PR (#1313) that now needs another rebase.

Terminology (final)

Command surface

entire review                # interactive: profile chooser. non-interactive: list + error (never silent default)
entire review <profile>      # run a named profile
entire review --list         # list profiles (reviewers + judges, default marked)
entire review --configure    # interactive wizard; non-interactive discovery view
entire review --configure --profile P \
  --set-agents claude-code,codex \      # reviewers (simple)
  --set-slot claude-code=opus --set-slot codex \   # reviewer slots (dupes ok)
  --set-judge claude-code=opus --set-judge codex=gpt-5 \  # judges (repeatable; >1 = panel)
  --set-chair claude-code=opus \        # chair for a panel
  --set-model codex=gpt-5-codex --set-task "..."
entire review --edit         # advanced skill picker
entire review --agent N      # run one reviewer
entire review --agent N --model M
entire review --agents       # list reviewers (valid --agent values)
entire review --models [--agent N]
entire review --prompt "..." # one-off instructions
entire review --findings     # browse local findings
entire attach --review <id>   # post-hoc tag a session (the old `review attach` was removed)

Settings schema (review_profiles)

{
"review_default_profile": "general",
"review_profiles": {
    "general": {
      "task": "Review this change for correctness, regressions, tests, and maintainability.",
      "agents": { "claude-code": {"skills": ["/review"]}, "codex": {"skills": ["/review"]} },
      "judges": [{"agent": "claude-code", "model": "opus"}]
    },
    "security": {
      "task": "...",
      "agents": { "claude-sonnet": {"agent": "claude-code", "model": "sonnet"}, "codex": {"model": "gpt-5-codex"} },
      "judges": [{"agent": "claude-code", "model": "opus"}, {"agent": "codex", "model": "gpt-5"}],
      "chair": "claude-code:opus"
    }
}
}

Back-compat: legacy master (an reviewer id) and master_agent / master_model are still honored as a single judge when judges is empty. New configs write judges/chair.

How the judge panel works

Done

Pending / next steps

  1. Rebase PR #1313 (review-pi-reviewer) onto origin/review-profiles (ead8c12dc). It is behind again after the judge-panel + merge + doc commits.
    • PR: https://github.com/entireio/cli/pull/1313 (base review-profiles, head review-pi-reviewer)
    • Contains: Pi review-runner adapter, Pi live model list (pi --list-models), Pi generate/text-gen. The Pi adapter is the obvious first panel-capable text-gen judge to validate the panel end-to-end with a real second judge.
  2. Consider validating scripted --set-judge agents at config time (currently only validated at runtime, where failures are dropped). Intentional for now; revisit if users hit silent typos.
  3. Optional: include the profile task / scope context in composeChairPrompt (today the chair reconciles verdicts only).
  4. Optional: bound judge-panel concurrency if panels ever grow large (currently unbounded; fine for 2–3 judges).

Key files

Verify

go build ./...
go test ./...                 # expect 72 ok, 0 fail
golangci-lint run ./cmd/entire/cli/review/... ./cmd/entire/cli/ ./cmd/entire/cli/settings/...  
go run ./cmd/entire review --list
go run ./cmd/entire review --help

Gotchas