Cursor rule

1---
2description: "Deployment procedures: pre-deploy validation, post-deploy smoke tests, Coolify, Docker, rollback procedures."
3globs: "docker-compose*.yml,Dockerfile*,scripts/deploy*,scripts/dev-docker*,.coolify/**"
4alwaysApply: false
5---
6 
7# Deployment Rules
8 
9These rules apply when working on deployment configurations, Docker files, or executing deployments.
10 
11## Authoritative SOPs (MUST READ before deploying)
12 
13| Document                 | Location                                          | Purpose                     |
14|--------------------------|---------------------------------------------------|-----------------------------|
15| Semantic Release SOP     | `docs/ci-cd/Semantic-Release-Deployment-SOP.md`   | Release automation workflow |
16| Staging/UAT Release SOP  | `docs/sop/STAGING-UAT-RELEASE-SOP.md`             | UAT validation process      |
17| Linux Dev Machine Access | `docs/deployment/LINUX-DEV-MACHINE-ACCESS-SOP.md` | Dev server access           |
18| Production Server Access | `docs/deployment/PRODUCTION-SERVER-ACCESS-SOP.md` | Production deployment       |
19 
20Always read the relevant SOP before proceeding. This rule provides checklists, not full procedures.
21 
22## Pre-Deployment Checklist
23 
24Before ANY deployment:
25 
26- [ ] All CI checks pass (GitHub Actions green)
27- [ ] PR merged to target branch (`{{DEV_BRANCH}}` for staging, `{{MAIN_BRANCH}}` for prod)
28- [ ] No unresolved blockers in Linear
29- [ ] Database migrations tested locally
30- [ ] Environment variables verified
31 
32```bash
33# Validate before deploy
34{{CI_VALIDATE_COMMAND}}
35docker compose build
36```
37 
38## Post-Deployment Smoke Test
39 
40After deployment completes:
41 
42- [ ] Health endpoint responds: `curl https://{domain}/api/health`
43- [ ] Database connection verified (check health response)
44- [ ] Authentication flow works
45- [ ] Critical user flows functional
46- [ ] No new errors in logs
47 
48```bash
49# Smoke test
50curl -s https://{domain}/api/health | jq .
51# Expected: {"status":"healthy","timestamp":"..."}
52```
53 
54## Branch to Environment Mapping
55 
56| Branch             | Environment          | Auto-Deploy |
57|--------------------|----------------------|-------------|
58| `{{DEV_BRANCH}}`   | Staging              | Manual pull |
59| `{{MAIN_BRANCH}}`  | Production (Coolify) | Automatic   |
60 
61## Rollback Procedure
62 
63If deployment fails:
64 
651. **Identify failure** -- Check Coolify logs, monitoring dashboards
662. **Revert commit** -- `git revert {commit_sha}`
673. **Push revert** -- Triggers automatic rollback deployment
684. **Verify rollback** -- Run smoke tests again
695. **Document incident** -- Update Linear ticket with evidence
70 
71## FORBIDDEN
72 
73- Deploying with failing CI checks
74- Skipping smoke tests on production
75- Deploying database migrations without local testing
76- Force-deploying over active incidents
77- Production deploys without prior staging validation
78 
79## REQUIRED
80 
81- Health check MUST pass within 5 minutes
82- Production deployments MUST have staging validation first
83- Rollback plan MUST be documented before production deploy
84 
85## Deployment Evidence Template
86 
87Attach this to the Linear ticket after deployment:
88 
89```markdown
90## Deployment Evidence - {{TICKET_PREFIX}}-XXX
91 
92### Environment
93- **Target**: Staging / Production
94- **Branch**: `{branch_name}`
95- **Commit**: `{commit_sha}`
96 
97### Pre-Deployment
98- [x] CI checks passed
99- [x] PR merged
100- [x] Migrations verified
101 
102### Post-Deployment
103- [x] Health check: PASSED
104- [x] Auth flow: PASSED
105- [x] Smoke tests: PASSED
106 
107### Verification
108curl -s https://{domain}/api/health
109{"status":"healthy","timestamp":"..."}
110```
111 
112## Key References
113 
114- **Deployment SOPs**: `docs/deployment/`, `docs/sop/`, `docs/ci-cd/`
115- **Docker configs**: `docker-compose*.yml`
116- **Deploy scripts**: `scripts/`
117- **Full skill docs**: `.claude/skills/deployment-sop/SKILL.md`
118