# Isis Launch Readiness Checklist Runbook

Last Updated: 2026-02-24  
Scope: WS18-002 launch readiness checklist with measurable pass/fail gates.

## Purpose

Provide a deterministic, phase-aware launch readiness gate for canary, ramp, and
full release decisions.

The checklist script evaluates required evidence and emits:

1. Machine-readable JSON gate report
2. Operator-facing Markdown summary
3. Required-gate `overallPass` outcome suitable for automation

## Script

- `scripts/isis/run_launch_readiness_checklist.sh`

Default outputs:

- `tmp/isis-launch/launch-readiness-<timestamp>.json`
- `tmp/isis-launch/launch-readiness-<timestamp>.md`

## Gate IDs

- `LRG-001`: migration completion certificate validation
- `LRG-002`: phased rollout strategy validation
- `LRG-003`: observability stack validation
- `LRG-004`: v2 compliance gate validation
- `LRG-005`: canary SLO/cost report pass
- `LRG-006`: release gate report pass with no rollback recommendation
- `LRG-007`: ramp decision action allows progression (`promote` or `steady`)
- `LRG-008`: game-day readiness report pass
- `LRG-009`: post-cutover validation report pass
- `LRG-010`: cutover sign-off indicates `GO` with blocking approvals

## Required Gates by Phase

- `canary`: `LRG-001`..`LRG-005`
- `ramp`: `LRG-001`..`LRG-008`
- `full`: `LRG-001`..`LRG-010`

## Usage

### Canary Readiness

```bash
READINESS_PHASE=canary scripts/isis/run_launch_readiness_checklist.sh
```

### Ramp Readiness

```bash
READINESS_PHASE=ramp scripts/isis/run_launch_readiness_checklist.sh
```

### Full Release Readiness (Strict)

```bash
READINESS_PHASE=full \
SIGNOFF_FILE=docs/domains/isis/remediation/ISIS_CUTOVER_SIGNOFF_TEMPLATE.md \
STRICT=true \
scripts/isis/run_launch_readiness_checklist.sh
```

## Inputs and Artifact Resolution

- If report paths are not provided, the script auto-discovers the latest reports
  from:
  - `tmp/isis-canary/`
  - `tmp/isis-release-gate/`
  - `tmp/isis-gameday/`
  - `tmp/isis-cutover/`
- Key optional overrides:
  - `CANARY_REPORT_FILE`
  - `RELEASE_GATE_REPORT_FILE`
  - `RAMP_DECISION_FILE`
  - `GAMEDAY_REPORT_FILE`
  - `POST_CUTOVER_REPORT_FILE`
  - `SIGNOFF_FILE`

## Exit Behavior

- `STRICT=false` (default): always emits report artifacts; exits non-zero only
  on script/runtime errors.
- `STRICT=true`: exits `2` when any required gate is not `pass`.
