salesforce-claude-code

Salesforce Claude Code (SCC)

The complete AI development system for Salesforce — expert agents, automated quality gates, and institutional knowledge, powered by @salesforce/mcp

SCC (scc-universal on npm) is a Claude Code plugin that supercharges your Salesforce development workflow with 17 expert subagents, 55 domain knowledge skills, and 29 automated quality gates. Built for Apex, LWC, SOQL, Flow, Visualforce, Aura, DevOps, and Agentforce — covering every layer of the Salesforce platform.

---

How It Works

SCC is a unified system where each layer serves a distinct role:

Layer	What It Does	Examples
@salesforce/mcp	Platform capabilities — query orgs, deploy metadata, run tests, analyze code	Org management, SOQL queries, Apex test execution
17 Agents	Lean full-stack agents that design, build, test, and review	sf-architect, sf-apex-agent, sf-lwc-agent, sf-review-agent
55 Skills	Institutional knowledge + workflows — 17 user-invocable via /skill-name, 38 auto-activating	/sf-help, /sf-quickstart, /configure-scc, /sessions
7 Constraint Skills	Always-on governance via auto-activating skills	sf-apex-constraints, sf-soql-constraints, sf-security-constraints, sf-trigger-constraints
29 Hooks	Automated enforcement — quality gates run on every code change	SOQL-in-loop detection, PMD via sf scanner, privilege escalation checks

Together: @salesforce/mcp gives Claude the hands to work with Salesforce. SCC gives Claude the brain to work well.

---

What's Included

Category	Count	Description
Agents	17	Specialized Salesforce subagents (11 domain + 6 platform)
Skills	55	Domain knowledge + workflow modules (17 user-invocable, 38 auto-activating)
Hooks	29	Automated quality gates (SessionStart, PreToolUse, PostToolUse, PostToolUseFailure, PreCompact, Stop, SessionEnd)
Harnesses	2	Claude Code, Cursor

---

Requirements

• Node.js >= 20 — required to run the npx scc-universal CLI
• Python 3.x — required for learning-engine agent (instinct CLI)

---

Quick Install

For Claude Code

# Install everything (agents → .claude/agents/, skills → .claude/skills/, hooks → .claude/settings.json)
npx scc-universal install

# Install only Apex-focused content
npx scc-universal install apex

# Install only LWC-focused content
npx scc-universal install lwc

For Cursor

# Install everything (agents → .cursor/agents/, skills → .cursor/skills/, hooks → .cursor/hooks.json)
npx scc-universal install --target cursor

# Install only Apex-focused content
npx scc-universal install apex --target cursor

Diagnose and Repair

npx scc-universal doctor       # Check for missing/drifted files
npx scc-universal repair       # Restore drifted files
npx scc-universal status       # View installed components
npx scc-universal uninstall    # Remove SCC-managed files

CLI Reference

Command	Description
scc-universal install [profile]	Install SCC content (default: full profile, claude target)
scc-universal plan	Preview install manifest (dry run)
scc-universal list-installed	Show currently installed SCC files
scc-universal doctor	Diagnose missing or drifted files
scc-universal repair	Restore drifted files
scc-universal status	Query JSON state store
scc-universal sessions	List saved sessions
scc-universal uninstall	Remove SCC-managed files

Install flags:

Flag	Description
--profile <name>	Install profile: apex, lwc, or full (default)
--target <harness>	Target harness: claude (default) or cursor
--dry-run	Preview changes without applying
--json	Output in JSON format

What Gets Installed

Component	Claude Code (--target claude)	Cursor (--target cursor)
Agents	.claude/agents/*.md	.cursor/agents/*.md
Skills	.claude/skills/*/SKILL.md	.cursor/skills/*/SKILL.md
Hooks	Merged into .claude/settings.json	.cursor/hooks.json
MCP config	.mcp.json (project root)	.cursor/mcp.json

Install Profiles

SCC content is organized into 7 modules. Profiles compose subsets: