# Bringing production changes back into source control

*Platform Development Lifecycle and Deployment Architect Study Guide · Operating · Last updated October 26, 2026 · https://www.certifyforce.com/study-guide/platform-development-lifecycle-and-deployment-architect/operating/bringing-production-changes-back-into-source-control*

Why direct production changes make production drift from Git and get overwritten by the next deployment or rollback, how to find them with Setup Audit Trail, retrieve them with Salesforce CLI and commit them through review, how Lifecycle Center teams recreate them, and how to reconcile an emergency fix with open branches.

- Certification: Salesforce Platform Development Lifecycle and Deployment Architect
- Exam section: Operating
- Study guide: https://www.certifyforce.com/study-guide/platform-development-lifecycle-and-deployment-architect

**Official exam objective:**

> Given a customer scenario where changes are made directly in production, explain the implications on the development lifecycle and steps to integrate changes into application lifecycle management.

## What the exam expects

- Explain, in stakeholder language, why a direct production change hurts the lifecycle even when it works.
- Predict what the next deployment, rollback or test run does when production differs from Git.
- Find direct changes with Setup Audit Trail, retrieve them with Salesforce CLI and commit them through review.
- Bring a fix into a Lifecycle Center (formerly DevOps Center) pipeline.
- Reconcile an emergency fix with main, open release branches and the lower environments.

Key terms: **configuration drift** (production differing from version control), **source of truth** (the repository a team deploys from), **manifest** (package.xml listing the components to retrieve or deploy), **emergency fix** (a change made directly in production during an incident), **reconciliation** (bringing that change into Git, open branches and every environment).

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Deployment effect | Creates, updates or deletes the components in the package | [deploy()](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy.htm) |
| Layout assignments | A deployment's assignments replace all existing ones | [Special Behavior in Deployments](https://help.salesforce.com/s/articleView?language=en_US&id=sf.deploy_special_behavior.htm&type=5) |
| Metadata rollback | Redeploy the previous version; no native rollback command | [Operational Excellence](https://architect.salesforce.com/docs/architect/well-architected/guide/operational-excellence.html) |
| Setup Audit Trail view | 20 most recent changes; Download covers 180 days | [Setup Audit Trail](https://help.salesforce.com/s/articleView?language=en_US&id=sf.admin_monitorsetup.htm&type=5) |
| Setup Audit Trail retention | Records deleted after 180 days | [Setup Audit Trail](https://help.salesforce.com/s/articleView?language=en_US&id=sf.admin_monitorsetup.htm&type=5) |
| Deployment Status | Monitors Metadata API deployments, not Setup edits | [Deploy Your Changes](https://help.salesforce.com/s/articleView?language=en_US&id=platform.deploy_overview.htm&type=5) |
| Manifest from an org | Excludes managed and unlocked package metadata by default | [project generate manifest](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_generate_manifest.html) |
| Source tracking | Never available in production; `--ignore-conflicts` has no effect there | [project retrieve start](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_retrieve_start.html) |
| NoTestRun | Development environments only | [project deploy start](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_deploy_start.html) |
| Lifecycle Center promotion | Merges to the next stage's branch, then deploys forward | [Lifecycle Center](https://help.salesforce.com/s/articleView?language=en_US&id=platform.devops_center_overview.htm&type=5) |

## Check yourself

- Why does a direct production change that works still put the next release at risk?
- When does Setup Audit Trail stop helping you find a direct change?
- What does a deployment that contains page layout assignments do to the assignments already in production?
- Why is a second retrieve from production never incremental?

## Sources

- [Operational Excellence (Well-Architected)](https://architect.salesforce.com/docs/architect/well-architected/guide/operational-excellence.html)
- [Monitor Setup Changes with Setup Audit Trail](https://help.salesforce.com/s/articleView?language=en_US&id=sf.admin_monitorsetup.htm&type=5)
- [project retrieve start (CLI command reference)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_retrieve_start.html)
- [project generate manifest (CLI command reference)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_generate_manifest.html)
- [deploy() (Metadata API)](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy.htm)
- [Special Behavior in Deployments](https://help.salesforce.com/s/articleView?language=en_US&id=sf.deploy_special_behavior.htm&type=5)
- [Considerations for Converting the Field Type of a Custom Field](https://help.salesforce.com/s/articleView?id=platform.notes_on_changing_custom_field_types.htm&type=5)
- [Govern, Manage, and Release Changes with Lifecycle Center](https://help.salesforce.com/s/articleView?language=en_US&id=platform.devops_center_overview.htm&type=5)
- [Deploy Your Changes](https://help.salesforce.com/s/articleView?language=en_US&id=platform.deploy_overview.htm&type=5)
- [Plan for Changes to Your Org (Trailhead)](https://trailhead.salesforce.com/content/learn/modules/org-development-model/plan-for-changes-to-your-org2)
- [project deploy start (CLI command reference)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_project_deploy_start.html)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 11 linked practice questions, and unlimited timed mock exams are included with the Platform Development Lifecycle and Deployment Architect pack (USD $19): https://www.certifyforce.com/practice-exams