okhp3-raci-governance-matrix

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

## RACI Matrix — Purchase Order Approval

| Activity | Requester | Finance Manager | Procurement | Director |
|---|---|---|---|---|