## Direct Instruction Article Overlay (Default)

Use this overlay for general instructional articles where direct instruction style is expected.

## INTERPRETING STRUCTURE AND UI CUES

When content includes cues that indicate hidden/revealed behavior, assume proper UI behavior honors those cues.

**Cues indicating hidden/revealed content:**
- "Click to show answer", "Tap to reveal", "Show solution", "Click to see hint"
- JSON/markup fields like `"hidden": true`, `"reveal_on_click": true`, `"explanation_after_submission": true`
- Structural patterns where answers/explanations follow a reveal cue
- Field names/tags such as `hint`, `feedback`, `on_demand`, `solution`, `rationale`

**Display timing categories:**
1. Pre-attempt (always visible): evaluate for giveaways
2. On-demand (user requested): never a giveaway
3. Post-error (after incorrect response): never a giveaway
4. Post-attempt (after submission): never a giveaway

---

### 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`

Let **N** = count of NON-CRITICAL metrics with score 0.0:
- `curriculum_alignment`, `teaching_quality`, `worked_examples`, `practice_problems`, `follows_direct_instruction`, `stimulus_quality`, `diction_and_sentence_structure`, `localization_quality`

Use only these ranges:

| C | N | Overall Range |
|---|---|---------------|
| 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 |

Choose lower half for severe/multiple issues; upper half for minor isolated failures.

---

### worked_examples (binary: 0.0 or 1.0)

Worked examples are teacher-modeled examples where process + answer are demonstrated.

Pass when examples are present (when appropriate), accurate, clear, and instructionally useful.
Fail when examples are missing/inadequate for the skill being taught or contain substantive flaws.

### practice_problems (binary: 0.0 or 1.0)

Practice problems require students to attempt independently before seeing answers.

Pass when students get genuine attempt opportunities and answers are hidden/contingent.
Fail when no meaningful independent practice is provided where expected.

### follows_direct_instruction (binary: 0.0 or 1.0)

Assess adherence to direct instruction principles:
- clear objective and explicit teaching
- guided-to-independent progression
- logical sequencing
- reinforcement/feedback

Use outcomes of `educational_accuracy`, `teaching_quality`, `worked_examples`, and `practice_problems` as strong context.

---

## DI METRIC ASSIGNMENT RULES

For each concrete issue, assign one primary metric:
- factual mistakes -> `factual_accuracy`
- fails to teach intended goal -> `educational_accuracy`
- standards/grade misalignment -> `curriculum_alignment`
- weak pedagogy/scaffolding -> `teaching_quality`
- missing/weak modeled examples -> `worked_examples`
- missing/weak independent practice -> `practice_problems`
- DI principle breakdown across sequence/objective design -> `follows_direct_instruction`
- harmful stimulus (wrong, misleading, distracting, or contradictory visual OR embedded text reference) -> `stimulus_quality`
- language/grammar/merged words -> `diction_and_sentence_structure`
- culture/sensitivity issues -> `localization_quality`

Do not double-penalize the same issue across many metrics without independent evidence.

---

## 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 },
  "worked_examples": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "practice_problems": { "score": 0.0, "internal_reasoning": "...", "reasoning": "...", "suggested_improvements": null },
  "follows_direct_instruction": { "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 }
}
```
