generative-learning.vercel.app

{
  "type": "object",
  "properties": {
    "lesson": {
      "type": "number",
      "description": "Catalog lesson number. Reuse it; do not invent a new lesson per move."
    },
    "title": {
      "type": "string",
      "description": "Beat heading, not the whole lesson topic."
    },
    "what": {
      "type": "string",
      "description": "What happens now. Moves must be long algebraic such as e2-e4, Ng1-f3, never short SAN (e4, Nf3)."
    },
    "why": {
      "type": "string",
      "description": "Why this belongs here."
    },
    "paragraphs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional extra paragraphs after what/why. Squares MUST be English algebraic: files a–h and ranks 1–8 (e4, f7, h5). Never transliterate squares. Words may be any language. Moves MUST use long algebraic notation (LAN) so hover can draw the arrow from the exact piece: e2-e4, e7-e5, Ng1-f3, Nb8-c6, Bf1-c4. Captures: e4xd5, Bf1xc4. Never write short SAN for a move (not 1.e4, not e5, not Nf3, not Bc4, not Qh5). That only highlights the destination, as if the piece is unknown. Bare squares (e4, f7) name a location, not a move. Castling may stay O-O / O-O-O."
    },
    "body": {
      "type": "string",
      "description": "Fallback only if you cannot send paragraphs. Prefer paragraphs."
    },
    "step": {
      "type": "number",
      "description": "1-based teaching step index. Omit to append."
    },
    "totalSteps": {
      "type": "number"
    }
  },
  "required": [
    "title",
    "lesson"
  ]
}