SfSkills Domains Docs GitHub

Home / admin / stakeholder-raci-for-sf-projects

stakeholder-raci-for-sf-projects

Use this skill when building, reviewing, or refreshing a RACI (Responsible / Accountable / Consulted / Informed) matrix for a Salesforce project so that every Salesforce-specific decision — data model change, automation tier choice, security model, integration boundary, deployment, license/edition — has exactly one accountable owner and a documented escalation path that downstream agents can route to.

Open the skill folder on GitHub


Stakeholder RACI for Salesforce Projects

This skill activates when a Business Analyst, project manager, or admin lead needs a deterministic method for assigning decision authority on a Salesforce project — and a routing table that the repository's runtime agents can use when they emit REFUSAL_NEEDS_HUMAN_REVIEW. The output is a RACI matrix tailored to the Salesforce decision surface (data model, automation tier, security, integration, deployment, licensing) with explicit escalation rules per accountable cell.


Before Starting

Gather this context before drafting the matrix:


Questions to Ask Before Configuring

Ask these before drafting a single cell. Each one exists because a specific failure recurs — the matching gotcha is named in the last column so you can see what the answer is protecting you from.

AskWhy it mattersWhat a good answer adds
"Who loses something when the sandbox is refreshed, and who schedules it?"A refresh replaces the org; the person who runs it is rarely the person whose UAT evidence or seeded data disappearsSeparate A (data owner) and R (release manager) on the refresh row, with a blocking trigger — gotchas.md §9
"Who signs off a data load — the person who runs the tool, or the person who owns the records?"Hard-deleted records cannot be recovered from the Recycle Bin, and a failed bulk job leaves a partial state someone must adjudicateAn A on the data owner and an escalation trigger on hard delete and row-count overrun — gotchas.md §13
"Who decides when we activate a Release Update, and against which enforcement release?"Release Updates carry an availability release and an enforcement release; unowned, the platform activates on its dateA release-update row with A on the release manager and a time-box measured in releases — gotchas.md §12
"Which delegate groups exist today, and do they match what this matrix says about permissions?"Delegated administration is the decision-rights model made deployable — the org grants what the metadata says, not what the deck saysA retrieve-and-diff step at each phase review — gotchas.md §14
"Is 'the Salesforce admin' one column or several roles one person happens to fill?"One column means one bottleneck and no successor; the platform itself splits admin authorityA register that records the double-hatting instead of merging the columns — gotchas.md §10
"Which running integrations does this org already have, and who owns each one?"API allocations and concurrency limits are org-wide and shared; an unlisted integration can fail your rehearsed loadNamed owners for existing integrations as C on the integration row — gotchas.md §11
"If this is a multi-org programme, does each role mean the same person in every org?"Roles, delegate groups, and release managers are org-scoped; one column hides two different authoritiesOrg-scoped columns (RM_A, RM_B) and a steerco A on cross-org decisions — gotchas.md §15

What a proper matrix adds over just naming an owner per workstream: every irreversible Salesforce action — refresh, load, hotfix, release-update activation — has exactly one named person who can authorise it, a clock that fires when they do not, and a decision log an auditor can read a year later.


Core Concepts

The Salesforce Decision Surface

A generic project RACI lists deliverables. A Salesforce RACI lists decisions — because a Salesforce build is a stack of irreversible-or-expensive-to-reverse decisions, not a stack of artifacts. The canonical decision categories every Salesforce RACI must cover:

  1. Data model change — adding/changing/deleting standard or custom objects, fields, relationships, record types, or external IDs. A decision here ripples through reports, integrations, and security.
  2. Automation tier — picking Flow vs. Apex vs. Agentforce vs. Approvals vs. Platform Events for a given requirement (see standards/decision-trees/automation-selection.md).
  3. Security model — OWD, role hierarchy, sharing rules, profiles, permission sets, permission set groups, restriction rules, and field-level security (see standards/decision-trees/sharing-selection.md).
  4. Integration boundary — REST vs. Bulk vs. Platform Events vs. CDC vs. Pub/Sub vs. Salesforce Connect vs. MuleSoft (see standards/decision-trees/integration-pattern-selection.md), plus the contract with the source/target system.
  5. Deployment — what gets promoted, when, with what backout plan, and through which sandboxes (see admin/sandbox-strategy).
  6. License + edition — which user license, which add-on (Service Cloud, Sales Cloud, Agentforce, CPQ, OmniStudio, Experience Cloud), edition tier, and feature license assignment.

Every row in the matrix is one of these categories — or a sub-row scoped to a specific object, integration, or release. Resist adding deliverable rows ("build the Account page layout") — those belong in a work-breakdown structure, not a RACI.

