stelow-workflow-ux-critique

Standalone awareness: inside stelow, quality gates critique depth (experimental → static a11y baseline, production → live site). Standalone defaults to production quality (live-site mode when a URL exists, else codebase/browserless mode, ~80% coverage). Works with URL, source directory, or screenshot — no stelow dependency for core audit logic.

UX Critique

Focus: Complete UX audit of interfaces — visual accessibility, usability, design, emotional journey, and AI slop detection. Inputs: URL (live site), directory (source code), or screenshot (image). Output: Classified report with gaps (🚨/🤔/🔎) + actionable recommendations.

Tools: See ../stelow-workflow-orchestrator/references/cli-tools/agent_browser.md and ../stelow-workflow-orchestrator/references/cli-tools/subagents.md for tool patterns, and ../stelow-workflow-orchestrator/references/cli-tools/ui-design-research.md for reference exemplars. The browser is the only source of rendered evidence about the build under review; a design-reference MCP is an archive of other sites and cannot supply it.

Overview

Full UX audit for visual interfaces — accessibility (WCAG AA), Nielsen heuristics, visual hierarchy, cognitive load, consistency, mobile/responsive, AI slop, emotional journey, and design personas.

Accepts 3 input types, each activating a different subset of dimensions:

Input	Detects	Dimensions covered
URL	http:// or https://	All — full live audit
Codebase	Source code directory	~80% without browser (except exact contrast, real keyboard, screen reader)
Screenshot	.png .jpg .webp file	~60% — visual hierarchy, AI slop, estimated contrast, cognitive load

Quality Gate (auto-skip for scopes without UI changes)

Before running UX critique, check if the scope involves visual UI changes and if quality warrants a full audit.

# Read quality from stelow context or env var; default production (via canonical helper).
WF_DIR="$(ls -td .stelow/*/*/ 2>/dev/null | head -1)"
# shellcheck disable=SC1091
source "$(dirname "${BASH_SOURCE[0]:-$0}")/../../stelow-workflow-orchestrator/references/cli-tools/read-config.sh"
QUALITY="${QUALITY:-$(stelow_read_quality)}"
# Check if any visual files changed (entity evidence first, churn count fallback)
UI_FILES=$(sem diff --format json HEAD~1 2>/dev/null | python3 -c "import sys,json; print(sum(1 for e in json.load(sys.stdin).get('entities', []) if str(e.get('file','')).endswith(('.templ','.html','.tsx','.jsx','.css'))))" 2>/dev/null || git diff --name-only HEAD~1 2>/dev/null | grep -cE '\.(templ|html|tsx|jsx|css)$' || echo "0")