This prompt is for evaluation engineers and AI quality teams who need to move beyond binary relevance judgments when ranking evidence. The core job-to-be-done is calibrating a model to score multiple evidence passages against a defined, multi-dimensional rubric—factoring in dimensions like factual precision, query alignment, and source authority—to produce a ranked list suitable for gating downstream answer generation. The ideal user is someone integrating a ranking step into a RAG pipeline or an automated evaluation harness, where the output must be a structured, scored, and justified ranking rather than a simple ordered list.
Prompt
Evidence Ranking with Rubric Prompt Template

When to Use This Prompt
Define the job, reader, and constraints for the Evidence Ranking with Rubric prompt.
Use this prompt when you have a retrieval set that is too large or noisy for direct answer generation, and you need a transparent, auditable method for selecting the strongest evidence. It is particularly effective when your application requires calibrated confidence scores to decide whether to generate an answer, abstain, or escalate for human review. The required context includes the user's query, the set of evidence passages to rank, and a pre-defined scoring rubric with clear dimension descriptions and weightings. Do not use this prompt for simple binary relevance filtering, for real-time ranking where latency is measured in milliseconds, or when the evidence set is so small that a rubric adds unnecessary overhead.
The primary constraint is that the rubric itself must be well-defined before this prompt is used. A vague rubric produces uncalibrated scores that are worse than no ranking at all. Before implementing this prompt, invest time in defining what 'factual precision' or 'source authority' means for your domain, and test the rubric against a golden set of ranked passages to ensure inter-rater consistency. The next step after reading this section is to review the prompt template and adapt the rubric dimensions to match your specific evidence quality standards.
Use Case Fit
Where the Evidence Ranking with Rubric prompt works, where it fails, and the operational conditions required before you put it in production.
Good Fit: Calibrated Evaluation Pipelines
Use when: you need consistent, repeatable evidence scores across many queries for offline eval, regression testing, or LLM-as-a-judge workflows. The rubric enforces inter-rater reliability that ad-hoc ranking cannot. Guardrail: freeze the rubric and calibrate against a human-annotated golden set before trusting automated scores.
Good Fit: Gating Before Answer Generation
Use when: downstream answer generation must only proceed if evidence meets a minimum quality bar. The rubric produces structured scores you can threshold. Guardrail: define explicit pass/fail thresholds per dimension and log every gating decision for audit.
Bad Fit: Real-Time User-Facing Ranking
Avoid when: latency budget is under 500ms or you need to rank hundreds of passages per query. Rubric-based LLM ranking is too slow and expensive for real-time retrieval nodes. Guardrail: use the rubric prompt for offline calibration of a fast cross-encoder or learned ranker, not for online serving.
Bad Fit: Undefined or Shifting Criteria
Avoid when: your team hasn't agreed on what 'good evidence' means or the definition changes per use case without versioning. The rubric will produce scores that look precise but measure the wrong thing. Guardrail: lock the rubric dimensions and anchors before generating any scores, and version the rubric alongside the prompt.
Required Inputs: Structured Evidence and a Defined Rubric
Risk: garbage scores if the prompt receives raw text blobs without passage boundaries or a vague rubric. Guardrail: each evidence passage must have a stable ID and clean text. The rubric must define each dimension, each score level, and anchor examples. Validate input shape before calling the model.
Operational Risk: Score Drift After Model Updates
Risk: a model upgrade changes score distributions silently, breaking downstream thresholds and eval baselines. Guardrail: pin the model version in production, run the rubric prompt against a fixed calibration set after any model change, and alert on distribution shift before scores reach downstream systems.
Copy-Ready Prompt Template
A reusable prompt template that ranks evidence passages against a configurable scoring rubric, producing calibrated scores and rationale for downstream gating decisions.
This template is designed to be dropped directly into your evidence ranking pipeline. It expects a list of evidence passages and a defined scoring rubric with dimensions such as factual precision, query alignment, source authority, and specificity. The model ranks each passage against every rubric dimension, assigns composite scores, and provides concise rationale for each ranking decision. Use this when you need calibrated, explainable evidence rankings that can gate downstream answer generation—not just a flat relevance sort.
textYou are an evidence ranking specialist. Your job is to evaluate each evidence passage against a defined scoring rubric and produce a ranked list with calibrated scores and rationale. ## INPUTS ### Query [QUERY] ### Evidence Passages [EVIDENCE_PASSAGES] ### Scoring Rubric [RUBRIC_DIMENSIONS] ### Output Schema [OUTPUT_SCHEMA] ### Constraints [CONSTRAINTS] ## INSTRUCTIONS 1. For each evidence passage, evaluate it against every rubric dimension independently. 2. Assign a score for each dimension on the scale defined in the rubric. Do not inflate scores when evidence is weak. 3. Compute a composite score using the weighting specified in the rubric. If no weights are provided, weight all dimensions equally. 4. Rank passages from highest to lowest composite score. 5. For each passage, provide a one-sentence rationale explaining the most important factor that determined its rank. 6. If a passage is too vague, off-topic, or contradicts the query's core claim, flag it as [WEAK_EVIDENCE] and place it at the bottom of the ranking with a score of 0. 7. If two passages are near-duplicates, select the more specific or authoritative one and note the duplication in the rationale. 8. If no passage meets the minimum threshold defined in [CONSTRAINTS], return an empty ranking with a note that evidence is insufficient. ## OUTPUT FORMAT Return valid JSON matching the [OUTPUT_SCHEMA] exactly. Do not include commentary outside the JSON structure. ## EXAMPLE Query: "What is the capital of France?" Evidence Passages: - Passage A: "Paris is the capital and largest city of France." - Passage B: "France is a country in Western Europe." Rubric Dimensions: - Factual Precision (0-10): Does the passage contain a directly stated fact that answers the query? - Query Alignment (0-10): How closely does the passage address the specific question asked? - Source Authority (0-10): How authoritative is the source? (Assume equal authority if not specified.) Output: { "ranked_passages": [ { "passage_id": "A", "scores": { "factual_precision": 10, "query_alignment": 10, "source_authority": 5 }, "composite_score": 8.33, "rationale": "Directly states the answer with high precision and perfect query alignment." }, { "passage_id": "B", "scores": { "factual_precision": 0, "query_alignment": 2, "source_authority": 5 }, "composite_score": 2.33, "rationale": "Provides context about France but does not answer the specific question about its capital." } ], "insufficient_evidence": false }
Adaptation guidance: Replace [RUBRIC_DIMENSIONS] with your actual scoring dimensions, scales, and weights. Define [OUTPUT_SCHEMA] as a strict JSON schema that your application validator expects—include field types, required fields, and enum constraints. Set [CONSTRAINTS] to specify minimum score thresholds, maximum passage count, and any domain-specific rules (e.g., "prefer peer-reviewed sources over blog posts"). The [EVIDENCE_PASSAGES] placeholder should receive passages with unique IDs already assigned by your retrieval system. If your use case is high-risk—such as medical, legal, or financial ranking—add a human review step before ranked evidence feeds into answer generation. Test this prompt against known ranking failure modes: position bias (first-passage preference), length bias (longer passages scoring higher), and authority overfitting (ignoring content quality when source metadata is strong). Run the output through a JSON schema validator and retry with error context if validation fails.
Prompt Variables
Required inputs for the Evidence Ranking with Rubric prompt. Each placeholder must be populated before the prompt is sent to the model. Missing or malformed variables are the most common cause of ranking failures in production.
| Placeholder | Purpose | Example | Validation Notes |
|---|---|---|---|
[QUERY] | The question or claim that evidence passages are being ranked against | What is the efficacy of drug X for condition Y in adult populations? | Must be non-empty string. Check for vague queries under 10 words; short queries produce unstable rankings. Null not allowed. |
[PASSAGES] | Array of evidence passages to rank, each with a unique identifier and full text | [{"id":"p1","text":"Study A found..."}, {"id":"p2","text":"Meta-analysis B concluded..."}] | Must be valid JSON array with 2+ objects. Each object requires id (string) and text (string). Empty array triggers abort. Validate JSON parse before prompt assembly. |
[RUBRIC_DIMENSIONS] | Named scoring dimensions with weight and level descriptors for each tier | [{"name":"factual_precision","weight":0.4,"levels":[{"score":5,"description":"Specific data cited"},{"score":1,"description":"Vague claims only"}]}] | Must be valid JSON array with 1+ dimensions. Each dimension requires name, weight (0-1), and levels array with score and description. Sum of weights should equal 1.0; warn if not. |
[OUTPUT_SCHEMA] | Expected JSON structure for ranked output including fields for passage id, scores per dimension, total score, and rank position | {"ranked_passages":[{"id":"p1","scores":{"factual_precision":4,"query_alignment":5},"total":4.5,"rank":1}]} | Must be valid JSON schema or example structure. Validate that schema includes id, per-dimension scores, total, and rank fields. Schema mismatch with rubric dimensions causes scoring gaps. |
[MAX_PASSAGES] | Maximum number of passages to include in the final ranked output | 5 | Must be positive integer. If null or missing, default to all passages. Values exceeding passage count produce warning but not error. Values below 1 trigger abort. |
[SCORE_THRESHOLD] | Minimum total score for a passage to be included in the ranked output; passages below this are excluded with reason | 2.5 | Must be float between rubric minimum and maximum possible score. If null, no threshold filtering applied. Threshold above max possible score produces empty output; warn before execution. |
[SOURCE_METADATA] | Optional metadata for each passage including publication date, author, domain, and authority signals | {"p1":{"date":"2024-03","author_type":"peer-reviewed","domain":"medicine"}} | Optional. If provided, must be valid JSON object keyed by passage id. Missing metadata for a passage is allowed but reduces authority dimension scoring accuracy. Null allowed. |
[CONSTRAINTS] | Behavioral rules for the ranking process such as tie-breaking logic, diversity requirements, or temporal decay parameters | Break ties by prioritizing higher factual_precision score. Exclude passages older than 5 years for time-sensitive queries. | Must be non-empty string or null. Vague constraints produce inconsistent ranking behavior. Test with known tie cases to verify constraint is applied. Null allowed when no special constraints needed. |
Common Failure Modes
Evidence ranking with a rubric is powerful but brittle. These are the most common failure modes when scoring passages against defined dimensions—and how to catch them before they corrupt downstream answer generation.
Rubric Drift and Score Inflation
What to watch: The model gradually shifts its interpretation of rubric dimensions over a batch, inflating scores for mediocre passages or applying criteria inconsistently. This is especially common with long retrieval sets where the model loses calibration. Guardrail: Anchor the rubric with a calibration example at the start of every batch—include a scored passage with explicit rationale. Run a holdout set of pre-scored passages through the prompt and flag when mean scores drift by more than 0.5 on any dimension.
Position Bias in Passage Ordering
What to watch: Passages at the beginning or end of the retrieval set receive systematically higher or lower scores regardless of content quality. The model overweights first-seen evidence or loses attention for mid-list passages. Guardrail: Randomize passage order before scoring and run the ranking twice with different shuffles. Flag passages where the score delta between runs exceeds your threshold. If position bias is persistent, split large sets into smaller scoring batches.
Length Confounding with Specificity Scores
What to watch: Longer passages receive inflated specificity or factual precision scores simply because they contain more tokens, not because they contain more relevant evidence. The rubric dimension for specificity becomes a proxy for verbosity. Guardrail: Add an explicit instruction in the rubric that specificity is measured per relevant claim, not per token. Test by inserting a long but irrelevant passage into a calibration set—if it scores above threshold on specificity, the rubric needs tightening.
Authority Overfitting on Domain Signals
What to watch: The model overweights surface authority signals like domain name, publication venue, or author title while ignoring content quality. A prestigious source with a tangentially relevant passage outranks a less-known source with directly supporting evidence. Guardrail: Separate authority into its own rubric dimension with a capped weight. Test with a pair where the high-authority passage is clearly less relevant—if authority still drives the final ranking, reduce its weight or add a relevance-gating rule before authority is considered.
Query Misalignment Under Semantic Drift
What to watch: The model scores passages against a semantically drifted interpretation of the query rather than the literal query intent. This is common with ambiguous or multi-faceted queries where the model latches onto one interpretation and downranks evidence for other facets. Guardrail: Include the original query verbatim in the scoring prompt and add a query-alignment dimension that requires the model to quote the specific query terms the passage addresses. For multi-facet queries, decompose before ranking and score each facet separately.
Score Compression and Indistinguishable Tiers
What to watch: All passages cluster into a narrow score band—typically 3.5 to 4.2 on a 5-point scale—making downstream gating impossible. The model avoids extreme scores and produces rankings with no practical differentiation between strong and weak evidence. Guardrail: Require forced distribution in the prompt: at least one passage must score below 2 and at least one above 4 on each dimension. Use tier labels (strong/moderate/weak/insufficient) alongside numeric scores and validate that all tiers appear in the output before accepting the ranking.
Evaluation Rubric
Use this rubric to evaluate the quality of ranked evidence outputs before integrating them into a downstream answer generation pipeline. Each criterion maps to a pass standard, a failure signal, and a test method that can be automated in an eval harness.
| Criterion | Pass Standard | Failure Signal | Test Method |
|---|---|---|---|
Schema Compliance | Output is valid JSON matching the [OUTPUT_SCHEMA] exactly; all required fields present and correctly typed. | JSON parse error, missing required fields, or incorrect data types. | Schema validation check using a JSON Schema validator against the expected contract. |
Score Calibration | Assigned scores for each passage fall within the defined [SCORE_RANGE] and correlate with the provided [RUBRIC_DIMENSIONS]. | Scores outside the allowed range, uniform scores for all passages, or scores inverted relative to rubric criteria. | Boundary check on score values and correlation test against a golden set of human-annotated rankings. |
Ranking Stability | Re-running the prompt with the same input and a different random seed produces a Kendall Tau correlation >= [STABILITY_THRESHOLD] between the two ranked lists. | Wildly different orderings across runs, especially for top-K passages. | Run prompt N times with different seeds, compute pairwise rank correlation, and flag if below threshold. |
Rationale Grounding | Every ranking rationale references specific content from the [PASSAGE_TEXT] and the [RUBRIC_DIMENSIONS], not generic statements. | Rationales contain only generic praise like 'highly relevant' without quoting or referencing the passage. | LLM-as-judge check: prompt a second model to verify if the rationale contains a specific, verifiable reference to the source text. |
Position Bias Resistance | The ranking order is not strongly correlated (Spearman's rho < [BIAS_THRESHOLD]) with the original input order of passages. | The output ranking closely mirrors the input order, indicating the model ignored content and defaulted to position. | Shuffle the input passage order and re-rank. Measure correlation between original and shuffled output rankings. |
Length Bias Resistance | Longer passages are not systematically ranked higher; passage length and rank have a Pearson correlation < [LENGTH_BIAS_THRESHOLD]. | A clear positive correlation between the character count of a passage and its assigned rank. | Compute the Pearson correlation coefficient between passage length and assigned rank across a test set of varied passage lengths. |
Conflict Annotation Accuracy | If [CONTRADICTION_DETECTION] is enabled, any pair of passages with a contradiction score > [CONFLICT_THRESHOLD] is flagged in the output. | Two passages with directly opposing factual claims are ranked highly without any conflict annotation. | Inject a known contradictory passage pair into the input set and assert the conflict flag is present in the output. |
Coverage Gap Flagging | If [COVERAGE_CHECK] is enabled and a required sub-topic from [QUERY_DECOMPOSITION] has no passage with a relevance score > [COVERAGE_THRESHOLD], a gap is reported. | All sub-topics are marked as covered despite one having no supporting evidence above the threshold. | Provide a query with a known missing sub-topic. Assert the output's coverage report flags the specific gap. |
Implementation Harness Notes
How to wire the Evidence Ranking with Rubric prompt into a production RAG pipeline with validation, retries, and gating.
This prompt is designed to sit between your retrieval system and your answer generation step. It takes a set of retrieved passages and a defined scoring rubric, then returns calibrated scores and rankings. The implementation harness must treat this prompt as a deterministic quality gate, not a best-effort suggestion. If the top-ranked passage falls below a minimum score threshold, the system should refuse to generate an answer and instead request better evidence or inform the user that the query cannot be grounded.
Wire the prompt into your application as a synchronous pre-generation step. After retrieval returns N passages, assemble the prompt with the rubric dimensions, the query, and the passage set. Send the request to a model capable of structured output (e.g., GPT-4o with response_format or Claude with tool use for JSON). Validate the output before proceeding: confirm that every passage ID in the ranking exists in the input set, that scores fall within the defined rubric range, and that the ranking is non-empty. If validation fails, retry once with a stricter output contract. If the retry also fails, log the failure, fall back to a simpler relevance-only ranking, and flag the incident for review.
For high-stakes domains such as healthcare, legal, or finance, insert a human review step when the top-ranked evidence score is below the HIGH confidence tier or when multiple passages receive identical top scores. The harness should surface the ranked list, the rubric scores, and the original passages to a review queue. Do not auto-generate an answer from low-confidence evidence. Additionally, log every ranking request and response—including the prompt version, model, rubric used, scores, and any validation failures—so that ranking quality can be audited and regressions detected across prompt changes.
Model choice matters here. Use a model with strong instruction-following and structured output support. Avoid models that exhibit position bias (favoring first or last passages) without mitigation; randomize passage order in the prompt to reduce this effect. If your latency budget is tight, consider running this prompt on a smaller, fine-tuned model that has been trained on your rubric and ranking preferences. The rubric itself should be version-controlled alongside the prompt template, and any change to the rubric dimensions or scoring scale should trigger a regression test against a golden ranking dataset before deployment.
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
Use the base rubric template with a single model call. Define 3–5 scoring dimensions inline. Accept plain-text ranked output without strict schema enforcement.
code[SCORING_DIMENSIONS]: - Factual Precision: Does the passage contain verifiable facts? - Query Alignment: How directly does it address [QUERY]? - Source Authority: Is the source credible for this domain? Score each passage 1–5 per dimension. Return ranked list.
Watch for
- Score inflation when dimensions are vague
- Inconsistent calibration across passages
- No validation of output format before downstream use

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