salesforce-known-pitfalls
Installation
SKILL.md
Salesforce Integration Pitfall Audit
Overview
Find evidence of recurring failure patterns in code and operations, rank their real blast radius, and convert each confirmed issue into a bounded fix and regression test.
Prerequisites
- Repository, architecture, org topology, API and event contracts, deployment history, incidents, and current owners
- Current Salesforce API EOL, OAuth, limits, metadata, security, Bulk, Composite, CDC or Pub/Sub documentation
- Representative fixtures, non-production org, policy gates, reconciliation queries, and change process
Tool Discipline
Use Read, Glob, and Grep to inspect approved repository and evidence files, WebFetch to re-check current first-party Salesforce documentation, and Write or Edit only for secretless plans, fixtures, configuration, and redacted receipts.
Current Contract
Common Salesforce defects cross application and org boundaries: unsupported versions, legacy auth, inefficient queries, shared capacity, object or field drift, automation side effects, partial writes, event gaps, and permission differences. Their exact behavior must be proven in context.