# Explanation (/docs/explanation)



These pages are for understanding, not doing. Read them when you want to know *why* something
works the way it does — or before contributing.

* **[Why RyTask](/docs/explanation/why-rytask)** — the problem, the nine differentiators, and the
  metric the team steers by.
* **[Architecture overview](/docs/explanation/architecture)** — a modular monolith with hard
  boundaries, one image for API and worker, events at the seams.
* **[Multi-tenancy & data isolation](/docs/explanation/multi-tenancy)** — how every query is
  fenced to your organization, by construction and by test.
* **[The time-tracking model](/docs/explanation/time-tracking-model)** — planned vs interruption,
  and why the totals always reconcile.
* **[MCP parity](/docs/explanation/mcp-parity)** — agents as first-class clients, not an
  afterthought.
* **[Testing & quality gates](/docs/explanation/testing-and-quality)** — why integration tests
  run on real PostgreSQL, and what CI refuses to merge.
* **[Contributing](/docs/explanation/contributing)** — the monorepo, spec-driven development, and
  the AGPL license.