# Provisioning Guide

## Scope

- Use this file for Docker build files and helper scripts under `provisioning/`.
- These files define local container packaging and helper runtime images, not core game logic.

## Working Rules

- Keep the main server image aligned with `compose.yml` and `Makefile` entrypoints.
- Preserve the non-root runtime model unless the task explicitly requires a capability or ownership change.
- Keep the server image focused on the compiled binary plus bundled `_datafiles`; avoid pulling unrelated tooling into the runtime stage.
- Treat `provisioning/terminal/` as a helper client image for local development, not a production service.

## Verification

- For main image changes, prefer validating through `make run-docker` or the narrowest equivalent Docker build path.
- For terminal image changes, validate the affected Docker build or compose path.
- If you change shell helpers here, run `shellcheck` and `shfmt` if available.