diff --git a/.gitea/workflows/nightly.yml b/.gitea/workflows/nightly.yml
index 4ed4bb23..0d706d0b 100644
--- a/.gitea/workflows/nightly.yml
+++ b/.gitea/workflows/nightly.yml
@@ -146,6 +146,8 @@ jobs:
           POSTGRES_PASSWORD=${{ secrets.STAGING_POSTGRES_PASSWORD }}
           POSTGRES_HOST=archiv-staging-db-1
           EOF
+          # Note: POSTGRES_HOST is derived from the Compose project name (archiv-staging)
+          # and service name (db). A project rename requires updating this value.
           chmod 600 /opt/familienarchiv/obs-secrets.env
 
       - name: Validate observability compose config
diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml
index a45f48a7..7b34728e 100644
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -114,6 +114,8 @@ jobs:
           POSTGRES_PASSWORD=${{ secrets.PROD_POSTGRES_PASSWORD }}
           POSTGRES_HOST=archiv-production-db-1
           EOF
+          # Note: POSTGRES_HOST is derived from the Compose project name (archiv-production)
+          # and service name (db). A project rename requires updating this value.
           chmod 600 /opt/familienarchiv/obs-secrets.env
 
       - name: Validate observability compose config