$git clone https://github.com/jiten-singh-shahi/salesforce-claude-codeSalesforce Claude Code Framework: ๐ 17 specialized subagents, 55 domain skills, and 29 hooks for Salesforce development โ Apex, LWC, SOQL, Flows, Visualforce, Aura, Agentforce, DevOps, and Security. Work across Claude Code and Cursor.
| 1 | # Salesforce Claude Code (SCC) |
| 2 | ย |
| 3 | [](https://www.npmjs.com/package/scc-universal) |
| 4 | [](https://opensource.org/licenses/MIT) |
| 5 | [](https://nodejs.org) |
| 6 | ย |
| 7 | > The complete AI development system for Salesforce โ expert agents, automated quality gates, and institutional knowledge, powered by @salesforce/mcp |
| 8 | ย |
| 9 | SCC (`scc-universal` on npm) is a Claude Code plugin that supercharges your Salesforce development workflow with **17 expert subagents**, **57 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. |
| 10 | ย |
| 11 | --- |
| 12 | ย |
| 13 | ## How It Works |
| 14 | ย |
| 15 | SCC is a unified system where each layer serves a distinct role: |
| 16 | ย |
| 17 | | Layer | What It Does | Examples | |
| 18 | |-------|-------------|----------| |
| 19 | | **@salesforce/mcp** | Platform capabilities โ query orgs, deploy metadata, run tests, analyze code | Org management, SOQL queries, Apex test execution | |
| 20 | | **17 Agents** | Lean full-stack agents that design, build, test, and review | `sf-architect`, `sf-apex-agent`, `sf-lwc-agent`, `sf-review-agent` | |
| 21 | | **57 Skills** | Institutional knowledge + workflows โ 18 user-invocable via `/skill-name`, 39 auto-activating | `/sf-help`, `/sf-quickstart`, `/configure-scc`, `/sessions` | |
| 22 | | **7 Constraint Skills** | Always-on governance via auto-activating skills | `sf-apex-constraints`, `sf-soql-constraints`, `sf-security-constraints`, `sf-trigger-constraints` | |
| 23 | | **29 Hooks** | Automated enforcement โ quality gates run on every code change | SOQL-in-loop detection, PMD via sf scanner, privilege escalation checks | |
| 24 | ย |
| 25 | **Together:** `@salesforce/mcp` gives Claude the hands to work with Salesforce. SCC gives Claude the brain to work well. |
| 26 | ย |
| 27 | --- |
| 28 | ย |
| 29 | ## What's Included |
| 30 | ย |
| 31 | | Category | Count | Description | |
| 32 | |---|---|---| |
| 33 | | Agents | 17 | Specialized Salesforce subagents (11 domain + 6 platform) | |
| 34 | | Skills | 57 | Domain knowledge + workflow modules (18 user-invocable, 39 auto-activating) | |
| 35 | | Hooks | 29 | Automated quality gates (SessionStart, PreToolUse, PostToolUse, PostToolUseFailure, PreCompact, Stop, SessionEnd) | |
| 36 | | Harnesses | 2 | Claude Code, Cursor | |
| 37 | ย |
| 38 | --- |
| 39 | ย |
| 40 | ## Requirements |
| 41 | ย |
| 42 | - **Node.js >= 20** โ required to run the `npx scc-universal` CLI |
| 43 | - **Python 3.x** โ required for learning-engine agent (instinct CLI) |
| 44 | ย |
| 45 | --- |
| 46 | ย |
| 47 | ## Quick Install |
| 48 | ย |
| 49 | ### For Claude Code |
| 50 | ย |
| 51 | ```bash |
| 52 | # Install everything (agents โ .claude/agents/, skills โ .claude/skills/, hooks โ .claude/settings.json) |
| 53 | npx scc-universal install |
| 54 | ย |
| 55 | # Install only Apex-focused content |
| 56 | npx scc-universal install apex |
| 57 | ย |
| 58 | # Install only LWC-focused content |
| 59 | npx scc-universal install lwc |
| 60 | ``` |
| 61 | ย |
| 62 | ### For Cursor |
| 63 | ย |
| 64 | ```bash |
| 65 | # Install everything (agents โ .cursor/agents/, skills โ .cursor/skills/, hooks โ .cursor/hooks.json) |
| 66 | npx scc-universal install --target cursor |
| 67 | ย |
| 68 | # Install only Apex-focused content |
| 69 | npx scc-universal install apex --target cursor |
| 70 | ``` |
| 71 | ย |
| 72 | ### Diagnose and Repair |
| 73 | ย |
| 74 | ```bash |
| 75 | npx scc-universal doctor # Check for missing/drifted files |
| 76 | npx scc-universal repair # Restore drifted files |
| 77 | npx scc-universal status # View installed components |
| 78 | npx scc-universal uninstall # Remove SCC-managed files |
| 79 | ``` |
| 80 | ย |
| 81 | ### CLI Reference |
| 82 | ย |
| 83 | | Command | Description | |
| 84 | |---|---| |
| 85 | | `scc-universal install [profile]` | Install SCC content (default: full profile, claude target) | |
| 86 | | `scc-universal plan` | Preview install manifest (dry run) | |
| 87 | | `scc-universal list-installed` | Show currently installed SCC files | |
| 88 | | `scc-universal doctor` | Diagnose missing or drifted files | |
| 89 | | `scc-universal repair` | Restore drifted files | |
| 90 | | `scc-universal status` | Query JSON state store | |
| 91 | | `scc-universal sessions` | List saved sessions | |
| 92 | | `scc-universal uninstall` | Remove SCC-managed files | |
| 93 | ย |
| 94 | **Install flags:** |
| 95 | ย |
| 96 | | Flag | Description | |
| 97 | |---|---| |
| 98 | | `--profile <name>` | Install profile: `apex`, `lwc`, or `full` (default) | |
| 99 | | `--target <harness>` | Target harness: `claude` (default) or `cursor` | |
| 100 | | `--dry-run` | Preview changes without applying | |
| 101 | | `--json` | Output in JSON format | |
| 102 | ย |
| 103 | ### What Gets Installed |
| 104 | ย |
| 105 | | Component | Claude Code (`--target claude`) | Cursor (`--target cursor`) | |
| 106 | |---|---|---| |
| 107 | | Agents | `.claude/agents/*.md` | `.cursor/agents/*.md` | |
| 108 | | Skills | `.claude/skills/*/SKILL.md` | `.cursor/skills/*/SKILL.md` | |
| 109 | | Hooks (config) | Merged into `.claude/settings.json` | `.cursor/hooks.json` | |
| 110 | | Hooks (scripts) | `.claude/hooks/scripts/`, `.claude/hooks/lib/` | `.cursor/hooks/scripts/`, `.cursor/hooks/lib/` | |
| 111 | | MCP config | `.mcp.json` (project root) | `.cursor/mcp.json` | |
| 112 | ย |
| 113 | ### Install Profiles |
| 114 | ย |
| 115 | SCC content is organized into 7 modules. Profiles compose subsets: |
| 116 | ย |
| 117 | | Module | Description | Depends On | |
| 118 | |---|---|---| |
| 119 | | `core` | Essential agents, core skills, quality gates | โ | |
| 120 | | `apex` | Apex agents, skills, SOQL, constraints | core | |
| 121 | | `lwc` | LWC agent, skil |