- Branch from
mainwith a focused change. - Run
make bootstraponce, thengofmt -won changed Go files andmake formatfor Python changes. - Add or update tests for behavior changes.
- Run
make checkbefore opening a pull request. - Keep pull requests small and explain the task, evidence, and affected invariant.
CI runs quality checks, the test suite on Python 3.9 and 3.13 across Linux, macOS, and Windows, and a clean wheel build/install smoke test.
SPEC.md is normative. Consult docs/reference/HANDOFF.md before changing the rules-as-ledger model, task-boundary reflection, pending-rule gate, adapter boundary, or typed version metadata. Record intentional changes rather than silently reversing an established decision.
The production CLI and reusable packages are written in Go with Cobra and ship as a single binary. Python remains as a temporary compatibility implementation and for research integrations such as GEPA; users will not need Python to run the final CLI.