awesomechecklists
llms.txtGitHub ↗
/

11 — AI Model Selection and Benchmarking Checklist#

Choose AI models against the actual application workload, operating constraints, safety requirements, and measurable outcomes. Public leaderboards help identify candidates but do not prove suitability, compliance, or reliability for a particular deployment.

Scope: Backend / API-specific. This file is one part of the 11_AI_Model_Selection_and_Benchmarking.md checklist. Apply the domain-wide release gate across all applicable scope files; each checklist ID remains unique.

Review details#

  • Project / product:
  • Release / version / environment:
  • Scope and applicable jurisdictions / markets:
  • Intended task / affected users / impact level:
  • Candidate models, providers, and exact versions:
  • Benchmark datasets, scoring framework, and review owner:
  • Cost, latency, privacy, safety, and quality budgets:
  • Reviewer / owner:
  • Review date:
  • Decision: Pending / Approved / Approved with documented exceptions / Blocked

How to use#

  1. Copy the shared template to project-specific evaluation records; keep all repository checkboxes unchecked.
  2. Establish requirements, disqualifying risks, and acceptance thresholds before comparing model scores. Mark [x] only when verified through model documentation, reproducible benchmark results, human evaluation, provider review, or representative application tests.
  3. Record evidence, failures, candidate exclusions, accepted risks, and justified N/A outside this shared template, keyed by MODELS ID. Do not add evidence tables or real customer data to the repository.
  4. Compare candidates under equivalent workloads and document version, benchmark data, prompts, sampling, scoring, hosting, and resource settings. Adjust for measurable differences in real API/application behavior.
  5. Complete ## API Checks and ## Frontend Checks where those interfaces exist. For non-interactive, offline, or non-API deployments, document what does not apply in project records.
  6. Route deeper prompt, RAG, agent, red-team, fine-tuning, monitoring, model-card, and inference reviews to the dedicated AI files. Re-run selection when models, tasks, providers, risk profiles, prices, or serving conditions materially change.

API Checks#

  • MODELS-095 Confirm the selected model supports the API's required input modalities, message roles, schemas, and response modes.
  • MODELS-096 Validate context budgeting and truncation behavior against the application’s actual request distributions.
  • MODELS-097 Check that model aliases or routing configurations resolve to approved revisions and detect unauthorized silent substitutions.
  • MODELS-098 Test structured output and function-call schemas against the real provider endpoint and production-equivalent configuration.
  • MODELS-099 Measure p50, p95, and p99 request latency and error rates under realistic API concurrency and quota conditions.
  • MODELS-100 Measure time-to-first-token and streaming completion behavior where clients use streaming.
  • MODELS-101 Check rate-limit, timeout, backoff, idempotency, and retry behavior without allowing runaway cost or duplicate actions.
  • MODELS-102 Validate token usage and other metered inference charges against provider responses or approved estimates.
  • MODELS-103 Ensure inference input, stored prompts, and response logs honor provider and internal retention/data-use restrictions.
  • MODELS-104 Check provider authentication, deployment regions, permissions, and customer-data isolation for the chosen model.
  • MODELS-105 Benchmark actual API request/response payloads, including system instructions, retrieved context, and tool results as applicable.
  • MODELS-106 Ensure benchmark harnesses distinguish model refusals, safety blocks, malformed outputs, and transport errors.
  • MODELS-107 Test provider interruptions, regional failures, and the documented fallback or degraded-mode response.
  • MODELS-108 Monitor model revision, quality signals, rate limits, latency, refusals, token usage, and cost by approved service dimensions.
  • MODELS-109 Validate any fallback or model route preserves safety filters, tool permissions, and supported API output contracts.
  • MODELS-110 Confirm API responses expose suitable error, abstention, and incomplete-result states rather than silently returning unverified content as fact.
  • MODELS-111 Ensure evaluation and monitoring data sent to vendors or external judges is authorized and appropriately sanitized.
  • MODELS-112 Test output-format compatibility of the selected model with persisted responses, cached results, and supported consumer versions.
  • MODELS-113 Confirm external tool actions are validated and authorized independently of the model selected.
  • MODELS-114 Record the model identifier, evaluation version, and review owner alongside the API release decision.

