This prompt is for annotation teams and evaluation engineers who have identified a disagreement between one or more human raters and an LLM judge on a specific scored item. Instead of treating the disagreement as a simple error to discard, this prompt performs a structured reconciliation analysis. It determines whether the gap originated from a judge error, a human rater error, rubric ambiguity, or an edge case in the input. The output includes actionable rubric clarification suggestions and concrete judge instruction patches that can be applied immediately. Use this prompt when you need to diagnose and fix systematic misalignment, not just log disagreement rates.
Prompt
Human Rating Reconciliation Prompt for LLM Judge Tuning

When to Use This Prompt
Diagnose and resolve systematic misalignment between human raters and LLM judges, not just log disagreement rates.
The ideal user is an evaluation lead or senior annotator who understands the scoring rubric deeply and can verify the reconciliation output before applying changes. Required context includes the original input that was scored, the human rater's score and justification, the LLM judge's score and justification, the full scoring rubric, and the current judge instructions. Without all of these inputs, the reconciliation analysis will be speculative rather than diagnostic. The prompt works best on disagreements that recur across multiple items—single anomalies may not justify the analysis cost.
Do not use this prompt for real-time scoring pipelines or high-throughput evaluation where latency is critical. This is a diagnostic and tuning tool, not a replacement for your primary judge. It is also not suitable when the disagreement stems from fundamentally different scoring philosophies that require stakeholder alignment rather than prompt engineering. If your human raters disagree with each other at high rates, fix inter-rater reliability before attempting human-judge reconciliation. For ongoing monitoring, pair this prompt with the Score Drift Detection Prompt and the Judge Instruction Rewriting Prompt to close the loop from detection to repair.
Use Case Fit
Where the Human Rating Reconciliation Prompt delivers value and where it introduces risk. Use these cards to decide whether this prompt belongs in your judge calibration pipeline.
Good Fit: Annotation Team Retrospectives
Use when: your annotation team has completed a rating batch and LLM judge scores show systematic divergence from human consensus. Guardrail: Run reconciliation per batch, not per item, to identify rubric-level fixes rather than overfitting to individual disagreements.
Good Fit: Rubric Ambiguity Diagnosis
Use when: inter-rater reliability among humans is already low, suggesting the rubric itself is the problem. Guardrail: Feed the reconciliation output directly into a rubric revision prompt. Do not retrain judges against noisy human labels without first fixing the rubric.
Bad Fit: Real-Time Scoring Correction
Avoid when: you need instant score adjustment in a production pipeline. This prompt performs analysis, not inline correction. Guardrail: Use the Score Normalization Prompt for runtime adjustment. Reserve this prompt for offline calibration cycles.
Bad Fit: Single-Rater Disputes
Avoid when: only one human rater disagrees with the judge. The prompt is designed for aggregate reconciliation patterns, not individual arbitration. Guardrail: Escalate single-rater disputes to a lead annotator. Run reconciliation only when you have enough disagreement density to detect systematic gaps.
Required Inputs
Must provide: a sample of items with both human ratings and LLM judge scores, the original rubric, and the judge's system prompt. Guardrail: Include at least 20 disagreement examples across score boundaries. Smaller samples produce unreliable root cause attribution.
Operational Risk: Over-Correction to Recent Samples
Risk: the reconciliation prompt may suggest rubric changes that fix recent disagreements but break previously aligned score ranges. Guardrail: Always validate proposed rubric patches against a held-out calibration set before applying them. Track regression risk per dimension.
Copy-Ready Prompt Template
A copy-ready prompt template for reconciling disagreements between human raters and LLM judges, producing actionable root cause analysis and remediation instructions.
This prompt template is designed to be pasted directly into your reconciliation workflow. It instructs the model to analyze a specific disagreement between a human rater and an LLM judge, systematically diagnosing whether the gap stems from judge error, human error, or rubric ambiguity. The output includes concrete suggestions for clarifying the rubric and patching the judge's instructions, making it a critical tool for evaluation platform teams who need to maintain alignment at scale.
textYou are an expert evaluation auditor. Your task is to reconcile a disagreement between a human rater and an LLM judge for a specific evaluation sample. ## INPUT **Evaluation Rubric:** [RUBRIC_DEFINITION] **LLM Judge Instructions:** [JUDGE_INSTRUCTIONS] **Sample to Evaluate:** [SAMPLE_INPUT] **Model Output Being Evaluated:** [MODEL_OUTPUT] **Human Rater Score and Justification:** Score: [HUMAN_SCORE] Justification: [HUMAN_JUSTIFICATION] **LLM Judge Score and Justification:** Score: [JUDGE_SCORE] Justification: [JUDGE_JUSTIFICATION] ## TASK Analyze the disagreement and produce a structured reconciliation report. Your analysis must: 1. Identify the root cause category for the disagreement: "Judge Error", "Human Error", "Rubric Ambiguity", or "Input Edge Case". 2. Extract the specific evidence from both justifications that supports your root cause determination. 3. If rubric ambiguity is detected, propose a concrete clarification to the rubric text. 4. If judge error is detected, propose a specific patch to the judge instructions that would prevent this error in the future. 5. Assign a confidence level (High, Medium, Low) to your root cause determination. ## OUTPUT SCHEMA Return a JSON object with the following structure: { "reconciliation_id": "string", "root_cause_category": "Judge Error" | "Human Error" | "Rubric Ambiguity" | "Input Edge Case", "root_cause_confidence": "High" | "Medium" | "Low", "disagreement_summary": "A one-sentence description of the core disagreement.", "evidence_analysis": { "human_rater_key_points": ["string"], "llm_judge_key_points": ["string"], "divergence_point": "The specific claim or interpretation where the two diverge." }, "rubric_clarification": { "needed": true | false, "original_text": "The ambiguous rubric text, if applicable.", "proposed_revision": "The clarified rubric text, if applicable." }, "judge_instruction_patch": { "needed": true | false, "original_instruction": "The instruction that led to the error, if applicable.", "proposed_patch": "The revised instruction, if applicable.", "rationale": "Why this patch addresses the root cause." }, "recommended_action": "A clear next step for the evaluation team." } ## CONSTRAINTS - Do not assume the LLM judge is always wrong. Human raters make mistakes, and rubrics can be genuinely ambiguous. - Cite specific text from the justifications, rubric, and sample to ground your analysis. - If you cannot determine the root cause with confidence, say so and recommend gathering additional human annotations. - The rubric clarification and judge instruction patch must be actionable and specific. Do not suggest vague improvements like "be more careful."
Adaptation Guidance: Replace all square-bracket placeholders with actual values before sending to the model. The [RUBRIC_DEFINITION] should include the full scoring scale and dimension descriptions. The [JUDGE_INSTRUCTIONS] should be the exact system prompt or instructions given to the LLM judge. For batch reconciliation, iterate over a set of disagreements and aggregate the root_cause_category and recommended_action fields to identify systematic issues. If your evaluation pipeline uses multiple judges, include the judge identifier in the reconciliation_id field for traceability.
Validation and Risk Controls: Before applying any proposed_patch to production judge instructions, run the patched judge against a held-out calibration set to verify that the fix does not regress other scoring dimensions. For high-stakes evaluation pipelines, require a human review of the reconciliation report before accepting the root cause determination. Log all reconciliation outputs with timestamps and judge versions to maintain an audit trail of alignment decisions over time.
Prompt Variables
Required inputs for the Human Rating Reconciliation Prompt. Each variable must be populated before the prompt is assembled and sent to the LLM judge. Missing or malformed inputs are the most common cause of reconciliation failure.
| Placeholder | Purpose | Example | Validation Notes |
|---|---|---|---|
[HUMAN_RATING] | The human annotator's original score and justification for a single evaluation item | {"score": 2, "dimension": "completeness", "justification": "Missing edge case handling in section 3"} | Must be a valid JSON object with score, dimension, and justification fields. Score must match the rubric scale. Reject if justification is empty or under 10 characters. |
[LLM_JUDGE_RATING] | The LLM judge's score and full reasoning output for the same evaluation item | {"score": 4, "dimension": "completeness", "reasoning": "The output covers all required sections including edge cases..."} | Must be a valid JSON object with score, dimension, and reasoning fields. Dimension must match [HUMAN_RATING].dimension exactly. Reject if reasoning is truncated or missing. |
[RUBRIC_DEFINITION] | The full evaluation rubric text that both human and judge were instructed to follow | Completeness (1-5): 1 = Missing critical sections. 3 = Covers main points. 5 = Exhaustive coverage with edge cases. Score 4 if all sections present but edge cases partially addressed. | Must contain scale anchors for each score level. Reject if rubric is under 50 words or lacks explicit per-level descriptors. Ambiguous rubrics cause false reconciliation failures. |
[EVALUATION_INPUT] | The original content or output that both human and judge evaluated | The full text of the model response, document, or output that was scored by both raters. | Must be the exact input both raters saw. Truncation or sanitization invalidates reconciliation. Null allowed only if both raters evaluated the same empty or null input. |
[DIMENSION_NAME] | The specific evaluation dimension being reconciled in this analysis | completeness | Must match the dimension field in both [HUMAN_RATING] and [LLM_JUDGE_RATING]. Case-sensitive. Reject if dimension is not present in [RUBRIC_DEFINITION]. |
[PREVIOUS_RECONCILIATIONS] | Optional array of prior reconciliation outputs for the same judge-human pair to detect patterns | [{"dimension": "accuracy", "gap_root_cause": "judge_error", "resolution": "judge_instruction_patch_applied"}] | Null allowed for first reconciliation. If provided, must be an array of valid reconciliation objects. Used to detect recurring misalignment patterns and prevent redundant patches. |
[CONFIDENCE_THRESHOLD] | Minimum confidence required for the reconciliation to be auto-accepted without human review | 0.85 | Must be a float between 0.0 and 1.0. Values below 0.7 produce unreliable reconciliations. Default to 0.8 if not specified. Lower thresholds increase false root cause attribution risk. |
Implementation Harness Notes
How to wire the reconciliation prompt into an annotation review pipeline with validation, retries, and human-in-the-loop escalation.
The Human Rating Reconciliation Prompt is not a one-shot analysis tool—it is a pipeline component that sits between annotation rounds and judge tuning cycles. The typical integration pattern: after a batch of items receives both human ratings and LLM judge scores, the reconciliation prompt processes each disagreement above a configurable threshold (e.g., score delta > 1 on a 5-point scale). The prompt output feeds directly into rubric revision decisions and judge instruction patches. Wire this into an existing annotation platform by triggering reconciliation runs when inter-rater agreement between human and judge falls below a target threshold, or on a scheduled cadence (weekly for active evaluation pipelines, per-release for CI/CD-gated systems).
Input assembly requires three data sources per reconciliation item: the original content or model output being evaluated, the human rating with annotator ID and optional justification, and the LLM judge score with its full reasoning trace. Package these into the [INPUT] placeholder as a structured JSON block rather than free text to prevent parsing ambiguity. The [RUBRIC] placeholder should contain the exact scoring rubric the judge was instructed to follow, including dimension definitions and score-level descriptions. The [JUDGE_INSTRUCTIONS] placeholder needs the complete system prompt or instruction set the judge received—partial instructions will cause the reconciliation analysis to miss instruction-rooted gaps. Validation layer: before calling the model, validate that all required fields are present, that score values are within the rubric's defined range, and that the human and judge scores actually disagree. If they agree, skip the reconciliation call and log a no-op to avoid wasting inference on aligned ratings.
Model choice and retry strategy: Use a model with strong reasoning capabilities (GPT-4, Claude 3.5 Sonnet, or equivalent) because the task requires multi-hypothesis analysis and structured root cause attribution. Set temperature to 0 or near-zero for deterministic output. Implement a retry wrapper that catches malformed JSON output, missing required fields in the reconciliation schema, or root cause categories outside the allowed enum. Maximum two retries with the error message appended to the prompt as feedback. After two failures, flag the item for human review rather than silently accepting a partial analysis. Logging and audit trail: persist the full reconciliation output alongside the original ratings, the judge's reasoning, and the model's confidence scores. This creates an auditable record for rubric change decisions and helps detect if the reconciliation prompt itself drifts over time.
Human review integration: The reconciliation output includes a requires_human_review flag and a recommended_action field. Route items where recommended_action is escalate_to_annotation_lead or ambiguous_root_cause to a review queue. For items marked rubric_clarification_needed, aggregate them across batches and present to the rubric owner as a prioritized list of ambiguous criteria with suggested wording changes. Downstream automation: when the reconciliation identifies a clear judge instruction gap (root_cause: judge_instruction_error), the suggested_instruction_patch field can feed directly into a judge instruction update workflow—but always require human approval before applying patches to production judges. A single misapplied instruction patch can silently degrade evaluation quality across the entire pipeline. What to avoid: do not use this prompt to automatically override human ratings or judge scores. The reconciliation analysis informs tuning decisions; it does not make them. Do not run reconciliation on fewer than 10 disagreement examples per batch—small samples produce unreliable root cause patterns. Do not skip the validation layer; malformed inputs produce reconciliation outputs that look plausible but attribute errors to the wrong source.
Expected Output Contract
Fields, types, and validation rules for the reconciliation analysis output. Use this contract to parse, validate, and store the LLM judge's reconciliation response before surfacing it to annotation teams or feeding it into judge instruction patches.
| Field or Element | Type or Format | Required | Validation Rule |
|---|---|---|---|
discrepancy_id | string (UUID v4) | Must match regex ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ | |
input_snapshot | object | Must contain | |
human_rating | object | Must contain | |
llm_judge_rating | object | Must contain | |
discrepancy_category | enum string | Must be exactly one of: | |
root_cause_evidence | array of objects | Each element must have | |
reconciliation_confidence | number | Must be a float between 0.0 and 1.0 inclusive; reject if null or outside range; flag for human review if below 0.7 | |
rubric_clarification_suggestion | string or null | If present, must be 20-500 characters; if null, allowed only when discrepancy_category is | |
judge_instruction_patch | string or null | If present, must contain at least one actionable instruction change (detect via keyword check: |
Common Failure Modes
When reconciling human and LLM judge ratings, these failure modes surface first. Each card identifies a specific breakdown pattern and the operational guardrail that prevents it from corrupting your calibration pipeline.
Rubric Ambiguity Masked as Judge Error
What to watch: Disagreements cluster around specific rubric dimensions or score boundaries, but the reconciliation prompt blames the judge. The real root cause is vague scoring criteria that humans and models interpret differently. Guardrail: Before tuning judge instructions, run a rubric clarity audit. Extract all cases where human raters disagree with each other on the same dimension. If inter-human agreement is below 0.7, fix the rubric first—no judge alignment will compensate for ambiguous standards.
Overfitting to Recent Discrepancies
What to watch: Each reconciliation cycle produces judge instruction patches that fix the last batch of disagreements but degrade performance on previously aligned cases. The judge becomes a moving target. Guardrail: Maintain a held-out calibration set that never participates in reconciliation-driven updates. After every instruction patch, run the full regression suite and block deployment if any previously passing dimension drops below threshold. Track a stability score that penalizes instruction churn.
Human Rater Drift Going Undetected
What to watch: The reconciliation prompt assumes human ratings are ground truth, but annotator fatigue, policy updates, or team turnover causes human standards to shift. The prompt treats human drift as judge error and pulls the judge toward a moving target. Guardrail: Run inter-annotator agreement checks per time window and per rater. When human consensus patterns shift significantly, flag a human calibration event before updating judge instructions. Include rater ID as a reconciliation input so the prompt can detect individual rater outliers rather than treating all human disagreement as equivalent.
Edge Case Collapse in Reconciliation Summaries
What to watch: The reconciliation prompt produces generic clarification suggestions that improve average agreement but leave edge cases unresolved. Rare but high-stakes scoring failures persist because they're statistically invisible in aggregate metrics. Guardrail: Stratify reconciliation analysis by difficulty tier and input category. Require the prompt to produce per-stratum recommendations, not just global ones. Set a minimum recall threshold per stratum—if edge-case agreement doesn't improve, escalate for manual rubric revision rather than accepting aggregate gains.
Confidence Without Calibration
What to watch: The reconciliation prompt identifies discrepancies and suggests fixes, but provides no confidence estimate on its own analysis. Teams apply suggested patches without knowing whether the reconciliation itself is reliable. Guardrail: Require the reconciliation prompt to output a confidence level per suggested fix, grounded in evidence density and pattern clarity. When confidence is low, route to human review rather than auto-applying patches. Track whether high-confidence reconciliations actually improve downstream agreement—if not, the prompt's confidence estimation itself needs calibration.
Judge Instruction Patch Accumulation
What to watch: Each reconciliation cycle appends new instructions, exceptions, and clarifications to the judge prompt. Over time, the judge prompt becomes a long, contradictory document where newer patches silently conflict with older ones. Guardrail: Treat judge instructions as versioned artifacts with a maximum length budget. After every reconciliation cycle, run a contradiction detection pass comparing new patches against existing instructions. If contradictions are found, require a full instruction rewrite rather than another patch. Archive old versions with the reconciliation evidence that motivated each change.
Evaluation Rubric
Criteria for testing whether the reconciliation analysis correctly identifies the root cause of human-judge score discrepancies and produces actionable fixes.
| Criterion | Pass Standard | Failure Signal | Test Method |
|---|---|---|---|
Discrepancy classification accuracy | At least 90% of discrepancies are assigned to the correct root cause category (judge error, human error, rubric ambiguity) | Discrepancy attributed to 'judge error' when human label is provably incorrect based on source evidence | Run on a golden set of 50 known discrepancies with verified root causes; measure precision and recall per category |
Evidence extraction completeness | Every root cause claim is backed by at least one direct quote from the judge justification, human rationale, or rubric text | Root cause stated without citation; claim references a rubric dimension that does not exist in the input | Parse output for citation markers; verify each citation exists in the input context using string match |
Rubric clarification actionability | Every suggested rubric clarification can be applied as a diff to the original rubric without introducing ambiguity | Clarification is vague ('be more specific'), contradicts the existing rubric, or removes a necessary constraint | Have a second LLM judge apply the clarification to a held-out batch; measure whether inter-rater agreement improves |
Judge instruction patch validity | Suggested judge instruction patch addresses the specific misalignment pattern and passes regression tests on previously correct cases | Patch causes previously passing cases to fail; patch introduces new scoring bias on a different dimension | Apply the patch to the judge prompt and run against a regression suite of 100 scored examples; require zero regressions |
Human error flagging precision | Human errors are flagged only when there is clear evidence of oversight, fatigue pattern, or inconsistency with the rater's own prior judgments | Human error flagged because judge disagrees, without evidence of human mistake; false positive rate exceeds 10% | Compare flagged human errors against a second independent human review; measure false positive rate |
Ambiguity detection coverage | All rubric dimensions with inter-rater agreement below 0.7 are flagged for ambiguity review | A dimension with known ambiguity from calibration data is not mentioned in the reconciliation output | Inject synthetic rubric dimensions with controlled ambiguity levels; verify detection rate at each level |
Output schema compliance | Output matches the expected JSON schema with all required fields present and correctly typed | Missing required field; field type mismatch; extra fields that violate the schema contract | Validate output against JSON Schema using a programmatic validator; reject on any schema violation |
Confidence calibration | Confidence scores for root cause classifications correlate with actual correctness (Brier score below 0.2) | High confidence assigned to incorrect classifications; confidence always 0.9 regardless of evidence strength | Bin predictions by confidence level; plot calibration curve; compute expected calibration error |
Enabling Efficiency, Speed & Accuracy
Intelligent Analysis, Decision & Execution
We build AI systems for teams that need search across company data, workflow automation across tools, or AI features inside products and internal software.
Talk to Us
Search across company data
Give teams answers from docs, tickets, runbooks, and product data with sources and permissions.
Useful when people spend too long searching or get different answers from different systems.

Automate internal workflows
Use AI to route work, draft outputs, trigger actions, and keep approvals and logs in place.
Useful when repetitive work moves across multiple tools and teams.

Add AI to products and internal tools
Build assistants, guided actions, or decision support into the software your team or customers already use.
Useful when AI needs to be part of the product, not a separate tool.
Adapt This Prompt
How to adapt
Add strict JSON schema validation with retry logic. Include per-discrepancy confidence scores and evidence extraction from both the judge's justification and the human rater's notes. Log reconciliation outputs for drift monitoring. Wire into a calibration feedback loop that triggers judge instruction rewrites when systematic patterns emerge.
Prompt modification
Add [OUTPUT_SCHEMA] with fields: discrepancy_category, root_cause (enum: judge_error, human_error, rubric_ambiguity, input_edge_case), evidence_from_judge, evidence_from_human, confidence, rubric_clarification_suggestion, judge_instruction_patch. Add [CONSTRAINTS]: If confidence < 0.7, flag for human review. Cite specific rubric criteria and rating justifications.
Watch for
- Silent format drift across model versions
- Missing evidence extraction when justifications are sparse
- Overconfident root cause attribution on ambiguous cases
- Reconciliation outputs not feeding back into judge calibration

About the author
Prasad Kumkar
CEO & MD, Inference Systems
Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.
His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.
Partnered with leading AI, data, and software stack.
How We Work
Custom AI workflows for your Business
One-fit-all AI don't work for modern businesses. At Inferensys, we aim to understand your business & custom requirements; which we use to define most efficient agentic workflows, the data, and the tools for your business.
01
Review the use case
We understand the task, the users, and where AI can actually help.
Read more02
Pick the right approach
We define what needs search, automation, or product integration.
Read more03
Build the first useful version
We implement the part that proves the value first.
Read more04
Improve from there
We add the checks and visibility needed to keep it useful.
Read moreThe first call is a practical review of your use case and the right next step.
Talk to Us