The Ten Required Activity Rows

The six categories above are how you think about the surface. The rows you actually write are the ten activities below — the ones that are irreversible, expensive to reverse, or driven by a date Salesforce sets rather than one you set. scripts/check_raci.py requires every slug to appear at least once; a missing slug is an error, because a required decision with no row is a decision with no owner.

Activity slugCategoryTypical AExecuted by
data-model-changeData modelData steward or process owneragents/object-designer/AGENT.md, agents/field-impact-analyzer/AGENT.md
sharing-model-changeSecuritySecurity architectagents/access-path-explainer/AGENT.md
permission-set-changeSecurityCRM admin leadagents/permission-set-architect/AGENT.md
integration-changeIntegrationIntegration architectagents/integration-catalog-builder/AGENT.md
release-go-no-goDeploymentBusiness sponsoragents/release-readiness-reviewer/AGENT.md
sandbox-refresh-approvalDeploymentData owner (not the refresher)agents/sandbox-strategy-designer/AGENT.md
production-hotfixDeploymentRelease manageragents/deployment-risk-scorer/AGENT.md, agents/changeset-builder/AGENT.md
data-load-approvalData modelData stewardagents/data-loader-pre-flight/AGENT.md, agents/data-migration-reconciler/AGENT.md
release-update-activationDeploymentRelease manageragents/change-impact-planner/AGENT.md, agents/org-health-assessor-v2/AGENT.md
seasonal-release-previewDeploymentRelease manageragents/release-train-planner/AGENT.md

Sub-rows share a slug: a regulated programme writes two data-model-change rows (regulated data and everything else) with different As. The automation-tier and license/edition categories stay as optional extra rows — they are decisions, but they are reversible, so they do not carry the same "nobody owns this and the platform is about to act" risk the ten do. A filled version of all ten, with escalation rules and the executing agent per row, is in references/worked-examples.md.

The Canonical Salesforce Stakeholder Roster

The matrix columns come from a fixed roster:

RoleTypical titleOwns A onOwns C on
Business sponsorVP Sales / VP Service / CFO / CIOScope, budget, go/no-go gateAlmost everything else
Process ownerDirector of the affected business functionBusiness process changes, UAT sign-offData model changes that affect their process
Data stewardMDM lead / data governance leadData model changes, picklist values, dedupe rules, retentionReports, integrations
Security architectInfoSec / IAM leadSecurity model, profile/PSG architecture, sharingIntegrations, data model with PII
Integration architectEnterprise architect / iPaaS leadIntegration boundary + contractData model, security
CRM admin leadSalesforce admin / lead BADay-to-day config, declarative automationAll technical decisions
Release managerDevOps / release engineerDeployment, sandbox strategy, environment hygieneAutomation tier when it affects packaging
AppExchange ownerThe internal sponsor of any installed managed packageDecisions touching the package's namespaceData model, security
Compliance officerPrivacy / risk / compliance leadRegulatory controls, audit trail, retentionData model, security, integrations
End-user representativePower user from the affected teamUAT, adoption, training feedbackProcess changes

Keep architects split across Security architect and Integration architect — collapsing them into a single "Architecture" role is one of the most common RACI mistakes on Salesforce projects.

R / A / C / I — and the One-A Rule

LetterMeaning
R (Responsible)Does the work. There can be many Rs per row.
A (Accountable)Owns the outcome and is the single decision-maker. Exactly one A per row. This is the load-bearing rule of any RACI; multiple As mean nobody is accountable.
C (Consulted)Two-way conversation before the decision is made. Their input is required, not optional.
I (Informed)One-way notification after the decision is made.

Additional rules specific to Salesforce projects:

Escalation Rules: The "When Does This Go Up?" Question

A RACI without escalation rules is a wall poster. For every A-cell, document:

Escalation rules without a time-box silently rot — the project blocks but no alarm trips.

Mapping RACI to Agent Refusal Codes

The repository's runtime agents emit refusal codes from agents/_shared/REFUSAL_CODES.md when they hit a condition that explicitly requires human judgment. The RACI is the routing table that converts a refusal code into a named person.

Canonical mapping:

