okhp3-stakeholder-and-role-mapping

OverKill Hill P³ · overkillhill.com · 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 · OverKill Hill P³ Published at github.com/OKHP3 Part of the OKHP3/skillz Agent Skill library. MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.