sf-vlocity-build-deploy
Salesforce Industries DataPack deployment automation using Vlocity Build. TRIGGER when: user deploys or validates OmniStudio/Vlocity DataPacks with vlocity commands (packDeploy/packRetry/packExport/packGetDiffs), sets up DataPack CI/CD pipelines, or troubleshoots DataPack migration errors. DO NOT TR
By jaganpro · 804 installs
npx skills add jaganpro/sf-skills --skill sf-vlocity-build-deploy
Source repository · Upstream listing
sf vlocity build deploy: Vlocity Build DataPack Deployment
Use this skill when the user needs Vlocity DataPack deployment orchestration : export/deploy workflow, manifest driven deploys, failure triage, and CI/CD sequencing for OmniStudio/Industries DataPacks.
When This Skill Owns the Task
Use sf vlocity build deploy when work involves:
vlocity packDeploy , packRetry , packContinue , packExport , packGetDiffs , validateLocalData
DataPack job file design ( projectPath , expansionPath , manifest , queries )
org to org DataPack migration and retry loops
troubleshooting DataPack dependency, matching key, and GlobalKey issues
Delegate elsewhere when the user is:
deploying standard metadata with sf project deploy [sf deploy](../sf deploy/SKILL.md)
building OmniScripts, FlexCards, IPs, or Data Mappers sf industry commoncore
designing Product2 EPC bundles [sf industry cme epc model](../sf industry cme epc model/SKILL.md)
writing Apex/LWC code [sf apex](../sf apex/SKILL.md), [sf lwc](../sf lwc/SKILL.md)
Critical Operating Rules
Use Vlocity Build ( vlocity ) commands for DataPacks, not sf project deploy .
Prefer Salesforce CLI auth integration ( sfdx.username <alias ) over username/password files when available.
Always run a pre deploy quality gate before full deploy:
1) validateLocalData
2) optional packGetDiffs
3) then packDeploy
Use packRetry repeatedly when error counts are dropping; stop when retries no longer improve results.
Keep matching key strategy and GlobalKey integrity consistent across source and target orgs.
Required Context to Gather First
Ask for or infer:
source org and target org aliases
job file path and DataPack project path
deployment scope (full project, manifest subset, or specific key )
whether this is export, deploy, retry, continue, or diff only
namespace model ( %vlocity namespace% , vlocity cmt , or core)
known constraints (new sandbox bootstrap, trigger behavior, matching key customizations)
Preflight checks:
Recommended Workflow
1. Ensure tool readiness
2. Validate project data locally
Use fixLocalGlobalKeys only when explicitly requested and after explaining impact.
3. Export from source (when needed)
4. Deploy to target
5. Continue interrupted jobs
6. Verify post deploy parity
Job file starter: [references/job file template.md](references/job file template.md)
High Signal Failure Patterns
Error / symptom Likely cause Default fix direction
No match found for ... missing dependency in target org include missing DataPack key and redeploy
Duplicate Results found for ... GlobalKey duplicate records in target clean duplicates and re run deploy
Multiple Imported Records ... same Salesforce Record source duplicate matching key records remove duplicates in source and re export
No Configuration Found outdated DataPack settings run packUpdateSettings or enable autoUpdateSettings
Some records were not processed settings mismatch / partial dependency state refresh settings both orgs, then retry
SASS / template compile failures missing referenced UI template assets export/deploy referenced template dependencies first
Detailed matrix: [references/troubleshooting matrix.md](references/troubleshooting matrix.md)
CI/CD Guidance
Default pipeline shape:
1. authenticate orgs ( sf org login ... )
2. validate local DataPack integrity ( validateLocalData )
3. export changed scope ( packExport or manifest driven export)
4. deploy ( packDeploy )
5. retry loop ( packRetry ) until stable
6. compare ( packGetDiffs ) and publish deployment report
For incremental deploy optimization, use job file options such as:
gitCheck: true
gitCheckKey: <folder
manifest for deterministic scope control
Cross Skill Integration
Need Delegate to Reason
metadata deploy outside DataPacks [sf deploy](../sf deploy/SKILL.md) Metadata API workflows
OmniStudio component authoring sf industry commoncore build artifacts before deploy
EPC product and offer payload authoring [sf industry cme epc model](../sf industry cme epc model/SKILL.md) Product2/DataPack model quality
Apex trigger/log error diagnosis [sf debug](../sf debug/SKILL.md), [sf apex](../sf apex/SKILL.md) automation side root cause fixes
Reference Map
Start here
[references/job file template.md](references/job file template.md)
[references/troubleshooting matrix.md](references/troubleshooting matrix.md)
[examples/business internet plus bundle/TRANSCRIPT.md](examples/business internet plus bundle/TRANSCRIPT.md)
[examples/business internet plus bundle deploy/TRANSCRIPT.md](examples/business internet plus bundle deploy/TRANSCRIPT.md)
External reference
[Vlocity Build GitHub](https://github.com/vlocityinc/vlocity build)
Completion Format