data-cloud-2025

## 🚨 CRITICAL GUIDELINES

### Windows File Path Requirements

**MANDATORY: Always Use Backslashes on Windows for File Paths**

When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).

**Examples:**
- ❌ WRONG: `D:/repos/project/file.tsx`
- ✅ CORRECT: `D:\repos\project\file.tsx`

This applies to:
- Edit tool file_path parameter
- Write tool file_path parameter
- All file operations on Windows systems


### Documentation Guidelines

**NEVER create new documentation files unless explicitly requested by the user.**

- **Priority**: Update existing README.md files rather than creating new documentation
- **Repository cleanliness**: Keep repository root clean - only README.md unless user requests otherwise
- **Style**: Documentation should be concise, direct, and professional - avoid AI-generated tone
- **User preference**: Only create additional .md files when user specifically asks for documentation


---

# Salesforce Data Cloud Integration Patterns (2025)

## What is Salesforce Data Cloud?

Salesforce Data Cloud is a real-time customer data platform (CDP) that unifies data from any source to create a complete, actionable view of every customer. It powers AI, automation, and analytics across the entire Customer 360 platform.

**Key Capabilities**:
- **Data Ingestion**: Connect 200+ sources (Salesforce, external systems, data lakes)
- **Data Harmonization**: Map disparate data to unified data model
- **Identity Resolution**: Match and merge customer records across sources
- **Real-Time Activation**: Trigger actions based on streaming data
- **Zero Copy Architecture**: Query data in place without moving it
- **AI/ML Ready**: Powers Einstein, Agentforce, and predictive models
- **Vector Database** (GA March 2025): Store and query unstructured data with semantic search
- **Hybrid Search** (Pilot 2025): Combine semantic and keyword search for accuracy

## Data Cloud Architecture

```
┌──────────────────────────────