Documentation

Design notes

This section collects the longer-form design and planning documents that shaped Personal Agent. They are working documents — research, comparisons and phased plans — kept alongside the code so the why travels with the what.

---

Personal Agent side-by-side with OpenClaw, Hermes Agent and Home Assistant.
---

How the Lovelace dashboard, entity and config-flow models map onto our
subsystems.
---

The north-star plan for full HA breadth/depth: a real-time control plane,
standard entity-class catalog, discovery and the HA-bridge accelerator.
---

The full design of the bitemporal, causal world-state memory graph.
---

Unifying the principal scope model (user/group, fail-closed) and merging the
integration-entity and world-memory entity systems.
---

Folding chat modes and dashboards into one Lovelace-style "Surface" concept
(regions, view types, strategies).
---

How the programmatic-tool-calling scripts and the Automations subsystem were
merged into one first-class Workflow.
---

Turning single-user notes into real-time, shareable collaborative documents.
---

The phased build plan for the platform.
---

Durable-run follow-up work for the sub-agent system.
---

Durable-run follow-up work for Computer Service instances.
---

The Android WebView shell plan.
---

Native-feature expansion for the Android app.