Contribute Changes

Local setup

pip install -e ".[dev]"

Run tests

PYTHONPATH=src pytest -q

Change guidelines

Keep boundaries clean: orchestration in core, side effects in adapters.
Prefer small PRs with clear behavior changes.
Update docs with any contract or config change.

Suggested PR structure

problem statement
contract impact
implementation notes
test evidence