# System map — nextlevelbuilder/ui-ux-pro-max-skill

> Canonical page: https://codevetter.com/unpack/ui-ux-pro-max-skill/system-map

# System map — nextlevelbuilder/ui-ux-pro-max-skill

Scanned commit dcc40ff5133ef78276117db0cc34e7b83cc8aeba (2026-09-21). Generated by codevetter codevetter 1.12.0 on 2026-09-22.

The repo is a content product, not a running service: the runtime is a stdlib-only Python 3 CLI (search.py over core.py/design_system.py) reading canonical CSVs under src/ui-ux-pro-max/data/. The TypeScript CLI under cli/ is purely an installer that renders platform templates and copies bundled assets; it never executes the Python. Distribution happens through three mirrored copies of the same data (src/ -> cli/assets/ -> .claude/skills/ui-ux-pro-max/) kept in sync by cli/scripts/sync-assets.mjs and enforced by CI. Supporting surfaces: a Next.js 14 style gallery, a stack/ sub-project that wraps the skill with Playwright/MCP tooling, and six GitHub Actions workflows covering tests, asset sync, catalog refresh, release, and version bumping.
- The runtime entrypoint is src/ui-ux-pro-max/scripts/search.py, an argparse CLI exposing --domain (12 keys of CSV_CONFIG), --stack (22 stacks), --design-system, --json, --persist/--page/--output-dir/--force, and three 1-10 dials --variance/--motion/--density. — [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#L18-112](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L18-L112)
- core.py implements a hand-rolled BM25 class (k1=1.5, b=0.75) with in-process caches _csv_cache and _bm25_cache keyed by file signature (st_mtime_ns, st_size), plus synonym normalization, per-domain score floors, and deterministic domain tie-breaking. — [src/ui-ux-pro-max/scripts/core.py#L282-463](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L282-L463) [src/ui-ux-pro-max/scripts/core.py#L197-233](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L197-L233) [src/ui-ux-pro-max/scripts/core.py#L619-661](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L619-L661)
- design_system.py contains DesignSystemGenerator plus three output formatters (format_ascii_box, format_markdown, format_master_md) and the Master+Overrides persistence layer (persist_design_system, format_page_override_md). — [src/ui-ux-pro-max/scripts/design_system.py#L258-604](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L258-L604) [src/ui-ux-pro-max/scripts/design_system.py#L640-915](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L640-L915) [src/ui-ux-pro-max/scripts/design_system.py#L995-1487](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/design_system.py#L995-L1487)
- reasoning_contract.py is a closed, non-executable DSL: ui-reasoning.csv Decision_Rules cells are JSON objects whose conditions must come from ALLOWED_CONDITIONS (must_have + 38 if_* signals) and actions must carry a constraint:/style:/pattern:/mode: prefix. — [src/ui-ux-pro-max/scripts/reasoning_contract.py#L7-55](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/reasoning_contract.py#L7-L55) [src/ui-ux-pro-max/scripts/reasoning_contract.py#L67-123](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/reasoning_contract.py#L67-L123)
- The npm CLI (cli/package.json name ui-ux-pro-max-cli v2.5.0, bin uipro -> dist/index.js) registers exactly four commander subcommands: init, versions, update, uninstall; it is ESM ('type': 'module') built by bun build with a tsc fallback in scripts/build.mjs. — [cli/package.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/package.json) [cli/src/index.ts#L18-92](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/src/index.ts#L18-L92) [cli/scripts/build.mjs#L15-29](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/build.mjs#L15-L29)
- src/ui-ux-pro-max/ is the single source of truth; cli/scripts/sync-assets.mjs mirrors data/, scripts/, templates/ into cli/assets/, mirrors data/ and scripts/ into .claude/skills/ui-ux-pro-max/, and copies 6 sub-skills (banner-design, brand, design, design-system, slides, ui-styling) into cli/assets/skills/, normalizing CRLF->LF before hashing. — [cli/scripts/sync-assets.mjs#L15-50](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/sync-assets.mjs#L15-L50) [cli/scripts/sync-assets.mjs#L177-201](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/sync-assets.mjs#L177-L201) [CLAUDE.md](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/CLAUDE.md)
- The Claude plugin surface is .claude-plugin/plugin.json + marketplace.json (version 2.13.0) pointing 'skills' at ./.claude/skills/, where SKILL.md is hand-authored (not template-generated) while its data/ and scripts/ are mirrors of src/. — [.claude-plugin/plugin.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude-plugin/plugin.json) [.claude-plugin/marketplace.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude-plugin/marketplace.json) [.claude/skills/ui-ux-pro-max/SKILL.md](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude/skills/ui-ux-pro-max/SKILL.md) [cli/scripts/sync-assets.mjs#L30-38](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/scripts/sync-assets.mjs#L30-L38)
- The gallery is a Next.js 14 + Tailwind app (gallery/package.json name style-gallery) whose server component reads gallery/data/styles.csv — a symlink into ../../src/ui-ux-pro-max/data/styles.csv — and parses it with a hand-written CSV parser. — [gallery/package.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/gallery/package.json) [gallery/app/page.tsx#L6-16](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/gallery/app/page.tsx#L6-L16) [gallery/lib/parseStyles.ts#L65-121](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/gallery/lib/parseStyles.ts#L65-L121) [gallery/data/styles.csv](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/gallery/data/styles.csv)
- stack/ is a separate private package (claude-website-design-stack) that wraps the skill with a design loop (plan -> commit aesthetic -> build -> Playwright visual check -> design-review subagent) installed by scripts/setup.sh via npx ui-ux-pro-max-cli init --ai claude. — [stack/package.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/stack/package.json) [stack/CLAUDE.md](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/stack/CLAUDE.md) [stack/scripts/setup.sh#L10-31](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/stack/scripts/setup.sh#L10-L31)
- CI is six workflows: tests.yml (verify:data + pytest over .claude/skills + Playwright e2e + gallery build), check-asset-sync.yml (drift + skill-path contract greps), smoke-stacks.yml, refresh-catalogs.yml (weekly cron), release.yml (semantic-release to npm/GitHub), bump-versions.yml (post-release JSON version sync PR). — [.github/workflows/tests.yml](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/tests.yml) [.github/workflows/check-asset-sync.yml#L24-40](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/check-asset-sync.yml#L24-L40) [.github/workflows/refresh-catalogs.yml#L3-6](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/refresh-catalogs.yml#L3-L6) [.github/workflows/release.yml#L78-90](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/release.yml#L78-L90) [.github/workflows/bump-versions.yml#L29-61](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/bump-versions.yml#L29-L61)
- Version numbers intentionally diverge: the skill/plugin manifests are at 2.13.0 while cli/package.json is 2.5.0; bump-versions.yml opens a PR to re-sync skill.json, marketplace.json, and plugin.json after each GitHub release. — [skill.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/skill.json) [.claude-plugin/plugin.json](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.claude-plugin/plugin.json) [cli/package.json#L3](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/cli/package.json#L3) [.github/workflows/bump-versions.yml#L25-45](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/.github/workflows/bump-versions.yml#L25-L45)
- Python scripts are strictly stdlib-only (csv, json, re, difflib, math, pathlib) — no requirements.txt or pyproject exists; tests run under unittest/pytest with zero third-party runtime deps, matching the documented 'no external dependencies' prerequisite. — [src/ui-ux-pro-max/scripts/core.py#L7-12](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/core.py#L7-L12) [src/ui-ux-pro-max/scripts/tests/test_core.py#L1-12](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/src/ui-ux-pro-max/scripts/tests/test_core.py#L1-L12) [README.md#L318-328](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/dcc40ff5133ef78276117db0cc34e7b83cc8aeba/README.md#L318-L328)

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)