Teacher OS AI-Compatible Authoring Protocol

Purpose

Produce Google Forms-ready lessons and assessments whose linked response Sheets contain enough information for Teacher OS to grade reliably. The specification governs compatibility with Teacher OS; teachers remain responsible for instructional quality, review, and final use.

Required structure

• One Google Form represents one complete lesson or assessment.
• Student identification must include a required first-and-last-name field. Email is required when feedback will be sent.
• Every gradable item has a unique sequential number and meaningful title using "Question [number] - [title]".
• Numbering runs across the whole lesson or assessment and does not restart per section.
• Each prompt is self-contained and includes the context, task, evidence requirements, and response expectations needed for grading.
• Multiple-choice items include one clearly best answer, plausible distractors, and answer text that is resolvable from the stored Sheet data.
• Multiple-choice correct-answer positions are randomized after item drafting, with no obvious pattern across A, B, C, and D.
• Short-response and paragraph items state what a complete answer includes and connect cleanly to the rubric or answer key.
• Rubric and answer-key guidance is explicit, consistent with the prompt, and includes acceptable alternatives when multiple answers can earn full credit.
• Google Forms content remains durable as plain text after copy/paste and in the linked response Sheet.

Question format

Question 1 - Binary Place Value
A byte contains the bits 00101101. State the decimal value of this byte. Explain how the 32, 8, 4, and 1 place values combine to produce the value.

The title identifies the concept without revealing the answer. The full prompt travels in the item text so it becomes the Google Sheet column header Teacher OS grades against.

Multiple-choice contract

Draft the item for conceptual quality first. Then randomize the correct-answer position across the set. After randomization, make sure the visible option labels, option text, prompt text, and answer key agree.

Question 2 - Binary Digit Meaning
In the binary number 1010, what does the leftmost 1 represent?
A. 1
B. 2
C. 8
D. 10
Correct answer: C. 8
Distractor notes: A confuses position with digit value; B uses the second place; D reads the number as decimal.

Compatibility limitations

• Teacher OS currently grades from the linked Google response Sheet, not from the original Form.
• The grader reads text. It does not open images, diagrams, uploaded files, links, section descriptions, or external documents.
• The compatibility check blocks only true engine failures: missing name column or no question columns.
• Images, diagrams, external links, file uploads, and missing feedback email are awareness items, not automatic quality judgments.
• The current workflow supports multiple choice, short answer, paragraph response, and checkbox-style selections when the stored response is interpretable.

Valid and invalid examples

Valid short response

Question 3 - Overflow Risk. A system stores whole numbers using 4 bits. Explain why adding 9 and 8 cannot be represented correctly in that system. Name the largest 4-bit unsigned value and describe what overflow means in this case.

Invalid short response

Question 3. Explain what happens in the example above.

Valid multiple choice

The stored prompt includes the full stem and visible choices, and the answer key records the correct semantic answer after randomized placement.

Invalid multiple choice

The Form choices are only A, B, C, and D while the answer texts live elsewhere. In the current Sheet-only workflow, Teacher OS receives only the selected letter and cannot resolve what the student chose.