Skip to content

docs(ux): audit Studio's interface against usability principles - #28

Merged
ragnorc merged 2 commits into
mainfrom
docs/ui-ux-audit
Oct 31, 2026
Merged

ragnorc merged 2 commits into
mainfrom
docs/ui-ux-audit

Conversation

@aaltshuler

Copy link
Copy Markdown
Contributor

Adds ui-ux-audit-report.md, a UI/UX audit of Studio at 5cd5d53.

Main finding: Studio has no interaction primitive. Picking something can open a tab, fill a side panel, split the current tab, change the tab's content or change the whole window's scope, depending on where you are. Screen regions have no fixed meaning, so results can't be predicted.

The report also covers the object model, vocabulary, navigation, scope and safety signals, and message severity. It includes a scorecard, what to keep, a proposed rule with an object-by-object table, an order of work, and tests that could prove the audit wrong.

Limits: no users were tested. The evidence is code, specs and offscreen renders on the sample graph, and the rule and glossary are proposals. Quotations and external links should be checked before they are reprinted.

Documentation only, with no code changes.

🤖 Generated with Claude Code

aaltshuler and others added 2 commits October 30, 2026 18:44
Finds that Studio has no interaction primitive: picking something has no
consistent result and screen regions have no fixed meaning. Adds the
evidence, a scorecard, a proposed rule and tests that can falsify it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ragnorc
ragnorc merged commit 52fea51 into main Oct 31, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants