Skip to content

[HWORKS-3591] Document how an LLM judge decides pass or fail - #717

Merged
gibchikafa merged 7 commits into
logicalclocks:mainfrom
gibchikafa:HWORKS-3591-judge-scoring-docs
Oct 24, 2026
Merged

gibchikafa merged 7 commits into
logicalclocks:mainfrom
gibchikafa:HWORKS-3591-judge-scoring-docs

Conversation

@gibchikafa

Copy link
Copy Markdown
Contributor

The evaluation guide showed judge criteria only through examples with "weight": 1; nothing said what a weight does, what "never below" means in the judge config UI, or when a judged trial passes.

Adds How a judge decides pass or fail under The checks in user_guides/agents/evaluation:

  • weighted average of the per-criterion scores (weights relative, 0 allowed but not all 0)
  • pass_score, defaulting to three quarters of the way up the scale (4 on 1 to 5)
  • floors (critical_min, "never below") fail a trial whatever the average
  • the judge model never sees weights or floors, so a weight does not make it stricter; the description does
  • a missing criterion score makes the trial ungradable, not failed; out-of-range scores are clamped
  • what the trial's score, assertions and reason contain

Matches hopsworks_agents/eval/judges.py and judge_config.py; the same text went into the hops-agent-evals skill (hopsworks-api #1352). Markdownlint clean; the new code block is within 88 columns.

🤖 Generated with Claude Code

gibchikafa and others added 7 commits October 23, 2026 17:10
The evaluation guide showed criterion weights only in examples. Explain the
weighted average, the default pass score, floors ("never below"), that the
judge model never sees weights or floors, and what an ungradable judge means.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ge is not a page of failures

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… on the evaluation job

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ed not be running

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@gibchikafa
gibchikafa merged commit 06cd981 into logicalclocks:main Oct 24, 2026
1 check passed
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.

2 participants