The JSON Schema files are the canonical contract. Keep the Python types, documentation, and tests aligned with any schema change. Add fixtures for new behaviour and run the complete test suite before submitting a change:
PYTHONPATH=src python -m unittest discover -s tests -vNever include real patient data; all test data must be synthetic.