Refusal codeDecision category in RACIWho the BA pings (the A)
REFUSAL_NEEDS_HUMAN_REVIEWThe category named in the refusal messageThe A on the matching row
REFUSAL_INPUT_AMBIGUOUSWhichever category the input concernsThe A on that row
REFUSAL_SECURITY_GUARDSecurity modelSecurity architect
REFUSAL_POLICY_MISMATCHWhichever decision category the policy spansThe A on that row + sponsor (informed)
REFUSAL_MANAGED_PACKAGELicense + edition (managed package scope)AppExchange owner
REFUSAL_COMPETING_ARTIFACTData model or automation tier (depends on artifact)The A on the matching row
REFUSAL_DATA_QUALITY_UNSAFEData modelData steward
REFUSAL_FEATURE_DISABLEDLicense + editionBusiness sponsor (cost) + CRM admin lead (enablement)

Every BA / admin runtime agent's escalation step should look up the refusal code, find the row, and ping the A — with the C on the same row in the loop.


Common Patterns

Pattern: Greenfield Sales Cloud RACI

When to use: First Salesforce implementation, single-org, no managed packages, single-region.

How it works: Sponsor (CRO) holds A on scope and license. Process owner (VP Sales Ops) holds A on data model and automation tier. Security architect holds A on security. Integration architect holds A on the one or two inbound feeds. CRM admin lead holds A on day-to-day config. Compliance officer is C on data model and security; not on the critical path.

Why not the alternative: Rolling A on the data model into the sponsor in a greenfield is tempting but wrong — sponsors do not have time to decide on every field, and the data steward / process owner is closer to the data semantics.

Pattern: Regulated Industry RACI (HIPAA / FINRA / PCI)

When to use: Health Cloud, Financial Services Cloud, payment-card-handling, or any project where audit findings could be material.

How it works: Compliance officer holds A on retention, audit trail, and any decision touching regulated data. Security architect holds A on FLS and sharing for regulated objects. Data steward is C on every row touching regulated data and may hold A on data classification. Sponsor's A on scope must include explicit acceptance that the compliance officer can veto a feature.

Why not the alternative: Treating compliance as C on regulated data lets the project ship with a control gap — and the audit catches it six months later. Compliance gets A on the controls; the process owner still owns the business outcome.

Pattern: M&A Multi-Org RACI

When to use: Two or more existing Salesforce orgs being merged or federated post-acquisition.

How it works: Two business sponsors (one per legacy org) reporting to a combined steerco; the steerco holds A on org-strategy decisions (merge vs. federate vs. coexist). Each org keeps its own CRM admin lead and process owner with split A on day-to-day decisions. Integration architect holds A on the cross-org integration pattern. A new "data steward (master)" role emerges to hold A on the master data model post-merger.

Why not the alternative: Naming a single sponsor too early in an M&A causes one side's stakeholders to disengage. The split-A pattern is uncomfortable but mirrors the actual organizational state until the merger is complete.


Decision Guidance

SituationRecommended ApproachReason
Sponsor wants A on every rowPush back; sponsor holds A on scope/budget/go-no-go onlySponsors cannot decide field-by-field; A loses meaning if everywhere
No data steward exists in the orgSurface as a project risk, not a config; ask sponsor to name oneData model decisions without a steward become technical debt within months
Architecture is a single roleSplit into security architect and integration architectSalesforce architecture decisions span domains; one head cannot hold A on both
Implementation partner is A on production deployTransfer A to internal release manager before hypercare endsPartners leave; A must live with the customer permanently
AppExchange package is in scopeAdd AppExchange owner as a column; A on namespace-touching decisionsManaged-package namespace constraints are not negotiable
Compliance is C on every regulated rowPromote compliance to A on the regulatory control rowsC is not enough for audit-grade decisions
Escalation rule has no time-boxAdd one (typically 3–5 business days)Escalations without a clock silently stall projects
Agent emits REFUSAL_NEEDS_HUMAN_REVIEWLook up the decision category in the refusal map; ping the AThis is the runtime use of the matrix

  1. Fill the intake sheet and build the register. Copy

    templates/stakeholder-raci-for-sf-projects-template.md; record phase, org topology, regulatory overlay, managed packages, delegate groups already in the org, and the partner's hypercare exit date, working the ## Questions to Ask Before Configuring table into it. Then name a person for every roster role with org unit, Salesforce persona, user licence, and decision rights — the six columns in references/worked-examples.md §1. An unnamed role is a project risk to escalate, not a placeholder to fill later.

  2. Write the ten activity rows. Copy templates/raci-matrix.md, keep the ten required slugs, and

    add sub-rows only where a category needs splitting. Apply the one-A rule, the no-A-on-a-C rule, and the every-row-has-an-R rule as you fill cells.

  3. Attach an escalation rule to every A, and an escalation path to the programme. Trigger, target,

    time-box per row; level, forum, chair, time-box per escalation level. references/gotchas.md §4 is why the time-box is not optional.

  4. Map each R to its executor. Fill executed_by with the repo path of the agent, skill, or

    decision tree that carries out the row — see the table in ## Core Concepts and references/worked-examples.md §5.

  5. Lint the artefact. Run

    python3 scripts/check_raci.py --file <path>/raci.yaml --repo-root <repo> --strict. Errors are structural (missing A, missing R, missing required activity, missing escalation, unresolved executed_by); fix them before circulating. Warnings are judgement calls — read them, then decide.

  6. Reconcile the matrix against the org. Retrieve the delegate groups and diff them against the

    permission row (references/worked-examples.md §6). A difference is a decision made outside the governance path.

  7. Review, version-lock, log. Capture the sponsor sign-off date, the next review date, and the

    phase in the artefact header. Record decisions as they are made in the decision_log shape — the next phase gets a new version, not an in-place edit.

