Start Here
Treat docs as contract, not optional reading.
What you need to know first
- Common owns identity, tenancy, routing, and infrastructure registry.
- SynckHub owns repository data, item workflows, authz enforcement, search, audit, and content operations.
- Optional surfaces such as mail, calendar, shared links, coauthoring, and federation sit on top of those core boundaries.
Recommended order
- Read
architecture-and-specs.md. - Set up
local-development.md. - Move into the API overview pages after the service boundaries are clear.
Core rule
If behavior changes, update contract docs in the same change set.
Spec drift is a reliability bug.