This document explains how to contribute to the project. We follow a "Dual-Track" architecture where human-readable documentation lives in the root and machine-readable policies live in .machine_readable/.
We welcome contributions in many forms: * Code: Improving the core verified stack or extensions. * Documentation: Enhancing AsciiDoc manuals or AI manifests. * Testing: Adding property-based tests or formal proofs.
-
Read the AI Manifest: Start with
0-AI-MANIFEST.a2mlto understand the repository structure. -
Environment: Use
nix developordirenv allowto set up your tools (Idris2, Zig, Rust). -
Task Runner: Use
justto see available commands (just --list).
For detailed rules on branch naming, commit messages, and the PR process, please refer to the machine-readable manual at CONTRIBUTING.adoc.
All contributors are expected to adhere to our ethical standards. See CODE_OF_CONDUCT.adoc for details.