{
  "markdown": "# sf-env-awareness\n\nA 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.\n\n## What it does\n\nWhen invoked (or triggered automatically), this skill runs a six-phase diagnostic:\n\n1. **Detect project structure** — Identifies single/multi-package, managed/unlocked, org-based from `sfdx-project.json`\n2. **sfdx-project.json audit** — Validates package dependency ordering, version consistency, ancestor lineage, and `sourceApiVersion`\n3. **Metadata API version drift** — Scans all `-meta.xml` files for version inconsistencies, flags drift and mismatches between related components\n4. **Org & scratch org configuration** — Validates scratch org definitions, permission sets, FLS coverage, connected org status\n5. **Deployment dependency analysis** — Checks metadata ordering, Apex dependencies, test coverage readiness, package installation order\n6. **Structured report** — Outputs findings grouped by severity with exact fix commands and verification steps\n\n## When it triggers\n\n- Salesforce DX project setup issues, deployment failures\n- \"Works in sandbox but not in production\"\n- Scratch org creation failures\n- API version mismatches across metadata\n- Package version conflicts\n- Missing permission sets or FLS\n- sfdx-project.json configuration problems\n\nFor non-Salesforce projects (Node, Python, Rust, Go, etc.), see the companion [dep-env-awareness](https://github.com/Pierre-louis242/dep-env-awareness) plugin.\n\n## Prerequisites\n\n- **Salesforce CLI** (`sf` or `sfdx`)\n\n## Install\n\n### As a plugin (recommended)\n\n```bash\n# From a marketplace (once registered)\n/plugin install sf-env-awareness@<marketplace-name>\n\n# Or locally for development/testing\nclaude --plugin-dir /path/to/sf-env-awareness\n```\n\n### As a standalone skill\n\n```bash\ngit clone https://github.com/Pierre-louis242/sf-env-awareness.git /tmp/sf-env-awareness\ncp -r /tmp/sf-env-awareness/skills/sf-env-check ~/.claude/skills/sf-env-check\n```\n\n## Usage\n\nThe skill triggers automatically when relevant. You can also invoke it directly:\n\n```\n# As plugin\n/sf-env-awareness:sf-env-check\n\n# As standalone skill\n/sf-env-check\n```\n\nOr describe what you need naturally:\n\n```\n> Why does my deployment keep failing?\n> Check my Salesforce project for API version drift\n> Audit my scratch org definition\n> My package install order seems wrong\n```\n\n## Plugin structure\n\n```\nsf-env-awareness/\n├── .claude-plugin/\n│   └── plugin.json\n├── skills/\n│   └── sf-env-check/\n│       └── SKILL.md\n├── README.md\n└── LICENSE\n```\n\n## Contributing\n\nIssues and PRs welcome.\n\n## License\n\nMIT\n",
  "bytes": 2669,
  "sha": "448581d50499e41453449790b56d0bcdcaa6f6ffc5c161ea9a811890f40b44f2",
  "repo_slug": "pierre-louis242/sf-env-awareness",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pierre_louis242_sf_env_awareness_sf_env__f72f122c/readme"
}