scc-universal 1.1.0 → 1.2.0

package/docs/workflow-examples.md

@@ -27,10 +27,10 @@ Plan an AccountRatingService that rates accounts as Hot (>= $1M revenue), Warm (
 ### Step 2 -- Write Tests First (Red Phase)
 
 ```
-/sf-tdd-workflow Create an AccountRatingService that rates accounts based on AnnualRevenue
+Create an AccountRatingService that rates accounts based on AnnualRevenue. Use TDD — write tests first.
 ```
 
-**Agent invoked**: `sf-apex-agent`
+**Agent invoked**: `sf-apex-agent` (consults `sf-tdd-workflow` pattern skill)
 
 **What happens**:
 
@@ -67,10 +67,10 @@ sf apex run test --class-names AccountRatingServiceTest --target-org MyScratchOr
 ### Step 4 -- Review the Code
 
 ```
-/sf-apex-best-practices Review AccountRatingService.cls
+Review AccountRatingService.cls for best practices
 ```
 
-**Agent invoked**: `sf-review-agent`
+**Agent invoked**: `sf-review-agent` (consults `sf-apex-best-practices` pattern skill)
 
 **What happens**: The reviewer checks the implementation against its checklist:
 
@@ -92,10 +92,10 @@ With green tests as a safety net, refactor:
 - Run tests after each change to confirm they still pass
 
 ```
-/sf-governor-limits Check AccountRatingService for governor limit risks
+Check AccountRatingService for governor limit risks
 ```
 
-**Agent invoked**: `sf-apex-agent`
+**Agent invoked**: `sf-apex-agent` (consults `sf-governor-limits` pattern skill)
 
 **Expected outcome**: Clean audit -- no governor limit risks in pure in-memory logic.
 
@@ -112,10 +112,10 @@ You need to create an `accountRatingCard` LWC that displays an account's rating
 ### Step 1 -- Scaffold the Component
 
 ```
-/sf-lwc-development Create an accountRatingCard component that shows account name, rating badge (Hot=red, Warm=orange, Cold=blue), and annual revenue
+Create an accountRatingCard LWC component that shows account name, rating badge (Hot=red, Warm=orange, Cold=blue), and annual revenue
 ```
 
-**Agent invoked**: `sf-lwc-agent`
+**Agent invoked**: `sf-lwc-agent` (consults `sf-lwc-development` pattern skill)
 
 **What happens**: Reviews the plan for the component and provides guidance on:
 
@@ -144,7 +144,7 @@ The agent creates four files:
 ### Step 3 -- Write Jest Tests
 
 ```
-/sf-tdd-workflow Write Jest tests for the accountRatingCard LWC component
+Write Jest tests for the accountRatingCard LWC component. Tests first.
 ```
 
 **What happens**: Creates `__tests__/accountRatingCard.test.js` with:
@@ -182,10 +182,10 @@ npx lwc-jest --coverage
 ### Step 5 -- Accessibility Review
 
 ```
-/sf-lwc-development Review accountRatingCard for accessibility compliance
+Review accountRatingCard for accessibility compliance
 ```
 
-**Agent invoked**: `sf-lwc-agent`
+**Agent invoked**: `sf-lwc-agent` (consults `sf-lwc-development` pattern skill)
 
 **What it checks**:
 
@@ -200,10 +200,10 @@ npx lwc-jest --coverage
 ### Step 6 -- Deploy to Scratch Org
 
 ```
-/sf-deployment Deploy accountRatingCard and AccountRatingService to scratch org
+Deploy accountRatingCard and AccountRatingService to scratch org
 ```
 
-**Agent invoked**: `sf-architect`
+**Agent invoked**: `sf-architect` (consults `sf-deployment` pattern skill)
 
 **Hook activity**:
 
@@ -219,10 +219,10 @@ Full development lifecycle from scratch org creation through production deployme
 ### Step 1 -- Create a Scratch Org
 
 ```
-/sf-deployment Create a new scratch org for feature/account-rating
+Create a new scratch org for feature/account-rating
 ```
 
-**Agent invoked**: `sf-architect`
+**Agent invoked**: `sf-architect` (consults `sf-deployment` pattern skill)
 
 **What happens**:
 
@@ -262,7 +262,7 @@ Use the Apex TDD workflow (Workflow 1) and LWC development workflow (Workflow 2)
 ### Step 3 -- Run All Tests
 
 ```
-/sf-apex-testing Run all local tests in the scratch org
+Run all local tests in the scratch org
 ```
 
 **What happens**:
@@ -276,10 +276,10 @@ sf apex run test --target-org account-rating --test-level RunLocalTests --code-c
 ### Step 4 -- Validate Against Staging
 
 ```
-/sf-deployment Validate deployment to staging (dry run)
+Validate deployment to staging (dry run)
 ```
 
-**Agent invoked**: `sf-architect`
+**Agent invoked**: `sf-architect` (consults `sf-deployment` pattern skill)
 
 ```bash
 sf project deploy validate --source-dir force-app/ --target-org Staging --test-level RunLocalTests --wait 30
@@ -327,10 +327,10 @@ Run a comprehensive security audit on the codebase, fix findings, and verify the
 ### Step 1 -- Run the Security Scan
 
 ```
-/sf-security Run a full security audit on force-app/
+Run a full security audit on force-app/
 ```
 
-**Agent invoked**: `sf-review-agent`
+**Agent invoked**: `sf-review-agent` (consults `sf-security` pattern skill)
 
 **What happens**: The security reviewer performs a multi-pass analysis:
 
@@ -386,7 +386,7 @@ Address each finding by severity, starting with CRITICAL:
 **Fix SOQL injection:**
 
 ```
-/sf-apex-best-practices Fix the SOQL injection in AccountQueryController.cls
+Fix the SOQL injection in AccountQueryController.cls
 ```
 
 The agent replaces string concatenation with bind variables:
@@ -428,7 +428,7 @@ List<Contact> contacts = [SELECT Id, Name, Email FROM Contact WHERE AccountId =
 ### Step 3 -- Re-Scan
 
 ```
-/sf-security Re-scan force-app/ to verify all security findings are resolved
+Re-scan force-app/ to verify all security findings are resolved
 ```
 
 **Expected output**:
@@ -466,10 +466,10 @@ Identify and fix performance bottlenecks in an existing Salesforce codebase.
 ### Step 1 -- Run the Governor Audit
 
 ```
-/sf-governor-limits Scan force-app/main/default/classes/ for governor limit risks
+Scan force-app/main/default/classes/ for governor limit risks
 ```
 
-**Agent invoked**: `sf-apex-agent`
+**Agent invoked**: `sf-apex-agent` (consults `sf-governor-limits` pattern skill)
 
 **What happens**: The agent scans all Apex classes and triggers for:
 
@@ -512,10 +512,10 @@ MEDIUM (1):
 ### Step 2 -- Optimize SOQL Queries
 
 ```
-/sf-soql-optimization Optimize the SOQL queries in OrderProcessor.cls
+Optimize the SOQL queries in OrderProcessor.cls
 ```
 
-**Agent invoked**: `sf-apex-agent`
+**Agent invoked**: `sf-apex-agent` (consults `sf-soql-optimization` pattern skill)
 
 **What happens**: The agent refactors the code to move queries outside loops:
 
@@ -555,10 +555,10 @@ for (Order__c order : orders) {
 ### Step 3 -- Fix the Trigger Bulkification
 
 ```
-/sf-trigger-frameworks Refactor AccountTrigger to use a handler pattern with proper bulkification
+Refactor AccountTrigger to use a handler pattern with proper bulkification
 ```
 
-**Agent invoked**: `sf-architect`
+**Agent invoked**: `sf-architect` (consults `sf-trigger-frameworks` pattern skill)
 
 **What happens**: Converts the non-bulkified trigger into the thin-trigger-fat-handler pattern:
 
@@ -580,7 +580,7 @@ trigger AccountTrigger on Account (
 Run tests that exercise the refactored code with 200 records (the standard trigger batch size):
 
 ```
-/sf-apex-testing Run tests for OrderProcessor and AccountTriggerHandler with bulk data verification
+Run tests for OrderProcessor and AccountTriggerHandler with bulk data verification
 ```
 
 ```bash
@@ -595,7 +595,7 @@ sf apex run test --class-names OrderProcessorTest,AccountTriggerHandlerTest --ta
 ### Step 5 -- Re-Audit
 
 ```
-/sf-governor-limits Re-scan force-app/ to verify all governor limit risks are resolved
+Re-scan force-app/ to verify all governor limit risks are resolved
 ```
 
 **Expected output**:
@@ -617,10 +617,10 @@ All critical and high severity findings resolved.
 ### Step 6 -- Performance Validation
 
 ```
-/sf-governor-limits Run a comprehensive performance audit including SOQL query analysis
+Run a comprehensive performance audit including SOQL query analysis
 ```
 
-**Agent invoked**: `sf-apex-agent`
+**Agent invoked**: `sf-apex-agent` (consults `sf-governor-limits` pattern skill)
 
 **What it checks beyond governor limits**:
 
@@ -636,10 +636,10 @@ All critical and high severity findings resolved.
 
 ## Summary: Commands, Agents, and Hooks by Workflow
 
-| Workflow | Primary Commands | Agents Invoked | Key Hooks |
+| Workflow | Pattern Skills Consulted | Agents Invoked | Key Hooks |
 |---|---|---|---|
-| Apex TDD | `/sf-tdd-workflow`, `/sf-apex-best-practices`, `/sf-governor-limits` | sf-apex-agent, sf-review-agent, sf-apex-agent | governor-check, quality-gate, post-write |
-| LWC Development | `/sf-lwc-development`, `/sf-deployment` | sf-lwc-agent, sf-architect | post-write, post-edit-console-warn, sfdx-validate |
-| Deployment Pipeline | `/sf-deployment`, `/sf-apex-testing`, `/sf-deployment` | sf-architect, sf-architect, sf-review-agent | session-start, sfdx-validate, post-bash-build-complete |
-| Security Audit | `/sf-security`, `/sf-apex-best-practices` | sf-review-agent, sf-review-agent | governor-check, quality-gate, sfdx-scanner-check |
-| Performance Optimization | `/sf-governor-limits`, `/sf-soql-optimization`, `/sf-trigger-frameworks`, `/sf-governor-limits` | sf-apex-agent, sf-apex-agent, sf-architect | governor-check, quality-gate, sfdx-validate |
+| Apex TDD | `sf-tdd-workflow`, `sf-apex-best-practices`, `sf-governor-limits` | sf-apex-agent, sf-review-agent | governor-check, quality-gate, post-write |
+| LWC Development | `sf-lwc-development`, `sf-deployment` | sf-lwc-agent, sf-architect | post-write, post-edit-console-warn, sfdx-validate |
+| Deployment Pipeline | `sf-deployment`, `sf-apex-testing` | sf-architect, sf-review-agent | session-start, sfdx-validate, post-bash-build-complete |
+| Security Audit | `sf-security`, `sf-apex-best-practices` | sf-review-agent | governor-check, quality-gate, sfdx-scanner-check |
+| Performance Optimization | `sf-governor-limits`, `sf-soql-optimization`, `sf-trigger-frameworks` | sf-apex-agent, sf-architect | governor-check, quality-gate, sfdx-validate |

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "../schemas/hooks.schema.json",
+  "description": "Salesforce Claude Code (SCC) lifecycle hooks — automated quality gates for Apex, LWC, and Salesforce CLI",
   "hooks": {
     "SessionStart": [
       {
@@ -10,8 +10,7 @@
             "async": true,
             "timeout": 15
           }
-        ],
-        "description": "Display Salesforce project context: detected org, scratch orgs, CLI version"
+        ]
       },
       {
         "hooks": [
@@ -21,8 +20,7 @@
             "async": true,
             "timeout": 5
           }
-        ],
-        "description": "Warn if platform reference docs (deprecations, API versions) are outdated"
+        ]
       }
     ],
     "PreToolUse": [
@@ -33,23 +31,27 @@
             "type": "command",
             "command": "npx block-no-verify@1.1.2"
           }
