okhp3-raci-governance-matrix

OverKill Hill P³ · overkillhill.com · github.com/OKHP3

Purpose

Generate a standalone RACI matrix and governance responsibility document from a validated PNS. The RACI table makes role assignments explicit and auditable — supporting both operational clarity and ISO 9001 §5.3 accountability requirements.

When to use this skill

• PNS quality score ≥ 75 and user needs a standalone RACI document
• User needs to communicate role assignments to a wider stakeholder audience
• Preparing governance documentation for audit or onboarding
• Supplementing the SOP with a responsibility reference table

When NOT to use this skill

• PNS does not exist or roles_and_raci is empty — complete process-narrative-authoring first
• RACI is only needed embedded in the SOP — use sop-and-work-instruction-generation instead

RACI Matrix Generation

scripts/generate-raci.mjs builds the matrix from pns.roles_and_raci and pns.activity_sequence:

• Iterates activities in sequence order
• Joins RACI entries by activity_id
• Returns { roles[], matrix[{ activity_id, description, R[], A, C[], I[] }] }
• Activities with no RACI entry appear with empty assignments (and a warning)

Output format

markdown
## RACI Matrix — Purchase Order Approval

| Activity | Requester | Finance Manager | Procurement | Director |
|---|---|---|---|---|
| Submit PO Request | **R** | I | — | — |
| Review PO | C | **R** | C | — |
| Approve PO | I | — | — | **R/A** |

Governance Matrix

The governance matrix extends the RACI with:

• Escalation path — who a role escalates to when a decision is beyond their authority
• Delegation rule — conditions under which a role can delegate their responsibility
• Absence cover — backup role when primary is unavailable
• Authority limit — any financial or operational ceiling on the role's authority

Derived from pns.business_rules[] and pns.exception_paths[].

Validation Rules

Every RACI matrix must satisfy:

• Each activity has exactly one A (Accountable)
• Each activity has at least one R (Responsible)
• No role appears as both R and A unless they are the process owner
• All role IDs match entries in roles_and_raci.roles[]

Handoff Instruction

Pass raci.md and governance-matrix.md to publication-and-handoff-packaging for bundle assembly.

References

Load on demand:

• references/raci-design-rules.md — RACI cell definitions, validation rules, governance matrix extensions, and escalation path conventions

Scripts

• scripts/generate-raci.mjs — builds RACI matrix and governance matrix from PNS

Assets

• assets/fixtures/raci-example.yaml — canonical RACI fixture for purchase-approval process

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.