Files
platform/todo/workspaces-panels/a-deep-read-of-the-whole-framework-to.md
pastilhasandClaude Fable 5 44f6c6d6ac todo: group the url and query-string items into one theme
files-app becomes url-state: the file browser is where the work happened, but where
selection lives and who clears a query string are framework questions. The panel
framework's version of the same question moves in beside them, extracted from the
deep-read item, which keeps it as one of its three questions.

Item ids changed with the theme. Done now deliberately — no board reads them yet, and
this is the last cheap moment to move one.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 16:40:39 +00:00

25 lines
1.4 KiB
Markdown

---
id: workspaces-panels/a-deep-read-of-the-whole-framework-to
title: "A deep read of the whole framework, to understand it and then improve it"
theme: workspaces-panels
status: open
created: 2026-08-20
date_source: assumed
order: 1
---
**A deep read of the whole framework, to understand it and then improve it.** Low priority and
explicitly not pain-driven — it works, and it works well. But it was built fast and then added to,
repeatedly, and nobody has since sat down and read the whole thing at once.
Three questions to answer rather than assume: can the query strings come out of the flow; is there
a better shape for panel-to-panel communication than the current channel/URL split; and what does
the layout tree cost that a simpler one would not.
The first of those now has its own item, `url-state/can-the-query-strings-come-out-of-the-flow`,
filed with the file browser's work on the same question — that is where it has been thought about
hardest. It stays part of this read; it is not a separate effort.
**Fold the existing panel items into this** — the silent `key`/`appType` mismatch, the destructive
layout migration on a renamed key, and `docs/workspace-panel-todo.md`. They are symptoms of the
same unexamined design, and fixing them one at a time is how it stays unexamined.
Also a teaching exercise: the owner wants to understand it end to end, which is a reason to do it
properly rather than quickly.