documenso-prod-checklist

name	documenso-prod-checklist
description	Execute Documenso production deployment checklist and rollback procedures. Use when deploying Documenso integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "documenso production", "deploy documenso", "documenso go-live", "documenso launch checklist".
allowed-tools	Read, Bash(kubectl:*), Bash(curl:*), Grep
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","documenso","deployment"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Documenso Production Checklist

Overview

Complete checklist for deploying Documenso integrations to production, covering security, reliability, monitoring, and compliance readiness.

Prerequisites

• Staging environment tested and verified
• Production API keys available
• Deployment pipeline configured (see documenso-ci-integration)
• Monitoring ready (see documenso-observability)

Production Checklist

1. Authentication & Secrets

• Production API key generated (not staging key)
• API key stored in secret manager (Vault, AWS Secrets Manager, not .env)
• Webhook secret configured and verified
• Key rotation procedure documented
• Old/unused keys revoked
• Self-hosted: secrets generated with openssl rand -hex 32
• Self-hosted: signing certificate from trusted CA mounted

2. Error Handling

• All API calls wrapped in try/catch with typed errors
• Exponential backoff for 429/5xx responses
• Circuit breaker for Documenso outages
• User-friendly error messages (no raw API errors exposed)
• Error tracking integration (Sentry, Datadog, etc.)

3. Performance

• Singleton client pattern (not creating new client per request)
• Templates used for repetitive document creation
• Bulk operations use concurrency control (p-queue)
• Background processing for non-critical operations (Bull/BullMQ)
• Document metadata cached (completed documents immutable)