---
name: okhp3/okhp3-stakeholder-and-role-mapping
source: https://app.decimal.ai/s/okhp3-okhp3-stakeholder-and-role-mapping@1/SKILL.md
source_sha256: 717237bf45ad
---

# okhp3-stakeholder-and-role-mapping

**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)

## Purpose

Derive a structured stakeholder register from a validated PIR. The register maps every actor to a stakeholder record with role classification, interest, influence, and engagement strategy — providing the role foundation for RACI matrices, governance documents, and process narrative authoring.

---

## When to use this skill

- PIR has `ready_for_narrative: true` and you need a stakeholder register before writing the PNS
- User asks who should be consulted, informed, or responsible for a process
- You need engagement strategies for each role before drafting governance content

## When NOT to use this skill

- PIR has not been validated (score < 70) — return to `process-intake-and-scope`
- User only needs a quick list of names without structured classification — ask if a full register is needed
- Do not invent stakeholders not present in the PIR actors array

---

## Derivation Rules

`scripts/generate-stakeholder-register.mjs` derives the register from `pir.actors[]`:

| Actor type | Engagement strategy |
|---|---|
| `initiator` | Collaborate |
| `performer` | Collaborate |
| `approver` | Consult |
| `reviewer` | Consult |
| `notified` | Inform |
| `system` | Monitor |

Each register entry contains:
- `stakeholder_id` — from `actors[].role_id`
- `name` — from `actors[].role_name`
- `department` — from `actors[].department` (defaults to `"Unspecified"`)
- `primary_role` — from `actors[].type`
- `interest` — from `actors[].interest` (defaults to `"outcome quality"`)
- `influence` — from `actors[].influence` (defaults to `"medium"`)
- `engagement_strategy` — derived per table above

---

## Influence–Interest Grid

After derivation, plot each stakeholder on the 2×2 grid:

| | Low Interest | High Interest |
|---|---|---|
| **High Influence** | Keep Satisfied | Manage Closely |
| **Low Influence** | Monitor | Keep Informed |

Document the quadrant in `stakeholder_register.grid_position` for each entry.

---

## Validation

Every register must pass:
- At least one `Collaborate` entry (initiator or performer present)
- At least one `Consult` or `Manage Closely` entry
- No stakeholder with empty `stakeholder_id`
- `influence` values are one of: `high | medium | low`

---

## Handoff Instruction

Pass `pir.yaml` and the generated `stakeholder-register.yaml` together to `process-narrative-authoring`. The narrative skill maps `stakeholder_id` values to RACI role assignments.

---

## References

Load on demand:
- `references/stakeholder-identification-rules.md` — actor type definitions, engagement strategies, and grid placement rules

## Scripts

- `scripts/generate-stakeholder-register.mjs` — derives register from PIR actors array

## Assets

- `assets/fixtures/stakeholder-register-example.yaml` — canonical register derived from purchase-approval PIR

## About

Built by [Jamie Hill](https://overkillhill.com) · [OverKill Hill P³](https://overkillhill.com)
Published at [github.com/OKHP3](https://github.com/OKHP3)
Part of the [OKHP3/skillz](https://github.com/OKHP3/skillz) Agent Skill library.
MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.