> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Math Alignment
> Reference documentation for the Math Alignment evaluator.
export const PiiWarning = () => {
return
Inputs must be de-identified. Do not submit students' Personally
Identifiable Information (PII) or any regulated or sensitive personal
information.
;
};
[Evaluator last updated June 30, 2026.](#evaluator-release-history)
## Overview
The Math Alignment evaluator checks a math question against a standard's individual [learning components](/knowledge-graph/schema-reference/learning-components) — not just against the standard's label.
It reports which of a standard's components the question actually measures.
The Math Alignment evaluator judges whether a question is the *right math* for
a standard. The Math Visual Correctness evaluator (coming soon) judges whether
a math visual is *mathematically correct*.
## At a glance
| | |
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------- |
| **Input type** | Math assessment question |
| **Supported subject** | Math only |
| **Supported grades** | K–12 |
| **Jurisdictions** | Multi-State / Common Core State Standards (CCSS), all 50 states, plus DC |
The evaluator was built and validated using the model and temperature below (other configurations will produce different results and may have lower accuracy):
| | |
| :-------------- | :------------------------ |
| **Model used** | claude-haiku-4-5-20251001 |
| **Temperature** | 0 (fixed) |
## Getting started
Follow the [Quickstart](/evaluators/getting-started/quickstart) to start using this evaluator:
| Access method | |
| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Evaluators Playground** | [View in the Learning Commons Platform](https://platform.learningcommons.org/apps/evaluators/playground) ↗ |
| **Python notebook** | [View in GitHub](https://github.com/learning-commons-org/evaluators/blob/main/evals/standards/math-question-alignment/example_notebook.ipynb) ↗ |
| **Prompts** | View in GitHub: [`system.txt`](https://github.com/learning-commons-org/evaluators/blob/main/evals/standards/math-question-alignment/system.txt) ↗, [`user.txt`](https://github.com/learning-commons-org/evaluators/blob/main/evals/standards/math-question-alignment/user.txt) ↗, and [`coarse-filter-user.txt`](https://github.com/learning-commons-org/evaluators/blob/main/evals/standards/math-question-alignment/coarse-filter-user.txt) ↗ |
## Inputs
| Input | Description | Required |
| :---------------- | :-------------------------------------------------------------------------------------- | :------- |
| **Math question** | Full assessment prompt/instructions students see, K–12 math | Yes |
| **Jurisdiction** | Multi-State / CCSS, a state, or DC | Yes |
| **Standard(s)** | One or more standard codes from the selected jurisdiction | Yes |
| **Grade** | Filters the standards list | No |
| **Coarse filter** | Pre-screens relevance before full evaluation, useful at scale | No |
The evaluator supports 3 modes:
| Mode | Description |
| :---------------------- | :-------------------------------------------------------------------------------------------------------- |
| **Single check** | One question against one standard |
| **Batch evaluation** | Set of question-standard pairs (e.g. tagging validation), run as a full question × standard cross-product |
| **By-grade evaluation** | Question bank against every standard for a grade, for whole-grade coverage analysis |
Use **Batch** and **By-grade evaluation** to surface which standards (and
which learning components) are fully, partially, or not covered by a given
question bank.
## Output
The evaluator reduces alignment to a binary judgment (plus rationale) per learning component, and is not validated for grading, assessment, or placement decisions.
Treat outputs as directional signals, and keep a human in the loop – especially for borderline cases.
| Field | Description |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Statement code** | Academic standard evaluated |
| **Learning components** | List of the academic standard's learning components
Each learning component includes:- Description: Description for each learning component
- Reasoning: What each learning component requires, what the question asks, and why that is or is not aligned
- Aligned: Whether each learning component and the question are aligned on the standard
- Feedback: Revision guidance (when not aligned) or brief confirmation (when aligned) for each learning component
|
| **Aligned count** | Number of learning components the question aligns to |
| **Total count** | Total number of learning components for the standard |
| **Coarse filtered** | Whether the standard was excluded by the coarse filter (Batch and By-grade evaluation modes only) |
## Interpreting results
The evaluator assesses standards alignment based on how many of a standard's learning components a question meets (i.e., **Aligned count** / **Total count**).
Users should interpret the counts while keeping in mind the learning components a question was meant to target. An **Aligned count** of 2 out of a **Total count** of 5 is ambiguous information on its own. If those 2 **Aligned count** learning components include the ones a question was meant to target, you can conclude the question is aligned. Otherwise, you can conclude the question is not aligned.
**Example**: A question that asks students to find the area of a rectangle by
multiplying its sides' lengths is commonly tagged to Common Core 3.MD.C.7.
However, that question meets only one of the 4 learning components that make up
that standard.
At the parent-code level the question looks aligned; at the learning-component
level, it covers a quarter of the standard.
## Evaluator release history
| Date | Changes |
| ------------- | ------------- |
| June 30, 2026 | First release |