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.