lbds137/tzurot-deployment
.claude/skills/tzurot-deployment/SKILL.md
Railway deployment procedures. Invoke with /tzurot-deployment for deploying, checking logs, and troubleshooting.
$ install --global
skillsauthnpx skillsauth add lbds137/tzurot tzurot-deploymentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 1:44 PM4.4s1 file scanned
SKILL.md
- name:
- tzurot-deployment
- description:
- Railway deployment procedures. Invoke with /tzurot-deployment for deploying, checking logs, and troubleshooting.
- lastUpdated:
- 2026-02-04
Deployment Procedures
Invoke with /tzurot-deployment for Railway operations.
Deployment Procedure
1. Merge PR to develop (auto-deploys)
gh pr merge <PR-number> --rebase --delete-branch
2. Monitor deployment
railway status --json
railway logs --service api-gateway -n 100
3. Verify health
curl https://api-gateway-development-83e8.up.railway.app/health
Rollback Procedure
git revert HEAD
git push origin develop
# Railway auto-deploys the revert
Log Analysis
# Tail specific service
railway logs --service bot-client -n 50
# Search for errors
railway logs --service api-gateway | grep "ERROR"
# Trace request across services
railway logs | grep "requestId:abc123"
# Find errors
railway logs | grep '"level":"error"'
Environment Variables
# Preview changes (ALWAYS dry-run first)
pnpm ops deploy:setup-vars --env dev --dry-run
# Apply to dev
pnpm ops deploy:setup-vars --env dev
# List all for a service
railway variables --service api-gateway --json
# Set single variable
railway variables --set "KEY=value" --service ai-worker --environment development
# DELETE - Use Dashboard (CLI cannot delete!)
Database Migration Procedure
⚠️ Prisma uses LOCAL migrations folder! Checkout the branch matching deployed code first.
# 1. Checkout correct branch
git checkout main # For production
# 2. Check status
pnpm ops db:status --env prod
# 3. Apply migrations
pnpm ops db:migrate --env prod --force
Running Scripts Against Railway
# Generic pattern
pnpm ops run --env dev <command>
# One-off script
pnpm ops run --env dev tsx scripts/src/db/backfill.ts
# Prisma Studio
pnpm ops run --env dev npx prisma studio
Service Restart
# Note: 'railway restart' doesn't exist, use redeploy
railway redeploy --service bot-client --yes
Troubleshooting Checklist
| Symptom | Check | Solution |
| ------------------ | ------------------------------- | ----------------------- |
| Service crashed | railway logs -n 100 | Check missing env vars |
| Slow responses | railway logs \| grep duration | Check DB/Redis |
| Bot not responding | bot-client logs | Verify DISCORD_TOKEN |
| Migration failed | pnpm ops db:status | Apply with db:migrate |
References
- Railway CLI:
docs/reference/RAILWAY_CLI_REFERENCE.md - Railway Operations:
docs/reference/deployment/RAILWAY_OPERATIONS.md
Related Skills
lbds137/tzurot-testing
development
VerifiedTrustedCommunity
Testing procedures. Invoke with /tzurot-testing for test execution, coverage audits, and debugging test failures.
8SKILL.mdUpdated Apr 6, 2026
lbds137/tzurot-git-workflow
tools
VerifiedTrustedCommunity
Git workflow procedures. Invoke with /tzurot-git-workflow for commit, PR, and release procedures.
8SKILL.mdUpdated Apr 6, 2026
lbds137/tzurot-docs
documentation
VerifiedTrustedCommunity
Session workflow procedures. Invoke with /tzurot-docs for session start/end, CURRENT.md/BACKLOG.md management.
8SKILL.mdUpdated Apr 6, 2026
lbds137/tzurot-doc-audit
tools
VerifiedTrustedCommunity
Documentation and auto-memory freshness audit. Invoke with /tzurot-doc-audit to review docs and Claude auto-memory for staleness, items in the wrong layer, and missing-tool drift.
8SKILL.mdUpdated Apr 6, 2026