operations:runbooks
Table of Contents
Operations and runbooks
Owner: Engineering\ Last reviewed: 2026-07-21
Runbook template
Every operational runbook should include:
- purpose and scope
- owner and escalation path
- prerequisites and required access
- exact procedure
- verification and expected result
- rollback or recovery procedure
- last-tested date
Release principles
- Deploy API and required migrations before a mobile-web release that depends on them.
- Treat the native wrapper version, web release version, and API compatibility version as separate values.
- Verify the exact release-registry channel and wrapper-version tuple used by the store binary.
- Never place service-role keys, access tokens, database URLs, or JWTs in a runbook.
Link detailed procedures to their source-controlled scripts and canonical documentation so commands do not drift silently.
