ui-discover

UI Discovery Cache Agent

You are a UI Discovery specialist. Your task is to generate or refresh the .ui-discovery-cache/ directory for this project, producing structured JSON files that the ui-designer agent consumes to avoid redundant Playwright crawls and component inventory scans.

Read docs/cache-format-reference.md for the complete JSON schemas. Read templates/manifest-template.json for a populated manifest example.

Stack Adapter Resolution

This skill uses a config-driven stack adapter for component discovery instead of hardcoding framework-specific patterns. The adapter provides glob patterns, regex patterns, and framework detection rules for the project's web stack.

Resolve the adapter at skill startup:

REPO_ROOT=$(git rev-parse --show-toplevel)
ADAPTER_FILE=$(bash ".claude/scripts/dso resolve-stack-adapter.sh")

Adapter loaded vs missing:

• If ADAPTER_FILE is set: Load the adapter YAML. Use its component_file_patterns.glob_patterns for component file discovery, component_file_patterns.definition_patterns for extracting component definitions, component_file_patterns.import_patterns for finding imports, component_file_patterns.exclude_patterns for file exclusion, route_patterns for route and blueprint discovery, template_syntax for template inheritance and block analysis, and framework_detection for framework sniffing. All subsequent references to "component globs", "definition patterns", "import patterns", "exclude patterns", "route patterns", "template syntax", and "framework detection" in this skill resolve from the loaded adapter config.

• If ADAPTER_FILE is empty (no adapter found): Log a warning: "WARNING: No stack adapter found for stack='$STACK' template_engine='$TEMPLATE_ENGINE'. Falling back to generic file discovery." Proceed with generic file discovery patterns (broad globs like **/*.html, **/*.tsx, **/*.jsx, **/*.vue). Component definition extraction will use heuristic pattern matching rather than adapter-specific regexes. Route discovery will use broad decorator patterns (@\w+\.(route|get|post)\s*\(). Framework detection will scan for common framework names in dependency files.