-        ],
-        "description": "Block git hook-bypass flag to protect pre-commit, commit-msg, and pre-push hooks from being skipped"
+        ]
       },
       {
-        "matcher": "*",
+        "matcher": "",
         "hooks": [
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:mcp-health-check\" standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/mcp-health-check.js\""
           }
-        ],
-        "description": "Check MCP server health before MCP tool execution and block unhealthy MCP calls"
+        ]
       },
       {
-        "matcher": "*",
-        "hooks": [{ "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"pre:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"", "async": true, "timeout": 10 }],
-        "description": "Capture tool use observations for continuous learning"
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"pre:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"",
+            "async": true,
+            "timeout": 10
+          }
+        ]
       },
       {
         "matcher": "Bash",
@@ -60,8 +62,7 @@
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Validate Salesforce CLI commands before execution (deprecation + danger warnings)"
+        ]
       },
       {
         "matcher": "Write",
@@ -72,8 +73,7 @@
             "async": true,
             "timeout": 5
           }
-        ],
-        "description": "Warn about non-standard documentation files"
+        ]
       },
       {
         "matcher": "Bash",
@@ -84,8 +84,7 @@
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Validate SFDX commands for best practices (deploy flags, dry-run suggestions)"
+        ]
       },
       {
         "matcher": "Bash",
@@ -96,32 +95,30 @@
             "async": true,
             "timeout": 5
           }
