{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/guide.schema.json",
  "title": "skilldrop guide frontmatter",
  "$comment": "RFC-0029. Diátaxis `kind` is a PAGE CONTRACT, not a directory requirement — the directory is a convenience, the frontmatter is the truth. That keeps the tree shallow while still forcing each page to declare what kind of document it is, which is the discipline Diátaxis actually provides.",
  "type": "object",
  "additionalProperties": false,
  "required": ["title", "summary", "kind"],
  "properties": {
    "title": { "type": "string", "description": "Sentence case. Becomes the page's single h1." },
    "summary": { "type": "string", "description": "One line, shown in the guides index." },
    "kind": {
      "enum": ["tutorial", "how-to", "reference", "explanation"],
      "description": "tutorial = learning by doing. how-to = a task with a goal. reference = look it up. explanation = why it is this way. A page that cannot pick one is doing two jobs and should be split."
    },
    "status": { "enum": ["draft", "review", "stable", "deprecated"], "default": "stable" },
    "stage": {
      "enum": ["discover", "design", "build", "release", "operate"],
      "description": "RFC-0044. The lifecycle stage a page belongs to, when it belongs to one. The docs sidebar groups staged pages under that stage, beside the stage's loop; a page that spans every stage, or none, leaves it out."
    }
  }
}