Matrix 2×2
A two-by-two matrix diagram. Used for prioritization, strategy frameworks, and categorization with two independent axes.
Fields
| Field | Required | Type | Description |
|---|---|---|---|
| kind | yes | "matrix" | Must be exactly "matrix" |
| title | no | string | Title rendered above the diagram |
| x_axis | yes | string | Label for the horizontal axis |
| y_axis | yes | string | Label for the vertical axis |
| quadrants | yes | array of 4 | Exactly 4 quadrants, in reading order |
Quadrant fields
| Field | Required | Type | Description |
|---|---|---|---|
| label | yes | string | Text displayed in the quadrant |
| emphasis | no | string | "primary" or "secondary". See schema. |
| position | no | string | Explicit cell: "top-left", "top-right", "bottom-left", "bottom-right" |
Quadrant order
Without position (default): Quadrants are declared in reading order (left-to-right, top-to-bottom):
- Top-left (high Y, low X)
- Top-right (high Y, high X)
- Bottom-left (low Y, low X)
- Bottom-right (low Y, high X)
With position: All four quadrants must each declare a distinct position. Order in the file does not matter.
When any quadrant has position, all four must specify it.
Rendering rules
- The diagram is a 2×2 grid divided by a horizontal and vertical axis line.
- Each quadrant occupies one cell of the grid and displays its label centered.
x_axisis rendered below the horizontal center line.y_axisis rendered to the left of the vertical center line, rotated 90°.- Exactly 4 quadrants are required; more or fewer is a parse error.