skills/generate-runbook/assets/runbook-template.md

# [Runbook title]

## Metadata

- **Status:** Draft
- **Owner:**
- **Operator:**
- **Go/no-go owner:** [Person or accountable role with final decision authority]
- **Last verified:** YYYY-MM-DD
- **Environment:**
- **Expected duration:**
- **Change/incident ID:**
- **Runbook revision:** [Immutable revision or digest of this procedure]
- **Target artifact:** [Exact build, commit, image digest, or scoped resource identity]

## Objective

[Outcome and reason.]

## Scope

**Included**

- [System or resource]

**Excluded**

- [System or resource]

**Must remain unchanged**

- [Invariant]

## Preconditions

- **Entry signal:** [Observable event or condition that makes this procedure applicable now]
- **Entry verification:** [Exact check and acceptance criterion before starting or reusing this runbook]

- [ ] [Access, approval, backup, dependency, or health check]

## Risk and stop conditions

- **Risk:** [Failure mode and containment]
- **Stop immediately if:** [Observable condition]

## Evidence plan

- Record: [Sanitized evidence]
- Store in: [Approved location]
- Never record: [Secrets or private content]
- Binding: [Artifact, environment, time, evidence type, supported claim and invalidation rule; see the execution record]

## Procedure

### Phase 1 — [Name]

1. **Action:** [Atomic action]
   - **Step ID:** S01
   - **Expected result:** [Observable result]
   - **Verify:** [Exact check]
   - **If verification fails:** [Stop, retry, contain, or escalate]
   - **Approval required:** [Existing grant ID and scope, new gate, or Not required with reason]
   - **Retry safety:** [Repeat-safe check or reconciliation before retry; attempt limit and timeout]

## Rollback

- **Trigger:** [Observable condition or threshold requiring rollback or containment]
- **Decision owner:**
- **Actions:**
- **Verification:**
- **Limitations:**

## Completion criteria

- [ ] [Measurable outcome]
- [ ] [Preserved-system health check]

## Communications

- **Start:**
- **Failure:**
- **Completion:**

## Record

- **Execution record:** [Path to the durable execution record for this run]
- **Started:**
- **Completed:**
- **Operator:**
- **Approvals:**
- **Outcome:**
- **Deviations:**
- **Follow-up:**
- **Next verification:**