Change Control Template

= [CR-YYYY-MM-DD] Brief Description
:description: Change request summary
:status: planned / in-progress / completed / rolled-back
:risk: low / medium / high / critical
:revdate: YYYY-MM-DD

== Change Summary

[cols="1,2"]
|===
| Field | Value

| Change ID
| CR-YYYY-MM-DD-short-name

| Requested By
| [Name / Self]

| Target Date
| YYYY-MM-DD

| Systems Affected
| [List of systems]

| Risk Level
| Low / Medium / High / Critical

| Rollback Time
| X minutes / hours

| Change Window
| [Time range, e.g., "02:00-04:00 UTC"]
|===

== Description

=== What

[Describe the change in detail]

=== Why

[Business/technical justification]

=== Impact

[Who/what is affected during and after the change]

== Pre-Change Checklist

=== Prerequisites

* [ ] Backup completed (date: ___)
* [ ] Rollback procedure tested
* [ ] Stakeholders notified
* [ ] Maintenance window scheduled
* [ ] Monitoring in place

=== Current State Capture

```bash
# Capture current state BEFORE any changes
```

[cols="1,2"]
|===
| Metric | Pre-Change Value

| [Metric 1]
| [Value]

| [Metric 2]
| [Value]
|===

== Change Procedure

=== Phase 1: [Name]

1. Step 1
+
```bash
command
```
+
Expected: [output]

2. Step 2

=== Phase 2: [Name]

...

== Post-Change Validation

=== Functionality Tests

* [ ] Test 1: [Description] - Result: ___
* [ ] Test 2: [Description] - Result: ___
* [ ] Test 3: [Description] - Result: ___

=== State Comparison

[cols="1,2,2"]
|===
| Metric | Pre-Change | Post-Change

| [Metric 1]
| [Value]
| [Value]

| [Metric 2]
| [Value]
| [Value]
|===

=== Monitoring Check

* [ ] No error spikes in logs
* [ ] Performance metrics normal
* [ ] Alerts clear

== Rollback Procedure

=== Trigger Conditions

Rollback if:

* [ ] [Condition 1]
* [ ] [Condition 2]
* [ ] [Condition 3]

=== Rollback Steps

1. Step 1
+
```bash
command
```

2. Step 2

=== Rollback Verification

* [ ] Original state restored
* [ ] Functionality confirmed
* [ ] Stakeholders notified

== Sign-Off

[cols="1,2,2"]
|===
| Role | Name | Date

| Implementer
|
|

| Reviewer
|
|

| Approver
|
|
|===

== Lessons Learned

* What went well?
* What could be improved?
* Update runbook with new findings?

== Related

* Link to incident that prompted change
* Link to runbook used
* Link to monitoring dashboard