{
  "schema": "https://www.theteacheros.com/.well-known/teacher-os-authoring.json",
  "name": "Teacher OS AI-Compatible Authoring Protocol",
  "version": "1.4.0",
  "lastUpdated": "2026-08-17",
  "status": "public",
  "canonicalUrls": {
    "humanGuide": "https://www.theteacheros.com/ai-authoring",
    "specification": "https://www.theteacheros.com/ai-authoring/specification",
    "manifest": "https://www.theteacheros.com/.well-known/teacher-os-authoring.json"
  },
  "targetWorkspace": "Teacher OS Grading Workspace",
  "supportedFormats": {
    "primary": "Google Forms linked response Sheet",
    "questionTypes": [
      "multiple_choice",
      "short_answer",
      "paragraph",
      "checkboxes_when_stored_response_is_interpretable"
    ]
  },
  "requiredFields": {
    "studentName": {
      "required": true,
      "acceptedHeaders": ["Name", "Student Name", "Full Name", "First and Last Name"]
    },
    "email": {
      "requiredForFeedbackEmail": true,
      "recommendedForGrading": false,
      "acceptedHeaders": ["Email", "Email Address", "Student Email"]
    },
    "timestamp": {
      "required": false,
      "recommended": true
    }
  },
  "requirements": [
    "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."
  ],
  "itemRequirements": [
    "Every gradable item begins with a stable Question [number] - [title] heading.",
    "Question numbers are unique, sequential, and continuous across the whole lesson or assessment.",
    "Prompts are self-contained and include all context required 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.",
    "Short-response and paragraph prompts state the expected evidence or components of a complete answer.",
    "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."
  ],
  "currentLimitations": [
    "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."
  ],
  "outputContract": [
    "One private, teacher-owned Google Form containing the complete lesson or assessment.",
    "One linked response Sheet, or a clear manual Google-owned linking checkpoint when linking is not supported.",
    "One short receipt with verified Form and Sheet links and any unresolved blocker."
  ],
  "promptLibrary": [
    {
      "id": "create-lesson",
      "title": "Create a lesson",
      "summary": "Create a complete lesson directly in a private Google Form."
    },
    {
      "id": "create-assessment",
      "title": "Create an assessment",
      "summary": "Create a complete assessment directly in a private Google Form."
    }
  ],
  "followUpPrompts": [
    {
      "id": "generate-pdf",
      "title": "Generate the PDF",
      "summary": "Create a polished PDF from the final, teacher-reviewed Google Form."
    }
  ],
  "promptRules": [
    "Use the complete standalone prompt published for the selected workflow in the human guide.",
    "Confirm that the connected AI can create and edit Google Forms before asking content questions; read-only Drive access is insufficient.",
    "Ask concise questions when teacher decisions are missing instead of silently inventing them.",
    "Do not request, include, or infer student data.",
    "Create and later edit the same private, teacher-owned Google Form through the connected provider's supported actions.",
    "Run Teacher OS compatibility checks silently and return only a short receipt unless a blocker remains.",
    "Never claim that a Form, Sheet, setting, or link exists when the AI cannot verify it.",
    "Do not publish the Form or enable response collection without explicit teacher instruction."
  ],
  "followUpPromptRules": [
    "Generate PDFs from the final teacher-reviewed Form, not an earlier conversational draft.",
    "Create files only through permissions the teacher grants to their chosen AI provider.",
    "Never claim that a file, setting, response Sheet, or link exists when the AI cannot verify it.",
    "Keep student-facing content separate from private teacher answers and rubrics.",
    "Keep generated files teacher-owned and do not include student data."
  ],
  "calibrationPrompt": "Follow the Teacher OS AI-Compatible Authoring Protocol at https://www.theteacheros.com/ai-authoring/specification. First confirm that you can create and edit Google Forms in my connected account. Ask only for missing teacher decisions, then create one private teacher-owned Form and linked response Sheet. Use stable Question [number] - [title] headings, self-contained prompts, supported response types, complete A-D option text, randomized correct-answer positions, and copy-safe plain text. Run compatibility checks silently, do not use student data, and return only the verified links and unresolved blockers.",
  "examples": {
    "validQuestion": "Question 1 - 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.",
    "invalidQuestion": "Question 1. Based on the situation above, is the algorithm fair? Explain your answer.",
    "invalidReason": "The invalid question depends on context outside the stored prompt and lacks a meaningful title."
  }
}