CONTRIBUTING.md (924B)
1 # Contributing 2 3 ## Start with the repository contract 4 5 Read `AGENTS.md` before changing product behaviour or architecture. When this 6 repository is consumed by the Radroots monorepo, also read the relevant 7 normative material under its `docs/oss/harvestcircle/` tree. Standalone changes 8 must not add normative documentation roots to this repository. 9 10 ## Development flow 11 12 1. Use the current development branch policy. 13 2. Make one coherent change at a time. 14 3. Add or update tests. 15 4. Run focused checks. 16 5. Run: 17 18 ```sh 19 make format 20 make lint 21 make test 22 make check 23 ``` 24 25 6. Do not hand-edit generated UniFFI code. 26 7. Do not include secrets or private event plaintext. 27 8. Document intentional architecture deviations. 28 29 ## Commit style 30 31 ```text 32 <scope>: <imperative summary> 33 ``` 34 35 ## Public contracts 36 37 Changes to FFI, product coordinates, storage migrations, or future Radroots 38 event contracts require explicit compatibility review.