Release gate#

  • Intended use, stakeholder impact, mandatory capabilities, and measurable quality/safety, latency, cost, and data-handling requirements are approved.
  • A relevant baseline and candidate shortlist were tested on representative and held-out workloads using documented, reproducible evaluation settings.
  • Task quality, severe failure rates, robustness, relevant group/language performance, and uncertainty meet predeclared acceptance rules or have approved mitigations.
  • Realistic serving measurements show acceptable latency, throughput, availability, resource use, and cost per successful user task.
  • Provider terms, model licenses, data residency/retention, model-version controls, and safety/authorization constraints are reviewed for intended use.
  • API and frontend application behavior is verified where applicable, including schema adherence, refusals, fallbacks, error states, and user-facing comprehension.
  • Decision makers have reviewed limitations, disqualifying risks, supporting evidence, alternatives, and a rollback/re-evaluation plan.
  • A named approver has accepted the exact model/provider/configuration decision and recorded any residual risks, owners, and trigger for renewed assessment.

Domain-specific approval rule: Block model selection when a critical task or safety threshold is missed, validation data is compromised, material license or data-handling constraints are unresolved, or latency/cost at required capacity is not viable without accepted mitigation. A high public benchmark ranking alone cannot override an unsafe or unfit result.

Trusted references and scope#

These primary framework, benchmark, and tool-maintainer sources inform the review questions. They are not proof that any specific model is suitable or that the product is certified by a standards body.

Applicability: NIST AI RMF material is voluntary guidance and the framework was under revision at the source review. HELM entered maintenance mode in June 2026. MLPerf measures defined hardware/software inference scenarios, not arbitrary end-user task quality. Benchmark harnesses and model/dataset cards require independent review of actual model versions, prompt templates, evaluation rights, and workload relevance. The listed proprietary platform documentation applies only when using those platforms; model/provider pricing and capabilities may change without advance notice.

Source review date: 2026-11-12.

Suggested testing tools#

Choose tools appropriate to the project's stack and risks; automation supports evidence but does not approve the checklist.

  • Test focus: candidate models with identical datasets, metrics, latency, and safety thresholds; include API and service behavior where applicable.
  • Cross-stack: lm-evaluation-harness + MLPerf.
  • Python: Hugging Face Evaluate + pytest; for pytest-based suites, run python -m pytest -q.
  • TypeScript: promptfoo + Vitest; for Vitest-based suites, run npx vitest run (or npx playwright test for E2E).
  • JavaScript: promptfoo + Jest; for Jest-based suites, run npx jest --ci (or npx playwright test for E2E).
  • Evidence: Save tool versions, configuration, test environment, fixtures, results, and links in project-specific review records using the existing checklist IDs. Expert review remains necessary where relevant.

Suggested AI skills for verification#

These are optional agent review aids, not automated passes or release approval. Each linked repository had at least 1,000 GitHub stars when checked on 2026-11-12; counts are per repository, not per skill, and do not indicate security or correctness.

  • eval-harness-first — Verify benchmark design before selection (wshobson/agents, 42,437 repo stars).
  • llm-evaluation — Compare held-out and safety evaluation criteria (wshobson/agents, 42,437 repo stars).
  • agentic-eval — Review repeatability, baselines, and regression gating (github/awesome-copilot, 41,073 repo stars).

How to check: In a project-specific copy, have the agent audit the backend / API scope and map findings to this file's existing checklist IDs, with code/configuration references, reproducible test results, failed or inapplicable cases, and uncertainties. Independently verify findings; keep shared template boxes unchecked and retain human approval requirements.

Before use: Read the skill's SKILL.md, referenced scripts, license, and requested tool permissions. Only execute vetted skills with appropriate access in a controlled environment.

Important warning: reference only#

⚠️ Reference only — not a definitive or exhaustive checklist. This template is a starting point for review, not the ultimate authority or a guarantee of project safety, quality, regulatory compliance, accessibility, security, or launch readiness.

Use project-specific judgment and independent verification. Requirements and risks evolve and differ by project, technology, and jurisdiction. Adapt the checks, consult current authoritative sources, perform relevant tests, and obtain qualified specialist review or approval when appropriate. Checking every box does not replace these steps.