document how the workspace/panel framework works

2026-08-07 04:10:36 +00:00
parent 33d55121cd
commit ce7968ac90
3 changed files with 274 additions and 4 deletions
@@ -280,6 +280,10 @@ link-focusable). Half the app still does this; none of the new code should.

 - `docs/navigation-audit.md` — **authoritative** on routing/navigation: the opaque-click anti-pattern,
  a severity-ranked findings table, the channel-selection map and the four-phase plan
+- `docs/workspace-panels.md` — how the Workspace/Panel framework works: the layout tree, how a panel is
+  mounted and what it knows, the URL-vs-channel split for panel-to-panel communication, and the
+  persistence key families. Read before building a panel app. Its defect list is
+  `docs/workspace-panel-todo.md`.
 - `docs/sidecar-topology.md` — where the sidecar architecture is going, and what was considered and dropped
 - `docs/working-on-officer.md` — how to run, restart and check your work on this machine
 - `docs/wallet-key-custody.md` — what the platform can and cannot see of the wallet