Environment Model

The make layer centralizes environment defaults so local shells and CI jobs do not quietly diverge.

Important Defaults

• VENV=artifacts/python/.venv for the repo-managed Python environment
• CARGO_TARGET_DIR under artifacts/ for Rust build outputs
• docs caches and site output under artifacts/docs/
• release and coverage outputs under artifacts/

Environment Rule

Repository targets should default to artifact-scoped paths. If a target writes outside artifacts/, that choice needs explicit justification.

Next Reads

• Repository Layout
• Package Contracts
• Artifact Governance