Skip to content

README.md

Latest commit

 

History

History
65 lines (43 loc) · 2.37 KB

README.md

File metadata and controls

65 lines (43 loc) · 2.37 KB
Raw

d360-org-diff

A Claude Code skill for detecting Salesforce Data 360 metadata drift between environments in a branch-per-org pipeline.

What it does

Answers three distinct questions about metadata state across environments:

Question Mode
Did anyone bypass devops and change an org directly? org-vs-branch
What's deployed in one env but not promoted to the next yet? org-vs-org
What's been merged to one branch but not the other? branch-vs-branch

Usage

Invoke in Claude Code with phrases like:

  • "check drift"
  • "compare orgs"
  • "what's different between dev and stage"
  • "did anyone make manual changes to prod"
  • "what's backlogged"

Claude will read config/pipeline.config for your org-to-branch mapping before running anything.

Output

Every run produces:

  • Terminal summary — drift counts by metadata category
  • HTML report — saved to reports/ and auto-opened in the browser, showing full drift grouped by type with expandable inline diffs

Reports are scoped to the manifest(s) in manifests/ so only relevant data kits appear.

Script

./scripts/4-compare.sh org-vs-branch <org>              # manual org changes
./scripts/4-compare.sh org-vs-org <org-a> <org-b>       # environment backlog
./scripts/4-compare.sh branch-vs-branch <branch-a> <b>  # git backlog

Known limitations

  • UI deletions may not be detected — when a field mapping is deleted in the Data Cloud UI, the metadata file often still comes back on retrieve due to a platform limitation. Verify deletions directly in Data Cloud Setup → Data Kits.
  • <externalDataTranField> false positives — stripped automatically by diff_report.py before diffing.

Dependencies

This skill requires a pipeline repo based on d360-deploy-cli-pipeline. Your project repo must have:

  • config/pipeline.config — defines ORG_BRANCH_MAP and PROMOTION_ORDER
  • scripts/4-compare.sh — runs the diff
  • manifests/ — contains your package.xml manifest(s) to scope the comparison

Clone or copy from d360-deploy-cli-pipeline to get started.

Installation

Register this repo as a Claude Code plugin marketplace, then install the skill:

claude plugin marketplace add https://github.com/everanngitmaker/d360-skill-org-diff.git
claude plugin install d360-org-diff