---
url: /handbook/roadmap/key-person-risk-map.md
description: >-
  An optional add-on an advisor can offer after mapping: a page, built from the
  company's Task Cards, that shows who the business depends on, with a link the
  owner can forward to a buyer or banker.
---

# Key-person risk map

The key-person risk map is a proposed optional offering. An advisor can sell it after a company is mapped. It reads the Task Cards the team already gave and answers one question for an owner, a buyer or a banker: who does this business depend on, and what stops if that person is out?

::: warning
**Planned, optional.** This page describes an add-on that is not in the product. A working prototype was built on November 12, 2026 to prove it can be done from real Task Card data. It was not merged. The Work Map's **Key-person risk** lens, which marks Task Cards that only one person holds, is built. The **Status** box at the end says which part is which. The numbers on this page are examples, not results.
:::

## Who it is for

| Buyer | Why they want it |
| --- | --- |
| An owner getting ready to sell | Shows where the business leans on a few people before a buyer finds it in diligence, with time to name backups first. |
| A buyer, private equity firm or banker | Reads owner and key-person dependence from the work itself, not from interviews alone. |
| A sponsor or COO | Shows which absence would stop the most work, so cross-training goes where it matters. |

It is an upsell, not part of the standard mapping. It needs the company's Task Cards to exist first.

## What the page shows

Each person gets a score from 0 to 100, compared only with other people at the same company. Four parts make up the score:

| Part | Weight | Read from |
| --- | --- | --- |
| Hours only they do | 40 | Each Task Card's "how often" times "how long", as hours a month |
| People waiting on them | 30 | The people and teams named in each card's "hands to" |
| Rules only they know | 15 | Cards with an "only I know" answer |
| Controls they hold | 15 | Cards that are an approval, safety check or fraud check |

A card stops counting when the advisor names a backup for it. The page also names the card that would break first: the most frequent card nobody else can do. The score is a reading aid for a conversation, not a measurement, and the page says so.

## Two views

* **Advisor view.** Everything, including the "only I know" text and the hand-off words. The advisor can name a backup or mark a control on each card.
* **Shared link view.** A frozen copy the owner can forward. It shows names, roles, card titles, hours, who waits and the counts. It never shows "only I know" text, the hand-off words, email addresses, pay or record ids. It ends with a **Talk to your advisor** note. The link expires after 7, 30 or 90 days, and the advisor can turn it off.

## How it would be delivered

One command makes the page and the link:

```
dutygraph page key-person --company <company>
```

The command prints the top people, asks before it makes the link, then prints the shared link once and the address of the advisor view. Nothing is emailed: the advisor sends the link.

## What it needs that is not built

* A **backup person** and a **control** mark on each Task Card, set by the advisor.
* A share-link type for this page, made the same way as the other advisor share links.
* Matching "hands to" words to people, roles and teams. "Hands to" is free text today.

::: info
**Status.** **Built:** the Task Card answers the page reads ("how often", "how long", "hands to", "only I know"); the Work Map's **Key-person risk** lens, which marks single-holder cards. **Prototype only, not merged (November 12, 2026):** the score, the advisor and shared views, backup and control marks, the share link and the `dutygraph page key-person` command. The code is kept in the closed pull request #441. **Not decided:** the price and how the add-on is sold.
:::
