---
description: Rules for Docker compose files, helper scripts, and env examples
globs:
  - docker/**
alwaysApply: false
---

<!-- Generated by scripts/generate_ai_collab_docs.py. Edit metadata in that script. -->

# Cursor Rule: Docker

- Treat `docker-compose.dev.yml`, `docker-compose.latest.yml`, and
  `docker-compose.yml` as distinct local-dev, freshest-published, and
  pinned-release surfaces.

- Keep secrets and environment-specific credentials out of compose files and
  helper scripts.

- Preserve image names, tags, env-file expectations, and boot order unless the
  release or app configuration model also changes.

- Validate touched compose files with `docker compose ... config` and
  cross-check release-facing image behavior against GitHub build and release
  workflows.
