---
description: Workflow and container YAML stays declarative; operational shell belongs in separate scripts
---

Do not embed multiline operational scripts in workflow, Compose, or container
YAML. Keep YAML declarative and move shell logic into a small, named `.sh` file
that can be tested directly.