From 9e61d6e594df1e4a6d2d8ac7cebeefadb5359311 Mon Sep 17 00:00:00 2001
From: Aric Camarata <aric.camarata@gmail.com>
Date: Sun, 8 Mar 2026 17:10:48 -0400
Subject: [PATCH] docs: add Architecture section to README

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index ad3f4e2..e14857d 100644
--- a/README.md
+++ b/README.md
@@ -171,6 +171,12 @@ The package ships dual CJS/ESM builds with full `.d.ts` and `.d.mts` declaration
 
 ---
 
+## Architecture
+
+A thin adapter over [hijri-core](https://github.com/acamarata/hijri-core) that maps the Temporal Calendar Protocol to Hijri calendar engine calls. The `UaqCalendar` and `FcnaCalendar` classes implement `Temporal.CalendarProtocol` — the package itself adds no calendar math.
+
+For more detail see the [Architecture wiki page](https://github.com/acamarata/temporal-hijri/wiki/Architecture).
+
 ## Compatibility
 
 - Node.js 20, 22, 24