Operability Guideline

Tech Stack

• Workflows: Upstash Workflows + QStash
• Cache: Upstash Redis
• Platform: Vercel

Non-Negotiables

• Dead-letter handling must exist and be operable (visible, replayable)
• Side-effects (email, billing, ledger) must be idempotent or safely re-entrant
• Drift alerts must have remediation playbooks

Context

Operability is about running the system in production — not just building it. Systems fail. Jobs get stuck. State drifts. The question is: when something goes wrong, can an operator fix it without deploying code?

Consider the operator experience during an incident. What tools do they have? What runbooks exist? Can they safely retry failed jobs? Can they detect and fix drift?