grading-guide-render

What problem does it solve?

Deterministically render a grading guide from validated questions.json and rubrics.json into a byte-stable rubric/{year}/grading_guide.md. Pure template — no LLM calls. The guide serves as the standard reference for Phase 5 sub-agents and must be byte-stable across runs for identical inputs.

Core Features & Use Cases

• Deterministic rendering of grading guides from validated inputs (questions.json and rubrics.json).
• Byte-stable output with atomic writes and no timestamps for reproducibility.
• Optional incorporation of level descriptors and subject notes when present.
• Template-driven per-question rendering supporting nested structures and images.
• Use case: Generate a consistent grading guide for a given subject and year to onboard automated grading workflows.

Quick Start

Run the render script with the questions.json and rubrics.json to generate rubric/{year}/grading_guide.md.