# Behavior traces — nextlevelbuilder/ui-ux-pro-max-skill > Canonical page: https://codevetter.com/unpack/ui-ux-pro-max-skill/behavior-traces # Behavior traces — nextlevelbuilder/ui-ux-pro-max-skill Scanned commit dcc40ff5133ef78276117db0cc34e7b83cc8aeba (2026-09-21). Generated by codevetter codevetter 1.12.0 on 2026-09-22. Three primary flows were traced end-to-end. (1) Domain search: argparse -> search() -> identity/auto-detect -> _search_csv_detailed -> BM25 -> calibrated abstention -> format_output. (2) Design system: generate_design_system -> DesignSystemGenerator.generate -> product search -> reasoning rules -> 5-domain fan-out -> mode-aware palette -> formatter -> optional atomic persist. (3) Install: uipro init -> detectAIType -> prompt -> templateInstall -> renderSkillFile + copyDataAndScripts + copySubSkills. A fourth maintenance flow (sync/check-assets and the relevance gate) is also traced. - Domain search order: __main__ argparse -> search(query, domain, max_results) -> _valid_max_results -> if domain omitted, _load_rows_or_empty(styles.csv) + _style_identity(allow_contained=False), else detect_domain -> _search_csv_detailed -> _load_csv_snapshot -> _get_bm25 -> BM25.score -> threshold abstain -> _project_row -> format_output. — [src/ui-ux-pro-max/scripts/search.py#L96-177](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/search.py#L96-L177) [src/ui-ux-pro-max/scripts/core.py#L755-845](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L755-L845) [src/ui-ux-pro-max/scripts/core.py#L414-463](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L414-L463) - Zero-result path: abstained search -> out['suggestions'] from _suggest_terms/_suggest_identities -> format_output prints 'No matches...' plus closest terms, instructing the agent to retry once and label fallbacks — matching SKILL.md's 'do not fabricate' contract. — [src/ui-ux-pro-max/scripts/core.py#L836-845](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L836-L845) [src/ui-ux-pro-max/scripts/search.py#L64-82](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/search.py#L64-L82) [.claude/skills/ui-ux-pro-max/SKILL.md#L167-172](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude/skills/ui-ux-pro-max/SKILL.md#L167-L172) - Deprecated-style redirect path: _style_identity exact match -> _style_search_destination -> Parent Style ID lookup or Replacement Domain/ID -> either the parent row is projected or a redirect object is emitted that format_output renders as 'modeled in the domain as '. — [src/ui-ux-pro-max/scripts/core.py#L736-752](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L736-L752) [src/ui-ux-pro-max/scripts/core.py#L792-805](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L792-L805) [src/ui-ux-pro-max/scripts/search.py#L64-72](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/search.py#L64-L72) - Design-system trace order: generate_design_system -> DesignSystemGenerator.__init__ (_load_reasoning, _load_styles, _build_style_lookup, _load_landing_patterns) -> generate -> search(query,'product',1) -> _apply_reasoning -> _find_reasoning_rule -> parse_decision_rules -> apply_decision_rules -> _multi_domain_search -> _select_best_match -> _resolve_color_mode/_select_palette_for_mode -> dict assembly. — [src/ui-ux-pro-max/scripts/design_system.py#L261-355](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L261-L355) [src/ui-ux-pro-max/scripts/design_system.py#L449-604](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L449-L604) [src/ui-ux-pro-max/scripts/design_system.py#L919-957](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L919-L957) - Persistence trace: persist_design_system -> safe_slug -> mkdir design-system//pages -> format_master_md -> _write_persisted_file (NamedTemporaryFile + fsync + os.link) -> FileExistsError -> status 'skipped_exists' unless --force (os.replace); --page additionally runs format_page_override_md -> _generate_intelligent_overrides -> _detect_page_type. — [src/ui-ux-pro-max/scripts/design_system.py#L961-1073](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L961-L1073) [src/ui-ux-pro-max/scripts/design_system.py#L1381-1490](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L1381-L1490) - Install trace: uipro init -> initCommand -> detectAIType(cwd) probes ~20 marker dirs -> prompts select -> (dry-run: planPlatformInstallActions/planAllPlatformInstallActions, write nothing) -> templateInstall -> generatePlatformFiles -> loadPlatformConfig(AI_TO_PLATFORM) -> resolveInstallPaths -> renderSkillFile -> writeFile -> copyDataAndScripts -> copySubSkills. — [cli/src/commands/init.ts#L133-231](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/commands/init.ts#L133-L231) [cli/src/utils/detect.ts#L10-91](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/utils/detect.ts#L10-L91) [cli/src/utils/template.ts#L286-355](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/utils/template.ts#L286-L355) - Asset-sync check trace: `npm run check:assets` -> sync-assets.mjs --check -> checkAssets -> diffDir over {data,scripts,templates} vs cli/assets, 6 sub-skills vs cli/assets/skills, and {data,scripts} vs .claude/skills/ui-ux-pro-max -> fileHash (LF-normalized sha256) -> any missing/extra/stale file exits 1. — [cli/scripts/sync-assets.mjs#L87-120](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/sync-assets.mjs#L87-L120) [cli/scripts/sync-assets.mjs#L142-175](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/sync-assets.mjs#L142-L175) [cli/package.json#L17](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/package.json#L17) - Relevance-gate trace: evaluate-relevance.py -> load_json(cases/thresholds/baseline) -> runtime_fingerprint + oracle_fingerprint (sha256 over code+data) -> validate_fixture/validate_identities -> per case: search/search_stack/DesignSystemGenerator.generate -> precision@k, MRR, nDCG, routing accuracy, negative abstention -> check_thresholds -> SystemExit with suspect-case diff on failure. — [scripts/evaluate-relevance.py#L34-59](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/scripts/evaluate-relevance.py#L34-L59) [scripts/evaluate-relevance.py#L141-253](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/scripts/evaluate-relevance.py#L141-L253) - Update trace: uipro update -> getLatestRelease (GitHub API with optional UI_PRO_MAX_GITHUB_TOKEN/GITHUB_TOKEN bearer) -> semver-gate the tag -> execFileSync npm install -g -> else fall through to initCommand(force:true) to refresh skill files in place. — [cli/src/commands/update.ts#L38-98](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/commands/update.ts#L38-L98) [cli/src/utils/github.ts#L49-91](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/utils/github.ts#L49-L91) - Skill-runtime trace (as installed): agent reads SKILL.md -> invokes `python /scripts/search.py` -> UTF-8 stdout wrapper -> search/design-system output -> agent synthesizes; references/quick-reference.md and pro-rules.md are read on demand, not loaded eagerly. — [.claude/skills/ui-ux-pro-max/SKILL.md#L37-46](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude/skills/ui-ux-pro-max/SKILL.md#L37-L46) [.claude/skills/ui-ux-pro-max/SKILL.md#L212-214](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude/skills/ui-ux-pro-max/SKILL.md#L212-L214) [src/ui-ux-pro-max/scripts/search.py#L35-39](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/search.py#L35-L39) Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers. ## Public product links - [CodeVetter](https://codevetter.com/) - [Download](https://codevetter.com/download) - [Documentation](https://codevetter.com/docs/) - [Source](https://github.com/Codevetter/codevetter)