This repository is a formal-design research artifact with an executable consumer prototype. Contributions are welcome, but please read these notes first.
- Read
README.md,spec/GATES.md, andspec/VERSIONING.md. Work outside the admitted scope inspec/GATES.md§11 andspec/VERSIONING.mdshould be discussed in an issue first. spec/is normative and wins every disagreement.machine/andlean/are derived transcriptions; where they disagree withspec/,spec/wins and the transcription is fixed.- Decisions are recorded in the pull request or release notes (
CHANGELOG.md), not accreted into the artifact they concern.
- Open an issue describing the change before large work.
- Branch from
main; keep changes focused (one concern per branch/PR). - Run
sh scripts/lint_docs.shandpython -m pytest -q machine/before submitting. - Open a pull request; maintainers review and merge. Do not merge your own PR.
Changes to spec/, claim statuses, gates, or scope require a
pull request with one approving review and a dated decision record (pull request description or release note).
By contributing, you agree your contributions are licensed under the Apache
License, Version 2.0 (see LICENSE).