scc-universal 1.1.0 → 1.2.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "salesforce-claude-code",
-  "version": "1.1.0",
-  "description": "Production-ready AI agents, skills, and hooks for Salesforce development",
+  "version": "1.2.0",
+  "description": "Production-ready expert subagents, domain skills, and quality gates for Salesforce development",
   "author": {
     "name": "Jiten Singh",
     "email": "jitencseng@gmail.com",

package/.cursor/hooks.json

@@ -1,106 +1,147 @@
 {
+  "version": 1,
   "hooks": {
     "sessionStart": [
       {
-        "command": "node .cursor/hooks/session-start.js",
-        "event": "sessionStart",
-        "description": "Display Salesforce project context: detected org, scratch orgs, CLI version"
-      }
-    ],
-    "sessionEnd": [
+        "command": "node scripts/hooks/session-start.js",
+        "timeout": 15
+      },
       {
-        "command": "node .cursor/hooks/session-end.js",
-        "event": "sessionEnd",
-        "description": "Persist session state and evaluate patterns"
+        "command": "node scripts/hooks/check-platform-docs-age.js",
+        "timeout": 5
       }
     ],
     "beforeShellExecution": [
       {
         "command": "npx block-no-verify@1.1.2",
-        "event": "beforeShellExecution",
-        "description": "Block git hook-bypass flag to protect pre-commit, commit-msg, and pre-push hooks from being skipped"
+        "failClosed": true
       },
       {
-        "command": "node .cursor/hooks/before-shell-execution.js",
-        "event": "beforeShellExecution",
-        "description": "Validate SF CLI commands, SFDX deprecation warnings, git push reminder"
-      }
-    ],
-    "afterShellExecution": [
+        "command": "node scripts/hooks/pre-tool-use.js",
+        "timeout": 10
+      },
       {
-        "command": "node .cursor/hooks/after-shell-execution.js",
-        "event": "afterShellExecution",
-        "description": "PR URL logging, build/deploy completion notice"
-      }
-    ],
-    "afterFileEdit": [
+        "command": "node scripts/hooks/sfdx-validate.js",
+        "timeout": 10
+      },
       {
-        "command": "node .cursor/hooks/after-file-edit.js",
-        "event": "afterFileEdit",
-        "description": "Quality gate, governor checks, console.log warning, auto-format"
-      }
-    ],
-    "beforeReadFile": [
+        "command": "node scripts/hooks/pre-bash-git-push-reminder.js",
+        "timeout": 5
+      },
       {
-        "command": "node .cursor/hooks/before-read-file.js",
-        "event": "beforeReadFile",
-        "description": "Warn when reading sensitive files (.env, .key, .pem)"
-      }
-    ],
-    "beforeSubmitPrompt": [
+        "command": "node scripts/hooks/sfdx-scanner-check.js",
+        "timeout": 45
+      },
       {
-        "command": "node .cursor/hooks/before-submit-prompt.js",
-        "event": "beforeSubmitPrompt",
-        "description": "Detect secrets in prompts (sk-, ghp_, AKIA patterns)"
+        "command": "node scripts/hooks/pre-bash-tmux-reminder.js",
+        "timeout": 5
       }
     ],
-    "subagentStart": [
+    "preToolUse": [
+      {
+        "command": "node scripts/hooks/mcp-health-check.js",
+        "failClosed": true
+      },
+      {
+        "command": "bash scripts/hooks/learning-observe.sh",
+        "timeout": 10
+      },
       {
-        "command": "node .cursor/hooks/subagent-start.js",
-        "event": "subagentStart",
-        "description": "Log agent spawning for observability"
+        "command": "node scripts/hooks/doc-file-warning.js",
+        "timeout": 5,
+        "matcher": "Write"
+      },
+      {
+        "command": "node scripts/hooks/suggest-compact.js",
+        "timeout": 5,
+        "matcher": "Write"
       }
     ],
-    "subagentStop": [
+    "postToolUse": [
       {
-        "command": "node .cursor/hooks/subagent-stop.js",
-        "event": "subagentStop",
-        "description": "Log agent completion"
+        "command": "bash scripts/hooks/learning-observe.sh",
+        "timeout": 10
       }
     ],
-    "afterTabFileEdit": [
+    "afterFileEdit": [
       {
-        "command": "node .cursor/hooks/after-tab-file-edit.js",
-        "event": "afterTabFileEdit",
-        "description": "Auto-format Tab edits"
+        "command": "node scripts/hooks/post-write.js",
+        "timeout": 10
+      },
+      {
+        "command": "node scripts/hooks/quality-gate.js",
+        "timeout": 15
+      },
+      {
+        "command": "node scripts/hooks/governor-check.js",
+        "timeout": 10
+      },
+      {
+        "command": "node scripts/hooks/post-edit-console-warn.js",
+        "timeout": 10
+      },
+      {
+        "command": "node scripts/hooks/post-edit-format.js",
+        "timeout": 15
+      },
+      {
+        "command": "node scripts/hooks/post-edit-typecheck.js",
+        "timeout": 30
       }
     ],
-    "beforeMCPExecution": [
+    "afterShellExecution": [
+      {
+        "command": "node scripts/hooks/post-bash-build-complete.js",
+        "timeout": 10
+      },
       {
-        "command": "node .cursor/hooks/before-mcp-execution.js",
-        "event": "beforeMCPExecution",
-        "description": "Log MCP server/tool invocations for observability"
+        "command": "node scripts/hooks/post-bash-pr-created.js",
+        "timeout": 10
       }
     ],
-    "afterMCPExecution": [
+    "postToolUseFailure": [
       {
-        "command": "node .cursor/hooks/after-mcp-execution.js",
-        "event": "afterMCPExecution",
-        "description": "Log MCP result status (OK/FAILED) for observability"
+        "command": "node scripts/hooks/mcp-health-check.js",
+        "failClosed": true
       }
     ],
     "preCompact": [
       {
-        "command": "node .cursor/hooks/pre-compact.js",
-        "event": "preCompact",
-        "description": "Save state before context compaction"
+        "command": "node scripts/hooks/pre-compact.js",
+        "timeout": 10
       }
     ],
     "stop": [
       {
-        "command": "node .cursor/hooks/stop.js",
-        "event": "stop",
-        "description": "Console.log audit, session summary, cost tracking"
+        "command": "node scripts/hooks/stop-hook.js",
+        "timeout": 10,
+        "loop_limit": 3
+      },
+      {
+        "command": "node scripts/hooks/check-console-log.js",
+        "timeout": 10,
+        "loop_limit": 3
+      },
+      {
+        "command": "node scripts/hooks/session-end.js",
+        "timeout": 15,
+        "loop_limit": 3
+      },
+      {
+        "command": "node scripts/hooks/cost-tracker.js",
+        "timeout": 10,
+        "loop_limit": 3
+      },
+      {
+        "command": "node scripts/hooks/evaluate-session.js",
+        "timeout": 10,
+        "loop_limit": 3
+      }
+    ],
+    "sessionEnd": [
+      {
+        "command": "node scripts/hooks/session-end-marker.js",
+        "timeout": 10
       }
     ]
   }

package/.cursor/skills/configure-scc/SKILL.md

@@ -25,9 +25,9 @@ Interactive guide for installing and configuring Salesforce Claude Code.
 npm install -g scc-universal
 
 # Install with a profile
-npx scc install all      # Everything (all agents, skills, rules)
-npx scc install apex     # Apex-focused development
-npx scc install lwc      # LWC-focused development
+npx scc-universal install all      # Everything (all agents, skills, rules)
+npx scc-universal install apex     # Apex-focused development
+npx scc-universal install lwc      # LWC-focused development
 ```
 
 ### Profile Details
@@ -41,10 +41,10 @@ npx scc install lwc      # LWC-focused development
 ### Diagnostics
 
 ```bash
-npx scc doctor    # Check for missing/drifted files
-npx scc status    # View installed components
-npx scc repair    # Restore drifted files
-npx scc uninstall # Remove SCC-managed files
+npx scc-universal doctor    # Check for missing/drifted files
+npx scc-universal status    # View installed components
+npx scc-universal repair    # Restore drifted files
+npx scc-universal uninstall # Remove SCC-managed files
 ```
 
 ## Hook Configuration
@@ -110,10 +110,10 @@ CLAUDE_PACKAGE_MANAGER=npm
 
 | Problem | Cause | Fix |
 |---------|-------|-----|
-| `npx scc install` fails | Node.js < 20 | Upgrade: `nvm install 20` |
-| Hooks not firing | SCC not installed in project | Run `npx scc doctor` to check |
-| `Permission denied` on hooks | Script not executable | Run `npx scc repair` |
-| Skills not loading | Wrong install profile | Run `npx scc install all` |
+| `npx scc-universal install` fails | Node.js < 20 | Upgrade: `nvm install 20` |
+| Hooks not firing | SCC not installed in project | Run `npx scc-universal doctor` to check |
+| `Permission denied` on hooks | Script not executable | Run `npx scc-universal repair` |
+| Skills not loading | Wrong install profile | Run `npx scc-universal install all` |
 | `sf` command not found | SF CLI not installed | Install: `npm install -g @salesforce/cli` |
 | `sf` commands fail with errors | SF CLI version too old | Upgrade: `npm update -g @salesforce/cli` (SCC requires SF CLI v2.x / `sf` not `sfdx`) |
 | Hooks slow down session | Too many hooks enabled | Switch to `SCC_HOOK_PROFILE=minimal` |
@@ -122,19 +122,19 @@ CLAUDE_PACKAGE_MANAGER=npm
 
 ```bash
 # Full diagnostic report
-npx scc doctor
+npx scc-universal doctor
 
 # See exactly what's installed
-npx scc list-installed
+npx scc-universal list-installed
 
 # Preview what WOULD be installed (dry run)
-npx scc plan apex
+npx scc-universal plan apex
 
 # Check state store
-npx scc status
+npx scc-universal status
 
 # Reset everything and reinstall
-npx scc uninstall && npx scc install all
+npx scc-universal uninstall && npx scc-universal install all
 ```
 
 ### Upgrading SCC
@@ -144,17 +144,17 @@ npx scc uninstall && npx scc install all
 npm install -g scc-universal@latest
 
 # Repair any drifted files after upgrade
-npx scc repair
+npx scc-universal repair
 
 # Verify upgrade
-npx scc doctor
+npx scc-universal doctor
 ```
 
 ## Verification
 
 ```bash
 npm test              # Run all validators
-npx scc doctor        # Check installation health
+npx scc-universal doctor        # Check installation health
 sf --version          # Verify SF CLI is installed
-npx scc status        # Confirm installed components
+npx scc-universal status        # Confirm installed components
 ```

package/.cursor/skills/mcp-server-patterns/SKILL.md

@@ -72,7 +72,7 @@ Use **Zod** (or the SDK's preferred schema format) for input validation.
 
 ### Official @salesforce/mcp Server
 
-MCP config is auto-installed by `npx scc install` (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor). The official `@salesforce/mcp` server provides these toolsets:
+MCP config is auto-installed by `npx scc-universal install` (`.mcp.json` for Claude Code, `.cursor/mcp.json` for Cursor). The official `@salesforce/mcp` server provides these toolsets:
 
 | Toolset | What It Does |
 |---------|-------------|

package/.cursor/skills/sf-harness-audit/SKILL.md

@@ -29,7 +29,7 @@ ls -la .claude/agents/ 2>/dev/null
 ls -la .claude/skills/ 2>/dev/null
 ```
 
-If using SCC CLI: `npx scc status`
+If using SCC CLI: `npx scc-universal status`
 
 ### Step 2 — Score Each Category
 
@@ -110,7 +110,7 @@ SCC Harness Audit
 
   Top Recommendations:
     1. [+1.0] Enable strict hook profile: export SCC_HOOK_PROFILE=strict
-    2. [+0.5] Install all modules: npx scc install all
+    2. [+0.5] Install all modules: npx scc-universal install all
 ```
 
 ### Step 4 — Actionable Recommendations
@@ -119,11 +119,11 @@ For each gap, provide a specific command to fix it:
 
 | Gap | Fix Command |
 |-----|-------------|
-| Missing hooks | `npx scc repair` |
-| Missing domain rules | `npx scc install all` (or target: `npx scc install apex`, `npx scc install lwc`) |
-| Low skill count | `npx scc install all` |
+| Missing hooks | `npx scc-universal repair` |
+| Missing domain rules | `npx scc-universal install all` (or target: `npx scc-universal install apex`, `npx scc-universal install lwc`) |
+| Low skill count | `npx scc-universal install all` |
 | Wrong hook profile | `export SCC_HOOK_PROFILE=strict` |
-| Drifted files | `npx scc doctor` then `npx scc repair` |
+| Drifted files | `npx scc-universal doctor` then `npx scc-universal repair` |
 
 ## Examples
 

package/.cursor/skills/sf-quickstart/SKILL.md

@@ -79,9 +79,9 @@ Based on detection results, recommend the best SCC profile:
 
 | Detected Stack | Recommended Profile | Command |
 |---------------|--------------------|---------|
-| Apex + LWC + Flows + triggers | `all` | `npx scc install all` |
-| Primarily Apex (classes + triggers) | `apex` | `npx scc install apex` |
-| Primarily LWC with some Apex | `lwc` | `npx scc install lwc` |
+| Apex + LWC + Flows + triggers | `all` | `npx scc-universal install all` |
+| Primarily Apex (classes + triggers) | `apex` | `npx scc-universal install apex` |
+| Primarily LWC with some Apex | `lwc` | `npx scc-universal install lwc` |
 
 **Profile details:**
 
@@ -111,16 +111,16 @@ Check that SCC is properly configured:
 
 ```bash
 # Check hooks are loaded
-test -f .claude/hooks/hooks.json && echo "Hooks: ACTIVE" || echo "Hooks: MISSING (run npx scc install)"
+test -f .claude/settings.json && grep -q '"hooks"' .claude/settings.json 2>/dev/null && echo "Hooks: ACTIVE (in settings.json)" || echo "Hooks: MISSING (run npx scc-universal install)"
 
 # Check hook profile
 echo "Hook Profile: ${SCC_HOOK_PROFILE:-standard (default)}"
 
 # Check for governor-check hook
-grep -q "governor-check" .claude/hooks/hooks.json 2>/dev/null && echo "Governor Check: ACTIVE" || echo "Governor Check: MISSING"
+grep -q "governor-check" .claude/settings.json 2>/dev/null && echo "Governor Check: ACTIVE" || echo "Governor Check: MISSING"
 
 # Check for quality-gate hook
-grep -q "quality-gate" .claude/hooks/hooks.json 2>/dev/null && echo "Quality Gate: ACTIVE" || echo "Quality Gate: MISSING"
+grep -q "quality-gate" .claude/settings.json 2>/dev/null && echo "Quality Gate: ACTIVE" || echo "Quality Gate: MISSING"
 ```
 
 ### Step 6 — Report
@@ -143,7 +143,7 @@ Tech Stack Detected:
   Custom Objects:  15
 
 Recommended Profile: all
-  -> npx scc install all
+  -> npx scc-universal install all
 
 SCC Status:
   Hooks:         ACTIVE (standard profile)

package/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "salesforce-claude-code",
-  "version": "1.1.0",
-  "description": "Production-ready AI agents, skills, and hooks for Salesforce development",
+  "version": "1.2.0",
+  "description": "Production-ready expert subagents, domain skills, and quality gates for Salesforce development",
   "author": {
     "name": "Jiten Singh",
     "email": "jitencseng@gmail.com"

package/README.md

@@ -6,7 +6,7 @@
 
 > 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 specialized AI agents, domain skills, lifecycle hooks, and always-on coding rules. Built for Apex, LWC, SOQL, Flow, Visualforce, Aura, DevOps, and Agentforce — covering every layer of the Salesforce platform.
+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.
 
 ---
 
@@ -32,51 +32,64 @@ SCC is a unified system where each layer serves a distinct role:
 |---|---|---|
 | Agents | 17 | Specialized Salesforce subagents (11 domain + 6 platform) |
 | Skills | 55 | Domain knowledge + workflow modules (17 user-invocable, 38 auto-activating) |
-| Hooks | 29 | Lifecycle hooks (SessionStart, PreToolUse, PostToolUse, PostToolUseFailure, PreCompact, Stop, SessionEnd) |
+| 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` CLI
+- **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
+
 ```bash
-# Install everything
-npx scc install all
+# 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
+```
 
-# Install only Apex
-npx scc install apex
+### For Cursor
 
-# Install only LWC
-npx scc install lwc
+```bash
+# 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
+```
 
-# Install only DevOps
-npx scc install devops
+### Diagnose and Repair
 
-# Diagnose / repair installed files
-npx scc doctor
-npx scc repair
+```bash
+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 install <target>` | Install SCC content (apex, lwc, all) |
-| `scc plan` | Preview install manifest (dry run) |
-| `scc list-installed` | Show currently installed SCC files |
-| `scc doctor` | Diagnose missing or drifted files |
-| `scc repair` | Restore drifted files |
-| `scc status` | Query JSON state store |
-| `scc sessions` | List saved sessions |
-| `scc session-inspect` | Inspect a specific session's details |
-| `scc uninstall` | Remove SCC-managed files |
+| `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:**
 
@@ -84,18 +97,25 @@ npx scc repair
 |---|---|
 | `--profile <name>` | Install profile: `apex`, `lwc`, or `full` (default) |
 | `--target <harness>` | Target harness: `claude` (default) or `cursor` |
-| `--config <path>` | Custom install manifest path |
-| `--dry-run` | Preview changes without applying (works with repair, uninstall) |
+| `--dry-run` | Preview changes without applying |
 | `--json` | Output in JSON format |
-| `--yes` | Skip confirmation prompts |
 
-### Install Modules
+### 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:
 
 | Module | Description | Depends On |
 |---|---|---|
-| `core` | Essential agents, core skills, lifecycle hooks | — |
+| `core` | Essential agents, core skills, quality gates | — |
 | `apex` | Apex agents, skills, SOQL, constraints | core |
 | `lwc` | LWC agent, skills, constraints | core |
 | `platform` | Cross-domain agents, universal skills, debugging, integration | core |
@@ -109,12 +129,6 @@ SCC content is organized into 7 modules. Profiles compose subsets:
 | `lwc` | core + lwc + platform + devops + security |
 | `full` | All 7 modules (default) |
 
-### Harness-Specific Instructions
-
-**Claude Code** — files are auto-installed via `npx scc install all`. Agents, skills, commands, rules, and hooks are all activated.
-
-**Cursor** — run `npx scc install all --target cursor`. Agents, skills, rules, and MCP config are auto-installed to `.cursor/` directory.
-
 ---
 
 ## Key Features
@@ -175,11 +189,11 @@ SCC is designed to complement the official [Salesforce MCP server](https://githu
 - **@salesforce/mcp** provides: org management, metadata deployment, SOQL queries, Apex test execution, code analysis, LWC tools, DevOps operations
 - **SCC provides**: domain expertise to use those tools correctly, quality gates to catch mistakes, and institutional knowledge to follow best practices
 
-MCP config is auto-installed by `npx scc install`:
+MCP config is auto-installed by `npx scc-universal install`:
 
 ```bash
-npx scc install all --target claude   # Installs .mcp.json at project root
-npx scc install all --target cursor   # Installs .cursor/mcp.json
+npx scc-universal install all --target claude   # Installs .mcp.json at project root
+npx scc-universal install all --target cursor   # Installs .cursor/mcp.json
 ```
 
 ### Enhanced Quality Gates

package/docs/ARCHITECTURE.md

@@ -14,7 +14,7 @@ Salesforce Claude Code (SCC) is a **plugin harness system** — a collection of
 │                                                           │
 │  ┌──────────┐ ┌──────────┐                               │
 │  │  Agents   │ │  Skills  │                               │
-│  │  (25)     │ │  (55)    │                               │
+│  │  (17)     │ │  (55)    │                               │
 │  └─────┬────┘ └─────┬────┘                               │
 │        │            │                                    │
 │  ┌─────┴────────────┴─────────────────────────────────┐ │
@@ -37,7 +37,7 @@ Salesforce Claude Code (SCC) is a **plugin harness system** — a collection of
 │  └────────────────────────────────────────────────────┘ │
 │                                                           │
 ├─────────────────────────────────────────────────────────┤
-│                    CLI (npx scc)                          │
+│                    CLI (npx scc-universal)                          │
 │   install | doctor | repair | status | sessions          │
 └─────────────────────────────────────────────────────────┘
 ```
@@ -84,7 +84,7 @@ Hooks run at lifecycle events and are gated by profiles:
 
 ### CLI System
 
-The `npx scc` CLI provides:
+The `npx scc-universal` CLI provides:
 
 - `install <profile>` — Install SCC content for a specific profile (core, apex, lwc, devops, security, full)
 - `doctor` — Diagnose missing or drifted files
@@ -111,7 +111,7 @@ SCC uses a JSON state store (`~/.scc/state.json`) to track:
 ## Installation Flow
 
 ```
-npx scc install all
+npx scc-universal install all
     │
     ├── Read manifests/install-profiles.json
     ├── Resolve component list for profile

package/docs/authoring-guide.md

@@ -198,7 +198,7 @@ Platform skills are Salesforce-adapted patterns for AI-assisted development work
 
 ## User-Invocable Skill Authoring
 
-User-invocable skills are skills that users can invoke directly as slash commands (e.g., `/sf-tdd-workflow`, `/sf-security`). They live in `skills/<skill-name>/SKILL.md` alongside standard skills, but include `user-invocable: true` in their frontmatter.
+User-invocable skills are skills that users can invoke directly as slash commands (e.g., `/sf-help`, `/sf-quickstart`, `/checkpoint`). They live in `skills/<skill-name>/SKILL.md` alongside standard skills, but include `user-invocable: true` in their frontmatter.
 
 All commands have been migrated to user-invocable skills. There is no separate `commands/` directory.
 
@@ -284,7 +284,7 @@ sf apex run test --class-names MyTest --target-org <alias>
 - Skills use descriptive names like `sf-apex-best-practices`, `sf-security`, `sf-deployment`.
 - Salesforce-specific skills use the `sf-` prefix: `sf-tdd-workflow`, `sf-deployment`, `sf-security`.
 - Platform skills omit the prefix: `checkpoint`, `strategic-compact`, `save-session`.
-- Users invoke them via `/skill-name` (e.g., `/sf-tdd-workflow`, `/sf-security`, `/checkpoint`).
+- Users invoke user-invocable skills via `/skill-name` (e.g., `/sf-help`, `/sf-quickstart`, `/checkpoint`, `/sessions`).
 
 ## CI Validation