---
name: python-engineering
description: Build maintainable Python applications and automation with typed boundaries, packaging, environments, tests, and robust subprocess handling.
---

# Python Engineering

- Use the project’s existing environment and packaging system; do not introduce a second one.
- Add type hints at public boundaries and structured validation for external data.
- Use pathlib, context managers, explicit timeouts, and subprocess argument arrays where possible.
- Preserve exception context and return actionable errors.
- Cover platform-specific behavior and clean shutdown for long-running processes.
- Run formatter/linter/type checker/tests configured by the repository.