Plugin de Claude Code · código abiertoClaude Code plugin · open source

design-review

Tu interfaz hecha por IA deja de salir como una plantilla SaaS intercambiable. El pipeline no te deja darla por terminada hasta que un veredicto en navegador real dice que solo podría ser tu producto. Your AI-built UI stops shipping as an interchangeable SaaS template. The pipeline won't let you call it done until a real-browser verdict says it could only be your product.

8agentesagents
4lentes en paraleloparallel lenses
7playbooks fijados por commitcommit-pinned playbooks
3veredictos posiblespossible verdicts

Qué haceWhat it does

Los skills de diseño de terceros producen resultados genéricos y se saltan sus propios pasos de setup si nadie los fuerza. design-review los hace correr de verdad: primero investiga referencias reales y vivas del dominio —Dribbble, competidores, productos ya publicados— nunca memoria del modelo. Después lanza 4 lentes de diseño distintas en paralelo sobre lo construido, cada una con un playbook que corrige cómo esa herramienta se comporta mal por su cuenta.Third-party design skills produce generic output and skip their own setup steps if nobody forces them to. design-review makes them actually run: it first studies real, live references for the domain — Dribbble, competitors, already-shipped products — never model memory. Then it runs 4 distinct design lenses in parallel over the result, each with a playbook that corrects how that tool misbehaves on its own.

El owner solo responde una pregunta —un multi-select con las recomendaciones ya marcadas. Al final, un agente renderiza la interfaz en un navegador real —claro, oscuro y móvil—, la compara con las referencias y escribe el veredicto en verdict.json. Un hook PostToolUse avisa —o, si lo configuras, te lo devuelve como error, aunque no evita la escritura, que ya ha ocurrido— cuando se escribe un fichero de UI sin un veredicto alive vigente.The owner answers exactly one question — a multi-select with recommendations already marked. At the end, an agent renders the UI in a real browser — light, dark and mobile —, diffs it against the references and writes the verdict to verdict.json. A PostToolUse hook warns — or, if you configure it, hands it back as an error, though it can't prevent the write, which has already happened — when a UI file is written without a current alive verdict.

Ejemplo realReal example

Corres /design-review:run sobre una pantalla de ajustes. Sale un multi-select con hallazgos deduplicados por lente ("contraste de texto secundario 2,85:1 — falla WCAG AA", "sin movimiento de firma: entrada escalonada de la referencia #3"). El veredicto pasa de templated a alive tras aplicar los cambios — y si vuelves a tocar ese fichero sin re-verificar, el hook lo vuelve a marcar.You run /design-review:run on a settings screen. Out comes a multi-select of findings deduplicated by lens ("secondary text contrast 2.85:1 — fails WCAG AA", "no signature motion: staggered entrance from reference #3"). The verdict goes from templated to alive once the changes land — and if you touch that file again without re-verifying, the hook flags it again.

Cómo funciona, en diagramasHow it works, in diagrams

Diagramas interactivos hechos con Archify, sacados del propio repo: recorre los caminos, haz zoom o ábrelos a pantalla completa.Interactive diagrams built with Archify, taken from the repo itself: trace the paths, zoom in, or open them full screen.

Diagrama del pipeline de design-review: preflight, audit-first, investigación de referencias, context-pack, cuatro lentes en paralelo, multi-select del owner, aplicación y veredicto de vitalidad con bucle.Diagram of the design-review pipeline: preflight, audit-first, reference research, context-pack, four parallel lenses, the owner multi-select, apply, and the vitality verdict with its loop.
fig. 1El pipeline, pasos 0 a 7The pipeline, steps 0-7Abrir interactivo ↗ (pestaña nueva)Open interactive ↗ (new tab)
Diagrama del hook PostToolUse: al escribir un fichero de UI comprueba verdict.json y, según DESIGN_REVIEW_GATE, avisa, bloquea o no hace nada.Diagram of the PostToolUse hook: when a UI file is written it checks verdict.json and, depending on DESIGN_REVIEW_GATE, warns, blocks or stays off.
fig. 2El hook design-review-gateThe design-review-gate hookAbrir interactivo ↗ (pestaña nueva)Open interactive ↗ (new tab)

Por qué importaWhy it matters

Cómo se usaHow it's used

/design-review:run <ruta o componente> dentro de Claude Code. El pipeline hace el resto: investigación de referencias, las 4 lentes en paralelo, tu única decisión, y el veredicto final medido en un navegador real./design-review:run <path or component> inside Claude Code. The pipeline does the rest: reference research, the 4 parallel lenses, your one decision, and the final verdict measured in a real browser.

Compone conComposes with

working-methods invoca este plugin automáticamente en la fase de verify de /forge-run sobre diffs de UI — pero funciona igual de bien solo, invocado a mano.working-methods invokes this plugin automatically in /forge-run's verify phase on UI diffs — but it works just as well standalone, invoked by hand.

working-methodslo invoca en la fase verify de /forge-runinvokes it in /forge-run's verify phase
forge-methodologymismo criterio binario de hallazgosame binary finding criterion
token-economysus lentes ya corren read-only + terse por dentroits lenses already run read-only + terse internally
swarmdominio de diseño propio, no depende de este pluginits own design domain, doesn't depend on this plugin

Preguntas frecuentesFrequently asked questions

¿Qué hace design-review?What does design-review do?

Antes de diseñar nada, estudia referencias reales y vivas. Luego cuatro lentes de diseño read-only revisan el resultado en paralelo, y un veredicto final renderiza la interfaz en un navegador real.Before designing anything, it studies real, live references. Then four read-only design lenses review the result in parallel, and a final verdict renders the UI in a real browser.

¿Qué es el veredicto alive/templated/flat?What is the alive/templated/flat verdict?

Un resultado verificable por máquina: el pipeline renderiza el diseño en un navegador real, lo compara con referencias vivas y solo pasa a alive cuando el diseño no podría confundirse con una plantilla genérica.A machine-checkable result: the pipeline renders the design in a real browser, diffs it against live references and only reaches alive when the design couldn't be mistaken for a generic template.

¿Cómo se instala?How do I install it?

Con /plugin marketplace add davidgarciagordo/claude-plugins y luego /plugin install design-review@davidgarciagordo-plugins. Se invoca con /design-review:run <ruta>.With /plugin marketplace add davidgarciagordo/claude-plugins then /plugin install design-review@davidgarciagordo-plugins. Invoked with /design-review:run <path>.

¿Es gratis y de código abierto?Is it free and open source?

Sí — licencia MIT, publicado en GitHub.Yes — MIT license, published on GitHub.

InstalaciónInstall

Un plugin, un comando.One plugin, one command.

$ /plugin marketplace add davidgarciagordo/claude-plugins
$ /plugin install design-review@davidgarciagordo-plugins