diff --git a/AGENTS.md b/AGENTS.md
index f5fb49679..9f338d24f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -47,6 +47,19 @@ Every document in `docs/` must have a corresponding Confluence page in the Hardw
 | `savearth-iot-infrastructure` | `../savearth-iot-infrastructure` | Cloud backend |
 | `hardware-devicesFirmwareTest` | `../hardware-devicesFirmwareTest` | Assembly-house test station |
 
-### Sync note
+### Local Aurelio Workspace
 
-The `replica-omnisciente/` subtree has its own `AGENTS.md`; its sync command is `.aurelio/sync.py`, not `sync.sh`.
+This repository contains a local `.aurelio/` workspace configured for the `flow-meter-pcb` realm. It replaces the previous external Git submodule and connects directly to `savearth-mcp`, `savearth-workspace`, and the electrical MCP servers (`electrical-eda-mcp`, `electrical-sourcing-mcp`).
+
+Tracked bootstrap files:
+
+| File | Purpose |
+|---|---|
+| `.aurelio/config.toml` | Realm identity (`savearth Flow Meter PCB`, `flow-meter-pcb`, v2.8.0), sync endpoint, model defaults |
+| `.aurelio/mcp_config.json` | MCP server declarations scoped to hardware work |
+| `.aurelio/sync.py` | Push/pull the local `brain/` to the central Aurelio host |
+| `.aurelio/README.md` | Workspace documentation |
+| `.aurelio/realm/AGENTS.md` | Realm-specific agent guide |
+| `.aurelio/realm/memory/index.md` | Starter memory index |
+
+Use `python3 .aurelio/sync.py --pull` to fetch the latest central brain and `python3 .aurelio/sync.py --push` to publish local memory changes. Runtime brain artifacts under `.aurelio/brain/` and `.aurelio/memory/` are ignored by Git.
diff --git a/README.md b/README.md
index 23a115c34..e300e3158 100644
--- a/README.md
+++ b/README.md
@@ -31,6 +31,10 @@ Supported PCB versions: **v2.3, v2.4, v2.5, v2.6, v2.7, v2.8, v2.9**.
 | `savearth-iot-infrastructure` | AWS IoT rules, Lambdas, DynamoDB, InfluxDB |
 | `hardware-devicesFirmwareTest` | Assembly-house test station and pre-built binaries |
 
+### Aurelio workspace
+
+This repository includes a local `.aurelio/` workspace for the `flow-meter-pcb` realm. It connects the hardware repo to `savearth-mcp`, `savearth-workspace`, and the electrical MCP servers. See [`.aurelio/README.md`](.aurelio/README.md) for setup, sync commands, and tracked files.
+
 ### Quick start
 
 1. Open the active design: `hardware/v2.8/easyeda/Savearth GBT.eprj` (EasyEDA Pro).