← docsInfrastructure

/infra-operations

Run infrastructure operations with controlled execution, operational evidence, and clear i.

Run infrastructure operations with controlled execution, operational evidence, and clear incident-safe handoffs.

Category

Infrastructure

Execution

6 steps, sequential + gated

Goal

Run infrastructure operations with controlled execution, operational evidence, and clear incident-safe handoffs.

Scope

Applies to

  • +Run this infrastructure change
  • +Prepare infra change runbook
  • +Operate rollout with rollback checkpoints

Does not cover

  • −Trivial changes outside the workflow domain

Triggers

"Run this infrastructure change""Prepare infra change runbook""Operate rollout with rollback checkpoints""Create infra operations contract"

Inputs

  • →Context: environment/system affected
  • →Scope: change boundary
  • →Constraints: policy or hard rules

Invariants

  • 01No production mutation without pre-change health baseline.
  • 02Every step must emit evidence (command output, dashboard snapshots, or logs).
  • 03Rollback checkpoints are mandatory for high-risk steps.
  • 04Incident escalation path must be known before execution.

Procedure

  1. Step 1Step 1 — Validate readiness: approvals, maintenance window, dependency ownership, and communication channel.
  2. Step 2Step 2 — Capture baseline health and capacity metrics.
  3. Step 3Step 3 — Execute change in incremental phases with explicit checkpoints.
  4. Step 4Step 4 — Run health checks after each phase.
  5. Step 5Step 5 — If any checkpoint fails, trigger rollback and incident communication.
  6. Step 6Step 6 — Finalize post-change summary with completed actions, open risks, and next monitoring actions.

Outputs

  • ▸Infra operations execution log.
  • ▸Checkpoint results and health evidence.
  • ▸Rollback or success closure note.
  • ▸Handoff note for `document` and `review`.

Review Gate

  • [ ]Change window, owner, and escalation path are explicit.
  • [ ]Baseline and post-change evidence are attached.
  • [ ]Rollback checkpoints are complete.
  • [ ]Handoff contains residual risk and monitoring instructions.