waggle-os/docs/audits/2026-07-08-ux-packet-index.md

UX Audit Packet Index

Status: analysis packet is approval-ready. Full goal remains open until approved fixes and five-persona judge scoring are complete.

Start Here

1. docs/audits/2026-07-08-ux-approval-brief.md - shortest decision doc; approve Phase 1 from here.
2. docs/audits/2026-07-08-analysis-completion-audit.md - proves what the analysis phase covers and what remains unfinished.
3. docs/superpowers/plans/2026-07-08-ux-phase-1-corrections.md - implementation plan to execute after approval.

Evidence Files

File	Purpose
docs/audits/2026-07-08-complete-ux-usage-audit.md	Full evidence, findings, phases, tickets, and verification results.
docs/audits/2026-07-08-ux-route-scenario-manifest.md	Registered routes, overlays, scenarios, and evidence owner requirements.
docs/audits/2026-07-08-ux-state-failure-scenario-matrix.md	Account, tier, model, data, offline, mobile, and failure-state combinations that judge runs must sample.
docs/audits/2026-07-08-ux-non-main-surface-scope.md	Public landing/download/checkout/legal, desktop wrapper, installer/update, sidecar-startup, utility, hook, developer/substrate, ops/deployment, CI, benchmark, and judging scope decisions.
docs/audits/2026-07-08-five-persona-judge-scorecards.md	Five judge personas, scoring model, score caps, and required screenshots/evidence.
docs/audits/2026-07-08-five-persona-judge-runbook.md	Executable judge protocol: state bundles, route sequences, required screenshots, score caps, deferral rules, and evidence folder shape.
docs/audits/2026-07-08-ux-correction-register.md	Master row-by-row tracker mapping findings to tickets, phases, files, judges, and closure evidence.
docs/audits/2026-07-08-ux-approval-brief.md	Concise approval decision and Phase 1 scope boundaries.
docs/audits/2026-07-08-analysis-completion-audit.md	Requirement trace from the original goal to current evidence and remaining blockers.
docs/audits/2026-07-08-ux-post-phase-1-roadmap.md	Sequencing for Phase 2/3 work after Phase 1; not approved for implementation yet.
docs/audits/2026-07-08-web-guidelines-line-findings.md	Line-level Web Interface Guidelines supplement for native dialogs, focus, forms, animation, images, and locale formatting.
docs/audits/2026-07-08-runtime-a11y-t10-analysis.md	Focused runtime axe/DOM accessibility smoke for core desktop/mobile routes and Command Center; adds rendered T10 evidence for unnamed controls, select labels, scroll regions, workspace semantics, and mobile command-label overflow.
docs/audits/2026-07-08-visual-t5-classification.md	Fresh visual-regression rerun and 14-snapshot classification: current screenshots are coherent, active baselines are stale, duplicate baseline families need cleanup, and baseline updates must wait for approval.
docs/audits/2026-07-08-first-run-onboarding-t1-t2-t12-analysis.md	Focused clean-data first-run onboarding smoke with desktop completion, mobile 390 x 844 profile evidence, Clerk/CSP console reproduction, import-risk findings, and T1/T2/T12 closure updates.
docs/audits/2026-07-08-source-inventory-consistency-audit.md	Current-source route/app/package inventory check; adds Browser Companion T19 and command-query evidence notes.
docs/audits/2026-07-08-browser-companion-t19-analysis.md	Focused Browser Companion extension analysis with manifest/syntax/typecheck evidence, disconnected/connected popup screenshots, direct sidecar save evidence, current toolbar/extraction probes, Memory UI confirmation, CORS/auth-pairing findings, and T19 line-level findings.
docs/audits/2026-07-08-desktop-wrapper-t14-analysis.md	Focused Tauri desktop wrapper analysis with Rust/app/server checks, native event consumer matrix, release/tray source hardening, and T14 line-level findings.
docs/audits/2026-07-08-admin-cli-utility-t15-analysis.md	Focused admin web, CLI, marketplace, memory MCP, hive-mind MCP, and hive-mind CLI analysis with package test/build/help and MCP protocol smoke evidence.
docs/audits/2026-07-08-ai-tool-hook-t16-analysis.md	Focused AI-tool hook lifecycle analysis with Launcher/source evidence, rendered Browser smoke artifacts, hook package/root-run tests, package typechecks, compiled bin help smokes, and T16 correction candidates.
docs/audits/2026-07-08-developer-substrate-t17-analysis.md	Focused developer API, server, worker, WaggleDance, SDK, and substrate verification analysis with package/root command evidence and T17 correction candidates.
docs/audits/2026-07-08-ops-deploy-ci-judging-t18-analysis.md	Focused ops, deployment, CI, benchmark, and judging analysis with YAML/Compose/secret-safe checks, benchmark evidence, and T18 correction candidates.
docs/audits/2026-07-08-launch-funnel-t13-analysis.md	Focused public launch funnel analysis with www test/build/typecheck/route smoke evidence, rendered Browser checkout-recovery evidence, live apex/www DNS failure, download/release check, local checkout/auth recovery fixes, controlled download status page, legal placeholder guard, and remaining T13 correction candidates.
docs/audits/2026-07-08-route-evidence-t11-analysis.md	Focused installed-app route evidence analysis with route registry, direct test-reference matrix, app-test command evidence, zero-hit route findings, current all-route built-preview smoke evidence, and T11 correction candidates.
docs/audits/2026-07-08-state-failure-t12-analysis.md	Focused T12 analysis with state-slice test evidence, native dialog source evidence, five-persona state-bundle contract, and T12 correction candidates.
docs/audits/2026-07-08-mobile-executive-t2-t12-analysis.md	Fresh 390 x 844 Mobile Executive smoke evidence showing Settings visible clipping despite clean document scroll width, Memory/chat tab overflow, Command Center mobile close/label risks, and stronger T2/T12 acceptance criteria.
docs/audits/2026-07-08-shell-overlays-t10-t12-analysis.md	Focused shell-overlay smoke/source evidence for Notification Inbox, Create Workspace, Spawn Agent, Workspace Switcher, Persona Switcher, Keyboard Shortcuts, Context Rail, Onboarding Tooltips, Upgrade Modal, and Trial Expired Modal.
docs/superpowers/plans/2026-07-08-ux-phase-1-corrections.md	Bite-sized test-first implementation plan for Phase 1.

