Contributing Workflow#
Use this flow for normal pull-request contributions. Authorized internal direct pushes follow the common checkpoint policy, with scoped local validation, retained evidence and applicable head CI.
1. Prepare#
Sync
main.Create a focused branch for one scope.
Confirm local environment is up to date.
Use the routine Python 3.14 workspace described in Development Environment.
2. Implement#
Keep changes atomic and reviewable.
Update tests for behavior changes.
Update docs for user-visible changes.
3. Validate#
Run at least:
python -m pytest --receptor=llm tests
make -C docs html
4. Deliver#
Create coherent commits.
Push branch.
Open PR with clear scope, risk, and validation summary.