contribute
Get from landing to first PR.
The gate is strict — and that's a selling point. Here's what CI expects.
mypy src tests
ruff format --check .
uv run orchestrator pkg accuracy --check
⚠ Classic trap: mypy src alone passes locally and fails CI. You must include tests.
CI also runs the full test suite, pkg verify, and five generated-artifact --check gates (architecture/knowledge-foundation diagrams, MCP tool inventory, matrix counts, source-derived claims) — see CONTRIBUTING.md for the complete list.
Start here
Grab a good first issue — pulled live from the GitHub API.
Fork the repo and branch off develop — main only moves through a release promotion.
Design records live in docs/specs/ — read the spec before changing a subsystem.