-        ],
-        "description": "Remind to review changes before git push"
+        ]
       },
       {
         "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
+            "if": "Bash(git push*|sf project deploy*)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" sfdx-scanner-check standard,strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/sfdx-scanner-check.js\"",
-            "async": true,
             "timeout": 45
           }
-        ],
-        "description": "Run sfdx-scanner PMD analysis before git push/sf deploy (standard and strict profiles)"
+        ]
       },
       {
         "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
+            "if": "Bash(sf project deploy*|sf org create*|sf apex run test*|npm test*)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-bash-tmux-reminder strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-bash-tmux-reminder.js\"",
             "async": true,
             "timeout": 5
           }
-        ],
-        "description": "Remind to use tmux for long-running Salesforce CLI commands (deploy, test, scratch org)"
+        ]
       },
       {
         "matcher": "Edit|Write",
@@ -132,15 +129,20 @@
             "async": true,
             "timeout": 5
           }
-        ],
-        "description": "Track tool call count and suggest strategic compaction"
+        ]
       }
     ],
     "PostToolUse": [
       {
-        "matcher": "*",
-        "hooks": [{ "type": "command", "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"post:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"", "async": true, "timeout": 10 }],
-        "description": "Capture tool use results for continuous learning"
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags-shell.sh\" \"post:observe\" \"scripts/hooks/learning-observe.sh\" \"standard,strict\"",
+            "async": true,
+            "timeout": 10
+          }
+        ]
       },
       {
         "matcher": "Write",
@@ -151,8 +153,7 @@
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Detect Apex/LWC file writes and remind about test coverage"
+        ]
       },
       {
         "matcher": "Edit",
@@ -163,32 +164,32 @@
             "async": true,
             "timeout": 15
           }
-        ],
-        "description": "Run quality checks on edited Apex/LWC files (anti-patterns, common issues)"
+        ]
       },
       {
         "matcher": "Edit",
         "hooks": [
           {
             "type": "command",
+            "if": "Edit(*.cls|*.trigger)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" governor-check standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/governor-check.js\"",
             "async": true,
-            "timeout": 10
+            "timeout": 10,
+            "statusMessage": "Checking governor limits..."
           }
-        ],
-        "description": "Check edited Apex files for governor limit violations (SOQL/DML in loops)"
+        ]
       },
       {
         "matcher": "Edit",
         "hooks": [
           {
             "type": "command",
+            "if": "Edit(*.js|*.ts|*.jsx|*.tsx)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-console-warn standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-edit-console-warn.js\"",
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Warn about console.log statements in edited JS/LWC files"
+        ]
       },
       {
         "matcher": "Edit",
@@ -199,20 +200,19 @@
             "async": true,
             "timeout": 15
           }
-        ],
-        "description": "Auto-format edited files with Prettier (strict profile only)"
+        ]
       },
       {
         "matcher": "Edit",
         "hooks": [
           {
             "type": "command",
+            "if": "Edit(*.ts|*.tsx)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-edit-typecheck strict \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-edit-typecheck.js\"",
             "async": true,
             "timeout": 30
           }
-        ],
-        "description": "Type-check edited TypeScript/LWC files (strict profile only)"
+        ]
       },
       {
         "matcher": "Bash",
@@ -223,32 +223,30 @@
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Detect build/deploy completion and log notice"
+        ]
       },
       {
         "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
+            "if": "Bash(gh pr create*)",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" post-bash-pr-created standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/post-bash-pr-created.js\"",
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Detect PR creation and log review command"
+        ]
       }
     ],
     "PostToolUseFailure": [
       {
-        "matcher": "*",
+        "matcher": "",
         "hooks": [
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"post:mcp-health-check\" standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/mcp-health-check.js\""
           }
-        ],
-        "description": "Track failed MCP tool calls, mark unhealthy servers, and attempt reconnect"
+        ]
       }
     ],
     "PreCompact": [
@@ -257,11 +255,9 @@
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" pre-compact minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-compact.js\"",
-            "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Save session state before context compaction"
+        ]
       }
     ],
     "Stop": [
@@ -270,44 +266,36 @@
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/stop-hook.js\"",
-            "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Summarize Salesforce changes and suggest next steps"
+        ]
       },
       {
         "hooks": [
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" check-console-log standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/check-console-log.js\"",
-            "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Check for console.log statements in modified LWC/JS files"
+        ]
       },
       {
         "hooks": [
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" session-end standard \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-end.js\"",
-            "async": true,
             "timeout": 15
           }
-        ],
-        "description": "Persist session summary for cross-session continuity"
+        ]
       },
       {
         "hooks": [
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" cost-tracker minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/cost-tracker.js\"",
-            "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Track token usage and estimated costs per session"
+        ]
       },
       {
         "hooks": [
@@ -317,8 +305,7 @@
             "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Evaluate session for extractable patterns and learned skills"
+        ]
       }
     ],
     "SessionEnd": [
@@ -327,11 +314,9 @@
           {
             "type": "command",
             "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" session-end-marker minimal \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-end-marker.js\"",
-            "async": true,
             "timeout": 10
           }
-        ],
-        "description": "Session end lifecycle marker (non-blocking)"
+        ]
       }
     ]
   }

package/manifests/install-modules.json

@@ -4,7 +4,7 @@
     {
       "id": "core",
       "kind": "bundle",
-      "description": "Core baseline — architect, review agent, core skills, lifecycle hooks",
+      "description": "Core baseline — architect, review agent, core skills, quality gates",
       "pathGroups": [
         {
           "paths": [
@@ -24,8 +24,10 @@
           "targets": { "claude": ".claude/skills/", "cursor": ".cursor/skills/" }
         },
         {
-          "paths": ["hooks/hooks.json", "scripts/hooks/"],
-          "targets": { "claude": ".claude/hooks/", "cursor": null }
+          "paths": ["scripts/hooks/"],
+          "targets": { "claude": ".claude/", "cursor": null },
+          "installType": "hooks",
+          "hooksSource": "hooks/hooks.json"
         }
       ],
       "dependencies": [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scc-universal",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Complete collection of production-ready Salesforce agents, skills, hooks, and MCP configurations for Claude Code and other AI harnesses. Salesforce Claude Code (SCC) — your AI-powered Salesforce development partner.",
   "keywords": [
     "salesforce",
@@ -57,7 +57,7 @@
     ".cursor-plugin/plugin.json"
   ],
   "bin": {
-    "scc": "scripts/scc.js",
+    "scc-universal": "scripts/scc.js",
     "scc-install": "scripts/cli/install-apply.js"
   },
   "scripts": {
@@ -65,6 +65,7 @@
     "build:cursor-skills": "node scripts/dev/build-cursor-skills.js",
     "build:cursor-agents": "node scripts/dev/build-cursor-agents.js",
     "test": "npm run build && node scripts/ci/validate-agents.js && node scripts/ci/validate-commands.js && node scripts/ci/validate-skills.js && node scripts/ci/validate-hooks.js && node scripts/ci/validate-install-manifests.js && node scripts/ci/validate-no-personal-paths.js && node tests/run-all.js",
+    "smoke": "bash scripts/ci/smoke-test.sh",
     "lint": "eslint . && markdownlint '**/*.md' --ignore node_modules",
     "coverage": "c8 --all --include=\"scripts/**/*.js\" --exclude=\"scripts/scc.js\" --reporter=text --reporter=lcov --check-coverage --lines 80 --functions 80 --branches 80 --statements 80 node tests/run-all.js",
     "harness:audit": "node scripts/dev/harness-audit.js",
@@ -72,7 +73,7 @@
     "orchestrate:tmux": "node scripts/dev/orchestrate-worktrees.js",
     "version:bump": "node scripts/dev/bump-version.js",
     "version:sync": "node scripts/dev/bump-version.js --set",
-    "postinstall": "node -e \"console.log('\\n\\x1b[36m╔══════════════════════════════════════════╗\\x1b[0m'); console.log('\\x1b[36m║  Salesforce Claude Code (SCC) installed  ║\\x1b[0m'); console.log('\\x1b[36m╚══════════════════════════════════════════╝\\x1b[0m'); console.log('\\nRun: npx scc install apex  (or lwc, all)\\n');\""
+    "postinstall": "node -e \"console.log('\\n\\x1b[36m╔══════════════════════════════════════════╗\\x1b[0m'); console.log('\\x1b[36m║  Salesforce Claude Code (SCC) installed  ║\\x1b[0m'); console.log('\\x1b[36m╚══════════════════════════════════════════╝\\x1b[0m'); console.log('\\nRun: npx scc-universal install  (or: install apex, install lwc)\\n');\""
   },
   "dependencies": {},
   "devDependencies": {