Skip to content
DocsChartsOwnership matrixLast updated Nov 2, 2026

Ownership matrix

Each agent's parts, owners and health. Sample data: six agents across prompt, eval, alert, key and budget, the refunds agent's prompt v14 approved, waiting on you.

What each owned object needs30 owned objects across 6 agents and 5 kinds: 2 broken, 5 need a look, 1 waiting on you, 22 fine.REFUNDSRESEARCHANALYSTINVOICESTRIAGESALESPROMPTEVAL2ALERT2KEY1BUDGET2v1495.8%noisy41 d$1.2Kv9 draft95.3%firingshared$1.7Kv4 livenonequietshared$610v11 live100%guardsharedpausedv31 live98.9%quietshared$1.6Kv12 live98.0%quietshared$640FINENEEDS A LOOKBROKENWAITING ON YOU
What each owned object needs
AgentPromptEvalAlertKeyBudget
Refundsv14 approved (waiting on you)refunds-v4 95.8% (broken)noisy · 14 a week (needs a look)unused 41 days (needs a look)$1,190 of $1,500 (fine)
Researchv9 draft (fine)research-v3 95.3% (fine)firing · latency (broken)runtime · shared (fine)$1,730 of $1,800 (needs a look)
Analystv4 live (fine)no suite · add one (needs a look)quiet (fine)runtime · shared (fine)$610 of $900 (fine)
Invoicesv11 live (fine)invoices-v9 100% (fine)guard · fired once (fine)runtime · shared (fine)paused · daily cap (needs a look)
Triagev31 live (fine)triage-v12 98.9% (fine)quiet (fine)runtime · shared (fine)$1,640 of $2,200 (fine)
Salesv12 live (fine)leads-v6 98.0% (fine)quiet (fine)runtime · shared (fine)$640 of $900 (fine)
What each owned object needs30 owned objects across 6 agents and 5 kinds: 2 broken, 5 need a look, 1 waiting on you, 22 fine.REFUNDSRESEARCHANALYSTINVOICESTRIAGESALESPROMPTEVAL2ALERT2KEY1BUDGET2v1495.8%noisy41 d$1.2Kv995.3%firingshared$1.7Kv4nonequietshared$610v11100%guardsharedpausedv3198.9%quietshared$1.6Kv1298.0%quietshared$640FINENEEDS A LOOKBROKENWAITING ON YOU
What each owned object needs
AgentPromptEvalAlertKeyBudget
Refundsv14 approved (waiting on you)refunds-v4 95.8% (broken)noisy · 14 a week (needs a look)unused 41 days (needs a look)$1,190 of $1,500 (fine)
Researchv9 draft (fine)research-v3 95.3% (fine)firing · latency (broken)runtime · shared (fine)$1,730 of $1,800 (needs a look)
Analystv4 live (fine)no suite · add one (needs a look)quiet (fine)runtime · shared (fine)$610 of $900 (fine)
Invoicesv11 live (fine)invoices-v9 100% (fine)guard · fired once (fine)runtime · shared (fine)paused · daily cap (needs a look)
Triagev31 live (fine)triage-v12 98.9% (fine)quiet (fine)runtime · shared (fine)$1,640 of $2,200 (fine)
Salesv12 live (fine)leads-v6 98.0% (fine)quiet (fine)runtime · shared (fine)$640 of $900 (fine)

Installation

  1. 1

    Set up the registry once

    Your token in .env and @chartory in components.json. Skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Ownership matrix component to your project.

    npx shadcn add @chartory/ownership-matrix
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { OwnershipMatrix }  from "@/components/chartory/ownership-matrix"<OwnershipMatrix  data={agentParts}  size="m"  legend/>

Props

<OwnershipMatrix>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.OwnershipMatrixDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
legend: Shows the legend row under the plot.booleantrue
color: The data colour of the primary marks (data/primary)."cat-1" | "cat-2" | "cat-3" | "cat-4""cat-1"

OwnershipMatrixData

The data prop: one object for the whole chart.

PropTypeDefault
cols: One entry per column.OwnershipMatrixCol[]Required
rows: One entry per row.OwnershipMatrixRow[]Required

OwnershipMatrixCol

One object per entry in cols.

PropTypeDefault
label: The name shown on the chart.stringRequired
n?: The count.number—

OwnershipMatrixRow

One object per entry in rows.

PropTypeDefault
label: The name shown on the chart.stringRequired
cells: The cells, in order.OwnershipMatrixCell[]Required

OwnershipMatrixCell

One object per entry in rows.cells.

PropTypeDefault
t: The cell's state."fine" | "look" | "broken" | "waiting"Required
long: The long form of the label.stringRequired
short: The short form of the label, for the small sizes.stringRequired

The data as a JSON Schema: schemas/ownership-matrix.json

Ownership matrix: a React and Figma chart in four sizes

What does an ownership matrix show?

An ownership matrix lists each agent or service down the side and its parts across, such as prompt, eval, alert, key and budget, with the state of each cell. Broken parts and parts waiting on you stand out. Use it for AI agent fleets and service catalogues.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Ownership matrix component?

It is one <OwnershipMatrix> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is a state per item and part.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Are there several parts per item? Yes means the ownership matrix fits.
  • Is health the point? Yes means the ownership matrix fits.
  • Is it items, not tests? Yes means the ownership matrix fits.

When does another type fit better?

  • One count per owner. Use Load bars instead.
  • Grants per role. Use Permission matrix instead.
  • Models against tests. Use Pass/fail grid instead.

Ownership matrix questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.