The Astrid Contributor Handbook is a reference guide that documents the structure, processes, and contribution model for the Unicity Astrid OS project.
The handbook addresses the need for contributors to understand how to work within a polyrepo architecture and navigate the project's governance model. It documents the kernel-is-dumb law, the RFC trigger mechanism, contribution tiers, and the release workflow. The guide is built with mdBook, making it a web-accessible reference that centralizes institutional knowledge about the project's public contracts and contribution expectations.
This handbook is essential for anyone considering contributing to Astrid OS. It suits developers who want to understand the project's architectural philosophy, governance structure, and the process for proposing changes before investing time in contributions. The handbook establishes clear contribution tiers and explains how the RFC process works, helping contributors understand what level of involvement matches their goals and what approval pathways exist for different types of changes.
The project maintains active documentation that reflects the current state of the Astrid OS contribution model. Updates to the handbook track changes in project structure and process, ensuring that the guide remains aligned with how the project actually operates.