fix(dev-env): complete local startup configuration

2026-06-21 20:43:45 +02:00
parent 461b56892c
commit 8c80607df9
3 changed files with 32 additions and 0 deletions
@@ -129,6 +129,13 @@ Phase 12 gap-closure: migration-gated Compose startup (migrate service, service_

 ## Development Setup

+### Local environment contract
+
+- The repository-root `.env` is the complete local-development configuration and must remain excluded from Git.
+- Codex and Claude must update both `.env` and `.env.example` whenever a change adds, removes, or renames an environment variable required by the app or Docker Compose.
+- Preserve existing local secret values unless rotation is required; never copy `.env` secrets into tracked files, logs, commits, or responses.
+- Before declaring startup work complete, run `docker compose config --quiet` and verify every required variable is present and non-empty.
+
 ```bash
 # Start all services
 docker compose up