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, publication, and final use. A teacher's connected AI creates and edits the Form; Teacher OS does not run an authoring model or receive Google access.

Required output

1. One private, teacher-owned Google Form containing the complete lesson or assessment.
2. One linked response Sheet, or a clear manual Google-owned linking checkpoint when linking is not supported.
3. One short receipt with verified Form and Sheet links and any unresolved blocker.

Required structure

• One Google Form represents one complete lesson or assessment.
• Student identification includes a required first-and-last-name field. Email is collected when the teacher plans to send feedback.
• 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 complete A-D option text, 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.
• Open-response prompts state their scoring evidence directly; objective quiz items use correct answers and points when supported.
• Google Forms content remains durable as plain text after copy and 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: a missing name column or no question columns.
• Images, diagrams, external links, file uploads, and a 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.
• A connected AI must have permission and a supported action for creating and editing Google Forms; read-only Google Drive access is not sufficient.
• Teachers must review and publish the result. Teacher OS does not send these prompts to an AI or create the Google Form.

Published prompt set

The human guide publishes these complete standalone prompts. The machine-readable protocol catalogs their stable IDs and shared contract. Each complete prompt includes the Form creation, compatibility, capability, and privacy boundaries above.

• create-lesson: Create a complete lesson directly in a private Google Form.
• create-assessment: Create a complete assessment directly in a private Google Form.

The initial prompt creates the private Form and governs later conversational edits. The guide publishes one optional follow-up prompt for a PDF from the final reviewed Form. These prompts do not add a Teacher OS model call or Google permission.

• generate-pdf: Create a polished PDF from the final, teacher-reviewed Google Form.

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.