AI Authoring Protocol

Use the AI you already like. Keep the lesson gradeable.

Teacher OS publishes a public authoring standard so ChatGPT, Claude, Gemini, and other AI tools can create lessons and assessments that the Grading Workspace can understand.

Protocol version: 1.0.0 · Last updated: July 28, 2026

How it works

Teacher OS grades from the linked Google response Sheet. That means each Sheet column header must carry enough information for the grader to understand the question, and each response cell must be interpretable against the answer key or rubric.

Give your AI the calibration prompt below, then ask it to build, revise, or review your lesson. The specification is the source of truth; the prompt is only a shortcut.

Read the Teacher OS AI-Compatible Authoring Protocol before you write.

Use these source documents:
- Human guide: https://www.theteacheros.com/ai-authoring
- Canonical specification: https://www.theteacheros.com/ai-authoring/specification
- Machine-readable manifest: https://www.theteacheros.com/.well-known/teacher-os-authoring.json

Create the lesson or assessment so it is compatible with the Teacher OS Grading Workspace. Every gradable item must have a stable "Question [number] - [title]" heading, a self-contained prompt, a clear response type, and explicit answer-key or rubric guidance. Multiple-choice items must have one clearly best answer, plausible distractors, and randomized correct-answer positions across the set. The result must be easy to copy into Google Forms and still make sense from the linked response Sheet.

Teacher OS-compatible items

Stable number and title. Every gradable item begins with Question [number] - [title]. Numbering is unique, sequential, and stable across wording-only revisions whenever practical.
Self-contained prompt. The prompt includes the scenario, task, evidence requirements, and response expectations needed to grade the answer.
Multiple choice. Each item has one clearly best answer, plausible distractors, answer text that remains resolvable in the Sheet, and randomized correct-answer positions across the set.
Short response and paragraph. Prompts name the action students must perform and the evidence or criteria a complete response should include.
Google Forms durability. Questions copy cleanly into Forms and remain understandable as plain text in the linked Sheet.

Reusable prompts

Build a lesson

Create a Google Forms-ready lesson for Teacher OS on [topic] for [grade/course]. It should take [duration]. Include chapters, self-contained numbered questions, multiple-choice and short-response items where useful, an answer key, and rubric guidance for open responses.

Build an assessment

Create a Teacher OS-compatible assessment on [topic]. Use stable question numbering and meaningful titles. Make every prompt self-contained. Randomize multiple-choice correct-answer positions after drafting the items. Include the answer key and short rubric notes.

Review existing material

Review this lesson or assessment against the Teacher OS AI-Compatible Authoring Protocol. Identify compatibility issues, explain why each issue matters for grading, and provide corrected Google Forms-ready versions of the affected items.

Validate before import

Check whether this assessment is ready for the Teacher OS Grading Workspace. Confirm name/email fields, stable numbered question titles, self-contained prompts, resolvable multiple-choice answers, Google Forms copy/paste durability, and rubric or answer-key completeness.

Valid and invalid examples

Valid

Question 4 - Algorithm Fairness. A school uses grades, attendance, and participation to choose one student for an award. Explain whether this algorithm is fair. Identify one useful factor, one important quality it may miss, and one way the result could be misleading.

Invalid

Question 4. Based on the situation above, is the algorithm fair? Explain your answer.

The invalid version depends on context outside the question and has no meaningful title, so the Sheet header is not enough for reliable grading.