Clarity Decision Matrix

Use this when the user wants a weighted decision matrix, scored comparison, alternative ranking, or weight sensitivity analysis with explicit criteria, weights and scores. Accepts two to twenty options and one to eight criteria. Scores use a fixed zero-to-one-hundred scale; benefit means higher is better and cost means lower is better. Returns normalized weights, exact rankings and ties, pairwise break-even shares, up to four explicit weight scenarios and CSV. Does not research options, invent scores, infer preferences or predict outcomes.

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Comparison title, e.g. Supplier shortlist.",
      "type": "string",
      "maxLength": 80
    },
    "criteria": {
      "minItems": 1,
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40,
            "description": "Unique criterion name, e.g. Quality."
          },
          "weight": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000,
            "description": "Nonnegative importance weight, at most three decimal places, e.g. 60. Weights need not sum to one hundred."
          },
          "direction": {
            "default": "benefit",
            "description": "benefit favors higher scores; cost favors lower scores, e.g. cost for expense. Scores remain on the zero-to-one-hundred scale.",
            "type": "string",
            "enum": [
              "benefit",
              "cost"
            ]
          }
        },
        "required": [
          "name",
          "weight"
        ]
      },
      "description": "Criteria in the same order as each option score array, e.g. [{\"name\":\"Quality\",\"weight\":60,\"direction\":\"benefit\"},{\"name\":\"Expense\",\"weight\":40,\"direction\":\"cost\"}]."
    },
    "options": {
      "minItems": 2,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "description": "Unique alternative name, e.g. Supplier A."
          },
          "scores": {
            "minItems": 1,
            "maxItems": 8,
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 100,
              "description": "A fixed-scale rating, with at most three decimal places, e.g. 80."
            },
            "description": "One rating per criterion, in criterion order, e.g. [80,40]. Use comparable fixed-scale ratings, not raw mixed units."
          }
        },
        "required": [
          "name",
          "scores"
        ]
      },
      "description": "Alternatives with supplied ratings, e.g. [{\"name\":\"A\",\"scores\":[80,40]},{\"name\":\"B\",\"scores\":[60,20]}]."
    },
    "scenarios": {
      "description": "Optional explicit weight scenarios, e.g. [{\"label\":\"Cost emphasis\",\"weights\":[20,80]}].",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40,
            "description": "Scenario name, e.g. Cost emphasis."
          },
          "weights": {
            "minItems": 1,
            "maxItems": 8,
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 1000,
              "description": "Scenario importance weight, e.g. 80."
            },
            "description": "Replacement weights in criterion order, e.g. [20,80]. At least one must be positive."
          }
        },
        "required": [
          "label",
          "weights"
        ]
      }
    }
  },
  "required": [
    "criteria",
    "options"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "criteria": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "winners": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tied": {
      "type": "boolean"
    },
    "winner_count": {
      "type": "number"
    },
    "winners_preview_only": {
      "type": "boolean"
    },
    "option_count": {
      "type": "number"
    },
    "ranking": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "preview_only": {
      "type": "boolean"
    },
    "sensitivity": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "sensitivity_preview_only": {
      "type": "boolean"
    },
    "scenarios": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "downloads": {
      "type": "object",
      "properties": {
        "csv": {
          "type": "string"
        }
      },
      "required": [
        "csv"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "title",
    "criteria",
    "winners",
    "tied",
    "winner_count",
    "winners_preview_only",
    "option_count",
    "ranking",
    "preview_only",
    "sensitivity",
    "sensitivity_preview_only",
    "scenarios",
    "notes",
    "downloads"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}