Operations

Deployment

Environments, CI, rollback, cutover.

Environments

Every client gets three:

  • dev — active development, seeded fake data.
  • staging — production-shaped data (sanitized), used for pre-release verification.
  • prod — live.

Workflow versioning

Every n8n workflow is exported to Git on save. Every deploy is a PR review with a diff of the JSON. Rollback = revert the commit and re-import.

CI

  • Lint workflow JSON (schema check, unreachable nodes, missing retry policies).
  • Snapshot tests for AI prompts (regression on scored fixture set).
  • Type-check server functions.

Cutover checklist

  • [ ] Webhooks re-pointed to prod
  • [ ] Templates approved on prod WABA
  • [ ] Alert routes updated
  • [ ] On-call schedule confirmed
  • [ ] Post-deploy smoke test run (synthetic lead round-trip)