{
  "$defs": {
    "IsoDate": {
      "description": "ISO 8601 date (YYYY-MM-DD).",
      "format": "date",
      "type": "string"
    },
    "LadderLevel": {
      "description": "One level in a ladder.",
      "properties": {
        "comp_band_ref": {
          "anyOf": [
            {
              "$ref": "#/$defs/PathRef"
            },
            {
              "type": "null"
            }
          ],
          "description": "PathRef into the comp-band for this level."
        },
        "ordinal": {
          "description": "Ordinal — strictly ascending within the ladder.",
          "format": "int32",
          "type": "integer"
        },
        "required_skills": {
          "items": {
            "$ref": "#/$defs/SkillRequirement"
          },
          "type": "array"
        },
        "scope": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "typical_yir": {
          "description": "Years-in-role expectations (rough guide).",
          "format": "double",
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "ordinal",
        "title",
        "scope",
        "required_skills"
      ],
      "type": "object"
    },
    "PathRef": {
      "description": "Path-based cross-reference relative to .corpospec/ root.\nPattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`",
      "pattern": "^[a-z0-9_-]+(/[a-z0-9_.-]+)+$",
      "type": "string"
    },
    "ProficiencyLevel": {
      "description": "Five-level Dreyfus proficiency.",
      "enum": [
        "novice",
        "advanced_beginner",
        "competent",
        "proficient",
        "expert"
      ],
      "type": "string"
    },
    "SkillRequirement": {
      "description": "Required-skill rule for a level.",
      "properties": {
        "minimum": {
          "$ref": "#/$defs/ProficiencyLevel"
        },
        "skill": {
          "$ref": "#/$defs/PathRef"
        }
      },
      "required": [
        "skill",
        "minimum"
      ],
      "type": "object"
    }
  },
  "$id": "https://corpospec.com/schemas/v0.16.0/career-ladder.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Career ladder for a job-family.",
  "properties": {
    "effective_from": {
      "$ref": "#/$defs/IsoDate"
    },
    "effective_to": {
      "anyOf": [
        {
          "$ref": "#/$defs/IsoDate"
        },
        {
          "type": "null"
        }
      ]
    },
    "entity": {
      "$ref": "#/$defs/PathRef"
    },
    "id": {
      "$ref": "#/$defs/PathRef"
    },
    "levels": {
      "items": {
        "$ref": "#/$defs/LadderLevel"
      },
      "type": "array"
    },
    "name": {
      "type": "string"
    },
    "skill_family_ref": {
      "anyOf": [
        {
          "$ref": "#/$defs/PathRef"
        },
        {
          "type": "null"
        }
      ],
      "description": "PathRef into the related skill_family (e.g. Engineering)."
    }
  },
  "required": [
    "id",
    "entity",
    "name",
    "levels",
    "effective_from"
  ],
  "title": "CareerLadder",
  "type": "object",
  "x-corpospec-pillar": "people"
}