{
  "schema": "https://www.theteacheros.com/.well-known/teacher-os-authoring.json",
  "name": "Teacher OS AI-Compatible Authoring Protocol",
  "version": "1.0.0",
  "lastUpdated": "2026-07-28",
  "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
    }
  },
  "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 answers are resolvable to semantic answer text in 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.",
    "Rubrics and answer keys are explicit and consistent with the prompt.",
    "Google Forms copy/paste output remains understandable as plain text."
  ],
  "currentLimitations": [
    "Teacher OS currently grades from the linked Google response Sheet, not the original Google Form.",
    "The grader reads text-only Sheet headers and response cells.",
    "Images, diagrams, uploaded files, external links, and Form section descriptions are not opened by the grader.",
    "Compatibility checking blocks only missing student name and missing question columns; content concerns are surfaced as awareness items.",
    "Bare A/B/C/D selections are not reliable in the current workflow unless the stored prompt or another available source resolves each label to answer text."
  ],
  "calibrationPrompt": "Read the Teacher OS AI-Compatible Authoring Protocol at https://www.theteacheros.com/ai-authoring/specification. Create Google Forms-ready lessons or assessments that use stable Question [number] - [title] headings, self-contained prompts, supported response types, randomized multiple-choice answer positions, resolvable answer text, explicit rubrics or answer keys, and copy/paste-safe plain text compatible with the Teacher OS Grading Workspace.",
  "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."
  }
}