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.
  1. Read architecture-and-specs.md.
  2. Set up local-development.md.
  3. 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.