Governance in Atlas
Connect an architecture change to its evidence, responsible people and implementation.
Choose how to handle the change
| Situation | Start here |
|---|---|
| A recorded owner or description needs a correction | Use a direct edit when the workspace mode and your role allow it |
| Several records will change together or need review | Group the work in a change request |
| Someone needs to understand why a decision was made | Open the relevant decision and check the rationale and supporting evidence |
An administrator sets Simple or Review under Settings > Workspace > Change management. In Simple, people with a write role can edit directly and authors can apply their own requests. In Review, direct edits are for owners and admins. Other changes follow the proposal and review process. AI agents and connectors submit proposals for a person to review. Check workspace roles and the detailed change request rules before submitting.
Prepare a change someone can review
Suppose you plan to retire an old reporting application when its replacement is ready. Identify the reports and integrations that still depend on it, who can confirm the source and who will confirm the replacement. Record the intended change, affected records, relevant evidence, assumptions and any planned date.
When reviewing, check the relationship as well as the proposed value. Involve the owners of material dependencies. A useful review leaves the next person able to understand the reasoning and outstanding questions.
Check implementation
Approval and implementation are separate states. If an item has a future effective date, confirm what happened before implementing it in Atlas. Re-open the affected records and check the result.
| If you see this | Check this first |
|---|---|
| A review action is unavailable | The workspace mode, your role, ownership and request status |
| The proposal conflicts with a recent edit | The current value and source before resubmission |
| An approved change remains planned | The delivery status and who can implement the item |
| An AI proposal lacks supporting evidence | The source or owner who can clarify the point |