scc-universal 1.1.0

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

@@ -0,0 +1,142 @@
+---
+name: sf-harness-audit
+description: >-
+  Use when auditing SCC harness for Salesforce development completeness. Check hooks, agents, skills,
+  and rules health for Apex and LWC coverage, and score each category.
+origin: SCC
+user-invocable: true
+---
+
+# SCC Harness Audit — Configuration Health Check
+
+Evaluate the SCC harness configuration and suggest improvements. Checks file existence, content coverage, hook status, and rule completeness.
+
+## When to Use
+
+- When you want to verify that SCC is fully and correctly installed in a project
+- When diagnosing issues with hooks, agents, skills, or rules not activating
+- When preparing for a quality audit or compliance review of your SCC configuration
+- When comparing your current installation against the full SCC profile
+- When you want actionable recommendations to improve your SCC setup
+
+## Workflow
+
+### Step 1 — Scan Installation
+
+Check what's installed in the current project:
+
+```bash
+# Check for SCC installation markers
+ls -la .claude/hooks/ 2>/dev/null
+ls -la .claude/agents/ 2>/dev/null
+ls -la .claude/skills/ 2>/dev/null
+```
+
+If using SCC CLI: `npx scc status`
+
+### Step 2 — Score Each Category
+
+Rate each category 0-10 using these rubrics:
+
+**Hook Coverage (0-10)**
+
+| Score | Criteria |
+|-------|----------|
+| 0-3 | No hooks or only SessionStart |
+| 4-6 | Quality-gate and governor-check active, but missing pre-tool-use hooks |
+| 7-8 | All standard profile hooks active |
+| 9-10 | Strict profile enabled, all hooks active including Code Analyzer integration |
+
+Check: `cat .claude/hooks/hooks.json | grep -c '"command"'` to count active hooks.
+Check: `echo $SCC_HOOK_PROFILE` to verify profile level.
+
+**Agent Coverage (0-10)**
+
+| Score | Criteria |
+|-------|----------|
+| 0-3 | Only platform agents (loop-operator, doc-updater) |
+| 4-6 | Core domain agents (sf-architect, sf-apex-agent, sf-review-agent) |
+| 7-8 | Full domain agents (+ sf-lwc-agent, sf-flow-agent, sf-integration-agent) |
+| 9-10 | Complete coverage including sf-admin-agent, sf-agentforce-agent, sf-bugfix-agent |
+
+Check: `ls .claude/agents/sf-*.md 2>/dev/null | wc -l`
+
+**Skill Coverage (0-10)**
+
+| Score | Criteria |
+|-------|----------|
+| 0-3 | Less than 10 skills |
+| 4-6 | 10-20 skills, core SF patterns covered |
+| 7-8 | 20-35 skills, enterprise patterns included |
+| 9-10 | 35+ skills with full domain coverage |
+
+Check: `find .claude/skills/ -name "SKILL.md" | wc -l`
+
+**Skill Coverage (User-Invocable) (0-10)**
+
+| Score | Criteria |
+|-------|----------|
+| 0-3 | Only basic skills (sf-architect agent, sf-apex-best-practices) |
+| 4-6 | Core workflow skills (sf-deployment, sf-debugging, sf-security) |
+| 7-8 | Testing and security skills (sf-tdd-workflow, sf-governor-limits) |
+| 9-10 | Full suite including discovery (/sf-help, /sf-quickstart) |
+
+Check: `ls .claude/skills/sf-*/SKILL.md 2>/dev/null | wc -l`
+
+**Security Posture (0-10)**
+
+| Score | Criteria |
+|-------|----------|
+| 0-3 | No security hooks or rules |
+| 4-6 | Security rules present, quality-gate active |
+| 7-8 | Governor-check active, sharing model detection, CRUD/FLS rules |
+| 9-10 | Strict profile, Code Analyzer integration, security-reviewer agent active |
+
+### Step 3 — Generate Report
+
+```text
+SCC Harness Audit
+══════════════════════════════════════════
+  Profile:        standard
+  Version:        1.0.0
+  Install Target: claude
+
+  Category Scores:
+    Hook Coverage:     7/10
+    Agent Coverage:    8/10
+    Rule Coverage:     6/10
+    Skill Coverage:    7/10
+    Skill (Invocable): 8/10
+    Security Posture:  7/10
+    ────────────────────────
+    Overall Score:     7.2/10
+
+  Top Recommendations:
+    1. [+1.0] Enable strict hook profile: export SCC_HOOK_PROFILE=strict
+    2. [+0.5] Install all modules: npx scc install all
+```
+
+### Step 4 — Actionable Recommendations
+
+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` |
+| Wrong hook profile | `export SCC_HOOK_PROFILE=strict` |
+| Drifted files | `npx scc doctor` then `npx scc repair` |
+
+## Examples
+
+```
+sf-harness-audit
+sf-harness-audit Check if all Salesforce domains are covered by agents and skills
+sf-harness-audit Report gaps in hook coverage and recommend improvements
+sf-harness-audit Score the security posture of the current SCC installation
+```
+
+## Related
+
+- **Skill**: `/sf-harness-audit` — This skill is the audit tool; no separate agent exists

package/skills/sf-help/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: sf-help
+description: >-
+  Use when asking what SCC can do. Discover SCC agents and skills — organized
+  by Salesforce workflow to answer what tools are available and which to use.
+origin: SCC
+user-invocable: true
+---
+
+# SCC Help — Agent and Skill Discovery
+
+SCC provides **17 agents** for end-to-end Salesforce development and **55 skills** for domain knowledge. Agents are lean workflow orchestrators. Skills carry patterns, examples, and rules.
+
+## When to Use
+
+- Discovering what SCC agents and skills are available
+- Deciding which agent to use for a specific task
+- Onboarding to a project and understanding SCC capabilities
+- Searching by keyword (e.g., "apex", "lwc", "deploy", "test", "security")
+
+## Domain Agents (11)
+
+These agents auto-activate based on your task. Each follows TDD and preloads constraint skills.
+
+| Agent | What It Does |
+|-------|-------------|
+| `sf-architect` | Orchestrator — analyzes requirements, designs solutions, decomposes tasks, runs final review |
+| `sf-apex-agent` | All Apex — classes, triggers, batch, async, callouts, tests (TDD) |
+| `sf-lwc-agent` | All LWC — components, Jest tests, wire service, events, SLDS |
+| `sf-flow-agent` | All Flow — record-triggered, screen, scheduled, approval processes |
+| `sf-admin-agent` | All config — objects, permissions, sharing, metadata, Experience Cloud |
+| `sf-integration-agent` | All integration — REST/SOAP callouts, Named Creds, Platform Events, CDC |
+| `sf-agentforce-agent` | Agentforce — topics, custom Apex actions, prompt templates |
+| `sf-review-agent` | Cross-domain review — security audit, performance, test coverage |
+| `sf-bugfix-agent` | Fix build errors, test failures, deploy issues (minimal diff) |
+| `sf-aura-reviewer` | Review Aura components + migration to LWC |
+| `sf-visualforce-reviewer` | Review Visualforce pages + migration to LWC |
+
+## Platform Agents (6)
+
+| Agent | What It Does |
+|-------|-------------|
+| `deep-researcher` | Multi-source research with citations |
+| `doc-updater` | Documentation sync and codemap generation |
+| `eval-runner` | Evaluate and benchmark performance |
+| `learning-engine` | Instinct-based learning from sessions |
+| `loop-operator` | Autonomous agent loop management |
+| `refactor-cleaner` | Dead code removal and consolidation |
+
+## Constraint Skills (7) — Auto-loaded by agents
+
+These enforce hard rules. Agents preload them via `skills` frontmatter.
+
+| Skill | Rules |
+|-------|-------|
+| `sf-apex-constraints` | Governor limits, bulkification, naming |
+| `sf-lwc-constraints` | Component naming, security, accessibility |
+| `sf-trigger-constraints` | One-trigger-per-object, handler delegation |
+| `sf-security-constraints` | CRUD/FLS, sharing, injection prevention |
+| `sf-testing-constraints` | Coverage, isolation, assertions |
+| `sf-soql-constraints` | Query safety, selectivity |
+| `sf-deployment-constraints` | Deploy safety, test levels, validation |
+
+## Pattern Skills (28) — Read by agents on demand
+
+Agents read these for domain knowledge when the task matches. Not user-invocable.
+
+### Apex
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-apex-best-practices` | Class organization, error handling, collections |
+| `sf-apex-testing` | TestDataFactory, bulk scenarios, mocks |
+| `sf-apex-async-patterns` | Batch vs Queueable vs @future decision |
+| `sf-apex-enterprise-patterns` | FFLIB selector/domain/service/UoW |
+| `sf-apex-cursor` | Cursor API for large result sets |
+| `sf-trigger-frameworks` | Handler patterns, recursion prevention |
+| `sf-soql-optimization` | Selectivity, indexes, query plans |
+| `sf-governor-limits` | Limit reference, optimization strategies |
+
+### LWC
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-lwc-development` | Component lifecycle, wire, events, SLDS |
+| `sf-lwc-testing` | Jest mocking, DOM queries, accessibility |
+
+### Flow
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-flow-development` | Flow types, bulkification, error handling |
+| `sf-approval-processes` | Approval lifecycle, multi-step, delegation |
+
+### Admin / Config
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-data-modeling` | Objects, relationships, CMDTs, sharing |
+| `sf-experience-cloud` | Sites, guest users, external sharing |
+| `sf-metadata-management` | package.xml, .forceignore, source tracking |
+
+### Integration
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-integration` | REST/SOAP callouts, Named Creds, retry |
+| `sf-platform-events-cdc` | Event publish/subscribe, CDC setup |
+| `sf-api-design` | Custom REST endpoints, batch operations |
+
+### Agentforce
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-agentforce-development` | Topics, actions, prompt templates |
+
+### Cross-domain
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-security` | CRUD/FLS enforcement, sharing, injection |
+| `sf-e2e-testing` | Integration test strategy, bulk scenarios |
+| `sf-debugging` | Debug logs, explain plans, common errors |
+| `sf-deployment` | Deploy strategies, validation-only, rollback |
+| `sf-devops-ci-cd` | GitHub Actions, CI/CD, scratch org CI |
+| `sf-tdd-workflow` | Red-Green-Refactor, TDD methodology |
+| `sf-build-fix` | Compilation errors, metadata conflicts |
+
+### Legacy
+
+| Skill | Knowledge |
+|-------|-----------|
+| `sf-aura-development` | Aura patterns + LWC migration |
+| `sf-visualforce-development` | VF patterns + LWC migration |
+
+## Utility Skills — User-invocable
+
+| Skill | What It Does |
+|-------|-------------|
+| `/sf-help` | This skill — discover available agents and skills |
+| `/sf-quickstart` | Interactive onboarding for new projects |
+| `/sf-docs-lookup` | Look up Salesforce documentation |
+| `/sf-harness-audit` | Audit SCC configuration health |
+| `/sessions` | List and manage saved sessions |
+
+## Quick Start
+
+1. `/sf-quickstart` — detect project type, configure SCC
+2. Describe your task — sf-architect auto-activates for planning
+3. Domain agents auto-activate for building (sf-apex-agent, sf-lwc-agent, etc.)
+4. sf-review-agent auto-activates before deployment
+
+**Fixing build errors?** Describe the error — sf-bugfix-agent activates.
+
+**Need docs?** `/sf-docs-lookup <topic>`
+
+## Related
+
+- **Pattern skills**: `sf-quickstart`, `sf-docs-lookup`, `sf-harness-audit`