## Social Studies Article Overlay

Use this overlay for Social Studies domains (history, geography, economics, civics).

Focus on historical significance, cause-and-effect, and synthesis/reflection quality.

---

### overall (continuous: 0.0-1.0)

**INTEGRITY OVERRIDE:** If `integrity_check = 0.0`, overall MUST be 0.0.

Let **C** = count of CRITICAL metrics with score 0.0:
- `factual_accuracy`, `educational_accuracy`, `curriculum_alignment`

Let **N** = count of NON-CRITICAL metrics with score 0.0:
- `teaching_quality`, `historical_significance`, `cause_and_effect_clarity`, `reflection_quality`, `stimulus_quality`, `diction_and_sentence_structure`, `localization_quality`

Use only these ranges:

| C | N | Overall Range |
|---|---|---------------|
| 3 | any | 0.0 - 0.50 |
| 2 | any | 0.0 - 0.65 |
| 1 | 0-2 | 0.70 - 0.84 |
| 1 | 3+ | 0.55 - 0.75 |
| 0 | 0 | 0.85 - 1.0 |
| 0 | 1-2 | 0.75 - 0.84 |
| 0 | 3+ | 0.65 - 0.80 |

---

### historical_significance (binary: 0.0 or 1.0)

Whether the article explains why events/developments are important in broader historical context.

Fail when content is purely descriptive without meaningfully answering "why this matters."

### cause_and_effect_clarity (binary: 0.0 or 1.0)

Whether causal links are explicit, coherent, and logically explained.

Fail when cause/effect chains are unclear, unsupported, or conflated.

### reflection_quality (binary: 0.0 or 1.0)

Whether the ending synthesis/reflection section draws thematic connections instead of repeating prior statements.

Fail when reflection is absent, superficial, or purely repetitive.

---

## SOCIAL STUDIES METRIC ASSIGNMENT RULES

Assign each issue to exactly one primary metric:
- factual historical errors -> `factual_accuracy`
- fails to teach intended historical concept -> `educational_accuracy`
- standards/boundary violations -> `curriculum_alignment` (critical in SS)
- weak pedagogical sequence/explanation -> `teaching_quality`
- no "why it matters" framing -> `historical_significance`
- unclear causality chains -> `cause_and_effect_clarity`
- weak/no synthesis reflection -> `reflection_quality`
- harmful stimulus (wrong, misleading, or contradictory visual, map, or embedded text/primary source) -> `stimulus_quality`
- language clarity issues -> `diction_and_sentence_structure`
- cultural/sensitivity issues -> `localization_quality`

---

## Output Format

Return JSON in this structure:

```json
{
  "content_type": "article",
  "overall": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "factual_accuracy": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "educational_accuracy": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "curriculum_alignment": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "teaching_quality": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "historical_significance": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "cause_and_effect_clarity": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "reflection_quality": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "stimulus_quality": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "diction_and_sentence_structure": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "integrity_check": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "localization_quality": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null }
}
```
