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.

Installs
3
GitHub Stars
2.8K
First Seen
Mar 25, 2026