Skip to content

docs(config): document the reviewer / debate / tournament knobs - #317

Open
Jacky628 wants to merge 2 commits into
aiming-lab:mainfrom
Jacky628:docs/document-review-decoupling-knobs
Open

Jacky628 wants to merge 2 commits into
aiming-lab:mainfrom
Jacky628:docs/document-review-decoupling-knobs

Conversation

@Jacky628

@Jacky628 Jacky628 commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Documents the nine reviewer, debate, and tournament settings in config.researchclaw.example.yaml after #316. The scope matches the current Stage 8 wiring; #318 extends the stage coverage separately.

The comments explain tournament precedence, environment overrides, and the actual single-model behavior: a one-model panel still enters the debate engine with all roles assigned to that model. They also clarify that a reviewer model can participate in the panel, so differing from the primary model alone does not establish judge independence.

Validation: parsed the original and updated YAML and confirmed that the configuration values are identical. The reviewer remains unset and debate/tournament remain disabled by default.

Follow-up to aiming-lab#316: opt-in features that aren't advertised tend to stay
unused. Documents the nine settings in the example config, with the
reviewer fields written out explicitly (empty = current behaviour) and
the debate/tournament ones commented out.

Scope is limited to what is actually wired up on main, which is narrower
than the engines can do: debate and the tournament are documented for
Stage 8 only, and there is no reasoning_effort setting. Also records the
non-obvious parts a user cannot infer from field names — that the
tournament takes priority over debate on Stage 8, that a debate panel
needs >= 2 distinct models after deduplication or it silently falls back
to the single-model path, and the four ARC_* env overrides.

Verified by parsing the example config through RCConfig: reviewer_model
empty, debate_enabled and tournament_enabled False — the documented
defaults match what the loader produces.

No code changes. Full suite: 2951 passed, 0 failed, 56 skipped.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Jacky628 added a commit to Jacky628/AutoResearchClaw that referenced this pull request Sep 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant