STATUS MATRIX

entities x stages grid with status word + color. Needs: rows of entities, columns of ordered stages, one status enum per cell.

statuslookupreadiness

DL-01 AGRAW

Use when

readiness tracking: systems x stages, packages x gates, sites x milestones
the reader looks up THEIR row
8 rows and 6 stage columns or fewer

Do not use when

numeric cells (heatmap table when built)
more than 8 rows (split by area or paginate)
single-stage status (a list with chips does it)

See instead

cells are numbers, not statuses: CH-TAB-02 when built
progress over time per entity: CH-TIM-02

Alternatives

CH-TAB-02 (heatmap table, planned)

Rules

status is ALWAYS swatch + word, never color alone
stage columns in process order, never re-sorted
rows in the reader's natural order (system number, site), not by health
na cells show the nil hyphen with the hairline swatch
no zebra striping; hairline row rules only

Never do this

color-only status dots
zebra striping
sorting rows by health (readers lose their row)
traffic-light gradients between statuses
emoji as status markers

QA before delivering

every cell carries word + swatch
cells per row equal column count
rows <= 8, columns <= 6
title states the readiness finding with a number
source line present bottom-left

Data shape

title	string, action title stating the readiness finding with a number
eyebrow	string caps, rendered only when the DL chrome asks for it
source	string, rendered bottom-left, always
columns	array of ordered stage names, caps
rows	array of {label, cells: [status enum per column]}
statuses	complete \| on_track \| watch \| critical \| na

Sample data (golden)

{
  "title": "Two of five systems are handover-ready; System D is critical in test",
  "eyebrow": "READINESS . WEEK 28",
  "source": "Source: sample dataset v1, 2026-07-12",
  "columns": [
    "INSTALL",
    "TEST",
    "PUNCH",
    "HANDOVER"
  ],
  "rows": [
    {
      "label": "System A",
      "cells": [
        "complete",
        "complete",
        "complete",
        "complete"
      ]
    },
    {
      "label": "System B",
      "cells": [
        "complete",
        "complete",
        "complete",
        "complete"
      ]
    },
    {
      "label": "System C",
      "cells": [
        "complete",
        "on_track",
        "watch",
        "na"
      ]
    },
    {
      "label": "System D",
      "cells": [
        "complete",
        "critical",
        "na",
        "na"
      ]
    },
    {
      "label": "System E",
      "cells": [
        "on_track",
        "watch",
        "na",
        "na"
      ]
    }
  ]
}