Review Checklist

Run through these before publishing the matrix:


Salesforce-Specific Gotchas

Non-obvious project-governance behaviors that cause real production problems:

  1. A migrated to the consulting partner and never transferred back. During implementation the SI's lead architect carries A on integration and security because they own the design. If A does not transfer to a named customer employee before hypercare ends, the customer has no decision-maker post-go-live and every change request blocks until a partner is re-engaged.
  2. Compliance officer demoted to C on regulated data. Project teams find compliance's review cycle slow and quietly leave them as C. The system ships, audit fires, and the gap forces a remediation project that costs more than the original build.
  3. Single-sponsor RACI on an M&A. Naming one sponsor too early disenfranchises the other org's stakeholders. They disengage from steerco, requirements drift, and the merger fails to consolidate. Use a steerco-as-A pattern until the legal merger closes.
  4. AppExchange owner missing from the matrix. Decisions touching a managed-package namespace (Conga, DocuSign, CPQ, FSL, NPSP) require the package owner's input — they know what the next package release will break. Omitting them produces decisions that get reversed by the next package upgrade.
  5. Escalation paths without time-boxes. "Escalate to sponsor if blocked" with no clock means the team waits indefinitely for the A to decide. A 3–5 business-day time-box should be the default, with shorter for security and longer for license-tier decisions.

Seven more — the sandbox refresh approved by someone who does not own the data in it, "the Salesforce admin" as A for everything, integrations whose owners are outside the matrix, release-update activation owned by nobody, the data load signed off by the tool operator instead of the record owner, delegate groups that contradict the permission row, and one role meaning two different people in a multi-org programme — are in references/gotchas.md §9–§15, each with the platform behaviour that makes it bite.


Output Artifacts

ArtifactDescription
Stakeholder registerOne row per role: named person, org unit, Salesforce persona, user licence, decision rights
RACI matrix (markdown)The circulated view — one row per activity, one column per stakeholder role; cells contain R/A/C/I
RACI matrix (YAML)The artefact of record, linted by scripts/check_raci.py. JSON with the same keys is accepted
Escalation rules + escalation pathPer-row trigger / target / time-box, plus programme-level levels, forums, chairs
R-to-executor mapexecuted_by per row: the agent, skill, or decision tree that carries out the work
Refusal-code-to-stakeholder mapMapping from REFUSAL_* codes to the named A who should be paged
Decision logPer decision: date, activity, decision, decided by, consulted, alternatives rejected, reversal cost, evidence
Review logSponsor / steerco review date, attendees, version stamp, next review date

Reference Files

FileRead it when
references/worked-examples.mdYou need the filled artefacts — register, ten-row matrix in markdown and YAML, escalation path, decision log, R-to-executor map, and the DelegateGroup / CustomMetadata XML that makes the matrix deployable
references/examples.mdYou need a matrix shaped for a specific programme type — greenfield, regulated (HIPAA), or M&A multi-org — or the sponsor-as-universal-A anti-pattern with the linter output
references/gotchas.mdBefore publishing, and any time a cell feels obvious — 15 failure modes with what happens / when it occurs / how to avoid
references/well-architected.mdYou are justifying the matrix to an architecture review, or need the pillar mapping and the source list
references/llm-anti-patterns.mdAn AI assistant is generating or reviewing the matrix — the seven ways it goes wrong
scripts/check_raci.pyEvery time the artefact changes: --file <raci.yaml> --repo-root <repo> --strict
templates/raci-matrix.mdYou are producing the deliverable — the matrix, escalation, refusal map, and YAML shape to fill
templates/stakeholder-raci-for-sf-projects-template.mdYou are starting an engagement — the intake sheet that captures context before any cell is filled

Package files