Contributing

The gate is strict — and that’s a selling point. Here’s exactly what CI expects.

The gate — core checks

mypy src tests
ruff format --check .
uv run orchestrator pkg accuracy --check

The classic trap

mypy src alone passes locally and fails CI. You must include tests: mypy src tests.

CI also runs the full test suite, pkg verify, and five generated-artifact --check gates (the architecture and knowledge-foundation diagrams, the MCP tool inventory, matrix counts, and source-derived claims) — see CONTRIBUTING.md for the complete list.

Where to start

• 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.

Links

• CONTRIBUTING.md
• Code of Conduct
• Security policy — coordinated disclosure; do not open a public issue for vulnerabilities.