Current Decision

Approve Phase 1 before coding.

Recommended execution mode: Subagent-Driven.

Phase 1 includes only:

• Local auth/Clerk/CSP console health.
• Mobile Settings and first-run onboarding responsive layout.
• Solo/Teams/Enterprise copy cleanup.
• Ctrl+Shift+N and Workspace Switcher route contract.
• Visual snapshot triage.
• Route evidence for thin judge paths.

Not Ready To Claim

Do not mark the goal complete until:

• P0 findings are closed.
• Phase 1 and any judge-blocking P1 items are verified.
• Mobile evidence proves critical visible controls stay in-bounds, not merely that document-level horizontal overflow is absent.
• First-run onboarding evidence proves accountless clean-data setup has no Clerk/CSP console errors and mobile Profile primary action is visible or clearly reachable.
• Every registered route and major overlay has an evidence owner.
• State and failure-mode bundles are declared for each judge run.
• The five-persona judge runbook is filled with current evidence, not merely referenced.
• Launch funnel and desktop wrapper gates are fixed or explicitly deferred from the final score.
• Admin web, CLI launcher, marketplace CLI, and memory/MCP utility gates are fixed or explicitly deferred from the final score. Current admin-web rendered artifacts: output/playwright/admin-web-t15-57795/.
• AI-tool hook lifecycle gates are fixed or explicitly deferred from the final score.
• Developer API, background worker, and substrate verification gates are fixed or explicitly deferred from the final score.
• Ops, deployment, CI, benchmark, and judging gates are fixed or explicitly deferred from the final score.
• Web Guidelines line findings are fixed or explicitly assigned to T7/T8/T10/T12 deferrals.
• Runtime T10 axe/DOM findings are fixed or explicitly assigned to judge-route deferrals.
• T5 visual baseline decisions are approved after the fresh classification note; stale baselines are updated only after Phase 1 UI fixes land.
• Command Center mobile close/label-fit evidence is fixed or explicitly deferred from the Mobile Executive and Engineer score paths.
• Shell overlay T10/T12 findings are fixed or explicitly deferred, especially Notification Inbox Escape/semantics, Create Workspace semantics/mobile hierarchy, Context Rail landmarking, coach-mark semantics, and named close/icon controls.
• Source-inventory supplement findings, including Browser Companion T19, are fixed or explicitly deferred.
• Five persona scorecards are filled from current evidence.
• All five personas score at least 9/10.