setup-agents

Rule composition

Role Profiles

Twenty-two combinable profiles, each tailored to a specific Salesforce role.

Role-Aware AI Rules

Each profile generates a dedicated .mdc rule file in .cursor/rules/ and contributes extensions to .vscode/extensions.json. Profiles are combinable — stack multiple roles with a comma-separated list. All rules use alwaysApply: true so every AI agent in the project has full context.

# Single profile
sf setup-agents local --profile developer

# Multiple combined profiles
sf setup-agents local --profile developer,architect,cgcloud,qa

Catalog

All Profiles

Profile Flag Rule File Auto-detect Signal
Developer developer developer-standards.mdc Default (no signal needed)
Architect architect architect-standards.mdc
Business Analyst ba ba-standards.mdc
Project Manager pm pm-standards.mdc
MuleSoft mulesoft mulesoft-standards.mdc mule-artifact.json · pom.xml
UX / UI ux ux-standards.mdc
CGCloud cgcloud cgcloud-standards.mdc cgcloud__ namespace in package.xml
DevOps / Release Manager devops devops-standards.mdc azure-pipelines.yml
QA (Playwright) qa qa-standards.mdc playwright.config.ts · playwright.config.js
CRM Analytics crma analytics-standards.mdc WaveDashboard · WaveDataflow in package.xml
Data Cloud data360 data360-standards.mdc DataStream · DataModelObject in package.xml
Admin / Configurator admin admin-standards.mdc force-app/ directory
Marketing Cloud (SFMC) sfmc sfmc-standards.mdc .ampscript files · mc-project.json
Commerce Cloud (B2B/B2C) commerce commerce-standards.mdc dw.json · cartridges/ · B2B metadata
Security / Compliance security security-standards.mdc force-app/ directory
Service Cloud service service-standards.mdc objects/Case/ · entitlementProcesses/ · bots/
CPQ Specialist cpq cpq-standards.mdc SBQQ__Quote__c directory or SBQQ__ metadata
OmniStudio / Vlocity omnistudio omnistudio-standards.mdc omniScripts/ · flexCards/
Field Service (FSL) fsl fsl-standards.mdc objects/ServiceAppointment/ · objects/WorkOrder/
AI / Agentforce Specialist ai ai-standards.mdc bots/ · aiApplications/
Slack Developer (Bolt.js) slack slack-standards.mdc slack.json · manifest.json
Tableau / Analytics Cloud tableau tableau-standards.mdc datasources/ · workbooks/ · tableau-project.json

Coverage

Profile Highlights

Developer

Apex trigger strategy (Kevin O'Hara), with sharing enforcement, SOQL/DML bulkification, one Assert per test, 90% coverage target, semantic commits.

Architect

Architecture decision records (ADR), scalability patterns, sharing strategy analysis, async Apex design, integration architecture, unlocked package strategy.

Business Analyst

Requirements documentation, user story templates, Salesforce flow strategy (sub-flows), flow orchestration, acceptance criteria definition.

Project Manager

Sprint planning with Gantt timelines, weekly status reports, risk register management, release coordination, RACI matrix generation, Mermaid diagrams.

MuleSoft

API-led connectivity, Connected App patterns, Named Credentials, without sharing for REST endpoints, integration error handling.

CGCloud

Consumer Goods Cloud namespace conventions (cgcloud__), route planning constraints, visiting hours logic, territory management patterns.

DevOps

Branching naming strategy, scratch org pooling, deployment validation, package version management, CI/CD pipeline configuration.

QA

Playwright-based E2E automation, TestSetup + System.runAs for Apex, permission set group setup, accessibility (WCAG) test patterns.

CRM Analytics

WaveDashboard/WaveDataflow metadata strategy, SAQL query standards, recipe orchestration, Analytics Studio best practices.

Admin / Configurator

No Mega-Flows, Sub-flows, one RTF per object/context. Validation rules with $Permission.Bypass_Validation_Rules. Permission Sets over Profiles. CMDT for deployable config. Process Automation Decision Tree.

Marketing Cloud (SFMC)

AMPscript & SSJS best practices, Journey Builder design, SQL on Data Extensions, Content Builder structure, Automation Studio — completely independent of core Salesforce stack.

Commerce Cloud (B2B/B2C)

B2C: SFRA controllers, ISML templates, cartridge layering, OCAPI/SCAPI. B2B: ConnectApi checkout flows, buyer groups, LWC storefront. Clear section separation between both stacks.

Security / Compliance

WITH SECURITY_ENFORCED & stripInaccessible, CRUD checks, Platform Encryption (Shield), OWD & sharing rules, Named Credentials, Health Check 90+, OWASP Top 10 for Salesforce.

Service Cloud

Case assignment & escalation rules, entitlement processes & milestones, Knowledge article publishing, Omni-Channel routing (queue-based and skills-based), Einstein Bots, Messaging channels.

CPQ Specialist

Product bundles & option constraints, pricing rules with evaluation order, discount schedules, quote templates, approval chains, contract & subscription management, CPQ Apex plugins.

OmniStudio / Vlocity

OmniScript step design, DataRaptor naming conventions, Integration Procedures for reusable orchestration, FlexCard composition, Decision Matrices, and source-controlled export/import.

Field Service (FSL)

Work order lifecycle, service appointment scheduling, soft/hard constraint policies, territory & resource management, mobile page layouts, maintenance plans, Dispatcher Console configuration.

AI / Agentforce Specialist

Agentforce agent design, bot topic & action mapping, Einstein AI policy, prompt template standards, agent testing strategy, and integration with Data Cloud for grounding.

Slack Developer (Bolt.js)

Bolt.js app structure, ack() within 3 seconds, request signature verification, slash commands, modals, Block Kit composition, and Salesforce integration patterns.

Tableau / Analytics Cloud

Data source strategy (live vs extract), LOD expressions, dashboard performance, row-level security via User Attribute Functions, CRM Analytics recipes, and Tableau Embedding API v3.

Coordination

Sub-agent Protocol

When multiple profiles are active, sf setup-agents local generates .cursor/rules/sub-agent-protocol.mdc — a routing manifest that maps task types to the responsible role:

## Active Profiles
| Role                          | Rule File                  |
|-------------------------------|----------------------------|
| Developer                     | developer-standards.mdc    |
| Analytics Engineer (CRMA)     | analytics-standards.mdc    |
| Data Cloud Engineer           | data360-standards.mdc      |

## Task-to-Profile Routing
| Task Type                              | Assigned Role       |
|----------------------------------------|---------------------|
| Apex / LWC / Triggers                  | Developer           |
| Recipes / Dataflows / SAQL             | Analytics Engineer  |
| Data Streams / Identity Resolution     | Data Cloud Engineer |

Agentforce

Agentforce Workflows by Profile

When using --rules agentforce, each profile contributes workflow files to .a4drules/workflows/. Invoke them in chat with /[workflow-name.md].

Workflow Generated For Description
deploy.mdAll Salesforce projectsGuided component deploy
run-tests.mdAll Salesforce projectsRun Apex tests with coverage
validate.mdAll Salesforce projectsValidate-only deploy (CI-safe)
create-apex-class.mdDeveloperCreate Apex class following project standards
create-lwc.mdDeveloperScaffold LWC with SLDS best practices
create-trigger.mdDeveloperCreate trigger using Kevin O'Hara pattern
adr.mdArchitectArchitecture Decision Record template
release.mdDevOpsRelease checklist and deployment plan
create-scratch-org.mdDevOpsScratch org setup with permission sets
run-playwright.mdQARun Playwright tests and capture report
generate-test-report.mdQAGenerate test coverage report
sprint-plan.mdPMCreate sprint plan with Gantt timeline
status-report.mdPMGenerate weekly status report
risk-register.mdPMMaintain project risk register
deploy-analytics.mdCRMADeploy CRM Analytics dashboards
create-flow.mdAdminCreate a Record-Triggered Flow with fault path and sub-flow pattern
create-validation-rule.mdAdminCreate validation rule with bypass Custom Permission
permission-set-setup.mdAdminConfigure Permission Set with least-privilege principle
create-cloudpage.mdSFMCBuild a CloudPage with AMPscript + SSJS
build-journey.mdSFMCConfigure Journey Builder entry, decision splits, and waits
data-extension-query.mdSFMCWrite optimized SQL query on Data Extensions
create-sfra-controller.mdCommerce (B2C)Scaffold SFRA controller with middleware chain
configure-b2b-checkout.mdCommerce (B2B)Configure B2B checkout flow with ConnectApi
cartridge-overlay.mdCommerce (B2C)Overlay platform cartridge using module.superModule pattern
sharing-model-review.mdSecurityAnalyze OWD and design sharing rules strategy
fls-audit.mdSecurityAudit field-level security across Permission Sets
encryption-strategy.mdSecurityDefine deterministic vs probabilistic encryption plan
case-lifecycle-setup.mdServiceConfigure case record types, queues, assignment rules, and escalation
knowledge-base-structure.mdServiceDesign article types, data categories, and publishing workflow
omni-channel-configuration.mdServiceSet up routing config, capacity model, and presence statuses
product-bundle-setup.mdCPQCreate bundle product with option groups and constraints
pricing-rule.mdCPQConfigure condition-based or lookup pricing rule
approval-chain.mdCPQSet up CPQ native or standard Salesforce approval chain
create-omniscript.mdOmniStudioDesign OmniScript with steps, data integration, and export
build-integration-procedure.mdOmniStudioBuild Integration Procedure with DataRaptors and error handling
design-flexcard.mdOmniStudioConfigure FlexCard data source, layout, and actions
work-order-setup.mdFSLConfigure work order lifecycle, skills, and status transitions
scheduling-policy.mdFSLDefine scheduling objectives, constraints, and territory assignment
mobile-configuration.mdFSLConfigure FSL Mobile page layouts and offline flows
create-agent.mdAI / AgentforceDesign Agentforce agent with topics, actions, and grounding
test-agent.mdAI / AgentforceTest agent with scenario-based evaluation and coverage
deploy-agent.mdAI / AgentforceDeploy agent to production with activation checklist
create-bolt-app.mdSlackScaffold Bolt.js app with event listeners and middleware
add-slash-command.mdSlackAdd slash command with modal response and Salesforce integration
deploy-slack-app.mdSlackDeploy Slack app to production with manifest validation
connect-salesforce-data.mdTableauConnect Tableau to Salesforce via live connection or extract
publish-workbook.mdTableauPublish workbook to Tableau Server / Tableau Cloud with permissions
embed-analytics.mdTableauEmbed Tableau view in Salesforce using Embedding API v3

Ready to configure your team?

Pick your profiles and set up all AI tools with a single command.