sf-env-awareness
Salesforce-specific project auditing skill. Checks sfdx-project.json configuration, package dependency ordering, API version alignment acros
Open source Repository Open in the app JSON README (API)
About
Salesforce-specific project auditing skill. Checks sfdx-project.json configuration, package dependency ordering, API version alignment across all metadata files, scratch org definition completeness, permission set coverage, flow conflict analysis (including Record-Triggered Flow collisions), Apex test coverage readiness, and deployment dependency ordering. Produces a structured report with exact fix commands. Built from real-world Salesforce consulting experience including multi-package projects, ISV managed packages, and 2GP pipelines.
Details
- Kind
- Plugins
- Topic
- Cloud & DevOps
- Publisher
- pierre-louis242
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-06T14:00:27Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
pierre-louis242/sf-env-awareness/sf-env-awareness
README
# sf-env-awareness A Claude Code plugin that audits Salesforce project configuration, metadata consistency, API version alignment, and package dependencies — then tells you exactly what's broken and how to fix it. ## What it does When invoked (or triggered automatically), this skill runs a six-phase diagnostic: 1. **Detect project structure** — Identifies single/multi-package, managed/unlocked, org-based from `sfdx-project.json` 2. **sfdx-project.json audit** — Validates package dependency ordering, version consistency, ancestor lineage, and `sourceApiVersion` 3. **Metadata API version drift** — Scans all `-meta.xml` files for version inconsistencies, flags drift and mismatches between related components 4. **Org & scratch org configuration** — Validates scratch org definitions, permission sets, FLS coverage, connected org status 5. **Deployment dependency analysis** — Checks metadata ordering, Apex dependencies, test coverage readiness, package installation order 6. **Structured report** — Outputs findings grouped by severity with exact fix commands and verification steps ## When it triggers - Salesforce DX project setup issues, deployment failures - "Works in sandbox but not in production" - Scratch org creation failures - API version mismatches across metadata - Package version conflicts - Missing permission sets or FLS - sfdx-project.json configuration problems For non-Salesforce projects (Node, Python, Rust, Go, etc.), see the companion [dep-env-awareness](https://github.com/Pierre-louis242/dep-env-awareness) plugin. ## Prerequisites - **Salesforce CLI** (`sf` or `sfdx`) ## Install ### As a plugin (recommended) ```bash # From a marketplace (once registered) /plugin install sf-env-awareness@<marketplace-name> # Or locally for development/testing claude --plugin-dir /path/to/sf-env-awareness ``` ### As a standalone skill ```bash git clone https://github.com/Pierre-louis242/sf-env-awareness.git /tmp/sf-env-awareness cp -r /tmp/sf-env-awareness/skills/sf-env-check ~/.claude/skills/sf-env-check ``` ## Usage The skill triggers automatically when relevant. You can also invoke it directly: ``` # As plugin /sf-env-awareness:sf-env-check # As standalone skill /sf-env-check ``` Or describe what you need naturally: ``` > Why does my deployment keep failing? > Check my Salesforce project for API version drift > Audit my scratch org definition > My package install order seems wrong ``` ## Plugin structure ``` sf-env-awareness/ ├── .claude-plugin/ │ └── plugin.json ├── skills/ │ └── sf-env-check/ │ └── SKILL.md ├── README.md └── LICENSE ``` ## Contributing Issues and PRs welcome. ## License MIT