Railway Worker Deployment Progress
User Instructions
Preferences
- Planning only — no code until plan is approved
- Workers: worker-ingest, worker-facts, worker-validate (3 of 5 total)
- worker-reel-render and worker-sms are out of scope for this project
Blockers to Address
- None currently
Skip/Defer
- Web apps (eko-web, eko-admin, eko-public) — separate project
- Cron migration — separate project
- DNS cutover — separate project
Priority Overrides
- Deploy workers first since they have zero users (lowest-risk migration target)
Quality Reference
- Target Grade: A+ (97+)
- Key Metrics:
- Health check responds on
/healthwith correct status: Target 100% - Graceful shutdown drains messages within 30s: Target 100%
- All env vars provisioned and validated: Target 100%
- Docker images build and start cleanly: Target 100%
- Health check responds on
Phase Transition Checklists
PHASE 1 -> PHASE 2
- All wave challenges PASS
- No items in "Blocked" section
- Quality tier verified
- All tests passing
PHASE 2 -> PHASE 3
- All specs/docs updated
- Cross-references verified
Wave 1: Dockerfiles & Build
01-dockerfiles.md <- CURRENT
- Create challenge document
- Evaluate challenges
- Implement
- Re-evaluate until PASS
02-railway-project-setup.md
- Create challenge document
- Evaluate challenges (pending 01)
Wave 2: Deploy & Validate
03-env-vars-and-secrets.md
- Create challenge document (pending Wave 1)
04-deploy-and-health-check.md
- Create challenge document (pending 03)
05-observability-and-monitoring.md
- Create challenge document (pending 04)
Wave 3: Quality & Hardening
06-quality-standards.md
- Create challenge document (pending Wave 2)
Blocked
Completed
Workflow Reference
Commands
@docs/projects/railway/worker-TODO.md What's the current task? @docs/projects/railway/worker-TODO.md Resume from where we left off @docs/projects/railway/worker-TODO.md Mark [challenge] complete @docs/projects/railway/worker-TODO.md Ready for Phase 2? @docs/projects/railway/worker-TODO.md Block on [reason]