DESIGN.mddescribes the intended FHIR-to-BigQuery ETL behavior and deployment shape.- Use
uvfor Python environment and dependency management.
- Keep the Docker image runnable from repository root using
Dockerfile. - Use a multi-stage Docker build so build tools stay out of the final runtime image.
- Put
/app/.venv/binonPATHin the runtime image and use console script names directly inCMD.
- Keep checks and Docker publishing in separate GitHub Actions workflows.
- Use the latest tagged version for GitHub Actions
uses:entries, pin them to full commit hashes, and include the source tag in a comment.
- Keep
README.mdup to date for any user-facing workflow, command, packaging, or CI change.
When a requested correction reveals a reusable repo convention, update this file in the same change so future agents do not need the same correction again.
Run these before handing off changes:
uv run ruff format --check .
uv run ruff check .
uv run ty check .
uv run pytest