clean-architecture-backend-template/docs/runbooks/startup-validation-failed.md

title, category, error_codes, severity, owner, last_updated, status

title	category	error_codes	severity	owner	last_updated	status
Runbook — STARTUP_VALIDATION_FAILED (환경 변수 검증 실패)	INTERNAL	STARTUP_VALIDATION_FAILED	P1	oncall	2026-06-15	stub

Runbook: STARTUP_VALIDATION_FAILED (runbook://startup/validation-failed)

Symptoms

• Container exits with code 78 (env validation failure exit)
• Structured log with error.code=STARTUP_VALIDATION_FAILED, startup.phase=env-validation

Diagnosis

• Check which required env variable is missing or malformed
• Review container environment and secrets injection

Action

• Supply missing environment variables to deployment
• Verify secrets are correctly mounted / injected

Escalation

• P1: app cannot start; coordinate with deployment/secrets team

---

Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)