# ux-ui-wasp-drone

ux-ui-wasp-drone — a subagent for Claude Code and Codex that enforces a project's design system on UI and components, tracks token drift, and governs shadcn/ui, Mantine, Lucide-react, and Framer Motion integration.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/ux-ui-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/ux-ui-wasp-drone

## What it does

ux-ui-wasp-drone reads the project's design system from `library/knowledge-base/<product>-ux-ui/` and handles three concerns: verifies UI against the design brief and token definitions; advises when to reach for a library (shadcn/ui, Mantine, Lucide, Framer Motion) versus writing custom code; ensures new tokens go into `01-master-tokens.css` rather than scattered through the codebase.

For each review, the subagent cites the exact design-document section, shows which line to change and what token or class to use, and references the relevant library guide. Components from external libraries always go through wrappers — your own `<Button>`, `<Icon>`, `<Motion>` — so the system stays enforceable across upgrades.

Not for building a design system from scratch (that's `design-system-wasp-drone`), backend work, or asset-registry tasks.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install web-development-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/ux-ui-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/ux-ui-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/ux-ui-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/web-development-tools/agents/ux-ui-wasp-drone.md

## When to use it
- Check UI against the design brief and find pixel-level or token-level deviations
- Pick a component from shadcn/ui, Mantine, or determine when to write custom markup
- Update design documentation when a specification changes
- Audit token drift — spot repeated color, spacing, or radius values that should be one token
- Author motion, animation and transition specs

## Example prompts
- Review this sign-up form against section 2.1 of `00-design-brief.md`
- Which Mantine component works for a dropdown menu with leading icons?
- Wrap the shadcn/ui Button primitive with our `color-action-primary` token

## Similar
- [ui-design](https://affpapa.org/en/nevibecode/skills/starchild-ai-agent-ui-design.md) — skill · 1800 installs
- [design-system-architect](https://affpapa.org/en/nevibecode/agents/design-system-architect.md) — subagent · ★ 42780 repo stars
- [design-system](https://affpapa.org/en/nevibecode/skills/rampstackco-design-system.md) — skill · 369 installs
- [animated-component-libraries](https://affpapa.org/en/nevibecode/skills/animated-component-libraries.md) — skill · 3200 installs
- [setup](https://affpapa.org/en/nevibecode/skills/aladicf-setup.md) — skill · 703 installs
- [interaction-design](https://affpapa.org/en/nevibecode/skills/interaction-design.md) — skill · 16146 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
