- Python 100%
| .codex-plugin | ||
| docs | ||
| skills/design-director | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
Gopotyata Design Director
Gopotyata Design Director is a source-backed Codex plugin for UI, mobile app, Figma, and frontend redesign work.
It gives agents a compact protocol:
Understand -> Choose Route -> Select Tools -> Produce Artifact -> Verify
The plugin is designed to avoid design bureaucracy. A run should end with one useful output:
- an audit with prioritized fixes;
- a code-ready implementation brief;
- a Figma handoff;
- an applied UI diff with screenshots;
- a visual QA report.
Figma MCP is a first-class route when the task needs design source, design creation, code-to-design sync, or handoff.
Design work is content-locked by default: agents may improve visual structure, hierarchy, spacing, typography, states, and Figma/code handoff, but they must not rewrite offers, claims, FAQ, legal text, category names, or brand voice without explicit approval. If the user explicitly approves content changes, that approval is scoped to the named content types and surfaces.
Design Director is the parent router. It does not use all tools at once:
- source truth owns content;
- UI/UX Pro Max owns grounded design direction;
- Taste, Impeccable, and Emil Kowalski are critique lenses;
- Figma, Motion, Playwright, Magic, Firecrawl, and MarkItDown are route tools.
Use Magic only for draft variants, Figma only when an editable design/handoff is useful, and Playwright for browser proof. Creative visual variants may change layout, hierarchy, art direction, and motion boldly while content remains locked unless explicitly unlocked.
Source Stack
The plugin does not rely on generic model taste alone. It now contains a source registry and a vendored UI/UX Pro Max engine.
Required local layer:
nextlevelbuilder/ui-ux-pro-max-skill, vendored underskills/design-director/vendor/ui-ux-pro-max, with searchable product, style, color, typography, UX, chart, and stack rules.
External source/tool layers:
- Impeccable for anti-slop command vocabulary and detector model.
- Taste Skill for brief inference, design variance, motion/density, and redesign posture.
- Emil Kowalski skill for motion and microinteraction craft.
- Firecrawl MCP for public URL brand/content/reference extraction.
- Magic MCP for component and screen variant generation.
- Motion for React for meaningful React motion implementation.
- Figma MCP for editable design, handoff, source inspection, and code-to-design sync.
- Playwright for browser screenshots, responsive/interaction evidence, console sanity, and fallback source capture.
- MarkItDown for converting selected PDFs, Office files, HTML, and long source artifacts into Markdown/source packs before design analysis.
Before non-trivial design work:
python3 skills/design-director/scripts/design_source_preflight.py --require ui-ux-pro-max
python3 skills/design-director/scripts/design_intelligence.py "florist ecommerce" --design-system --format markdown
For document-heavy or browser-verified work:
python3 skills/design-director/scripts/design_source_preflight.py --require markitdown
python3 skills/design-director/scripts/design_source_preflight.py --require playwright
Every design run must report a compact source trace: what was used, unavailable, not needed, or handled by fallback.
See skills/design-director/references/routing-matrix.md for route-based tool
selection and stable Playwright QA rules.