Communitygithub.com

demo-review-flow

Flujo para cambios en la interfaz de usuario que requieren aprobación visual mediante una demo funcional antes de escribir código de producto.

¿Qué es demo-review-flow?

Este flujo está diseñado para cualquier cambio que afecte cómo se ve, dónde se ubica o cómo se opera un elemento de la interfaz de usuario, sin importar su tamaño o plazo. En lugar de pasar directamente a la implementación, se construye una demo funcional (con clics, teclas, animaciones y ambos temas) que el usuario debe aprobar explícitamente por cada funcionalidad. Una vez aprobado, se porta al código de producto con evidencia en vivo y solo se considera verificado cuando el usuario lo acepta en la aplicación real. El flujo se apoya en un tablero de revisión (Artifact + base de datos compartida) que rastrea cada funcionalidad por seis estados, evitando así commits no aprobados, desalineaciones con apps de referencia y verificaciones falsas. Es compatible con cualquier agente de IA que opere sobre proyectos de UI (como Claude Code, Cursor, Codex) y se integra con guías de configuración, portabilidad y superpoderes del equipo.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whats2000/demo-review-skills/tree/HEAD/skills/demo-review-flow

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Flujo de revisión con demo

Las pruebas y la revisión de código verifican el mecanismo. No pueden decirte que el menú está en el lugar incorrecto, que el cierre parpadea o que el icono está 2 px bajo — solo el usuario puede hacerlo. Por eso, un cambio de apariencia o manejo se diseña como una demo funcional que el usuario aprueba por funcionalidad antes de escribir código de producto, y se cierra solo cuando el usuario lo acepta en la aplicación real. Un tablero de revisión (una página Artifact con una base de datos compartida) rastrea cada funcionalidad a través de seis estados.

Configuración del proyecto: .claude/demo-board.md (URL del tablero, apps de referencia por área, anchos a verificar, aplicación en vivo + si contiene datos reales, puertos de copias del workspace, comandos de puerta, archivo de especificaciones). Si falta → crear el tablero primero: references/board-setup.md.

Cuál camino seguir

  • Cambia cómo se ve algo, dónde se sitúa o cómo se maneja → este flujo. Sin excepción por tamaño o plazo.
  • Restaura el comportamiento que ya define la especificación o una demo aprobada (caída, datos incorrectos, desbordamiento, regresión) → corregir directamente con TDD, sin demo. Dile al usuario qué camino juzgaste que era.
  • Un error reportado sobre un elemento ya enviado al tablero → volver a porting, corregir, verificar en vivo, shipped. Una corrección que cambie la apariencia → nueva ronda de demo.

El flujo

  1. Referencia primero. Para el área, busca las aplicaciones que los usuarios ya conocen (la configuración las lista). Registra dónde se sitúa el control, cada tecla, el movimiento incluyendo las salidas. Desvía solo con un motivo declarado. Una encuesta entre usuarios simulados elige entre opciones; nunca reemplaza la referencia.
  2. Mide la UI real. Toma capturas de las pantallas enviadas que el cambio toca, en los anchos del usuario, solo lectura, y mide márgenes, tamaños, alineación. Diseña sobre ese diseño.
  3. Construye la demo como una entrada feat() que realmente funcione: clics, teclas, movimiento incluyendo salidas, claro + oscuro, ancho estrecho. → references/add-feature.md
  4. Regístrala: una fila changes y features/<id> → review.
  5. Entrega y detente. Enlace + qué revisar. Sin código de producto para este elemento hasta que esté approved. "Adelante a menos que te opongas" no es una aprobación. Si la aprobación no puede llegar antes de un plazo, ofrécele al usuario lo que ya se envía para ello — nunca construyas por adelantado.
  6. Recoge las decisiones al inicio de cada sesión de UI y siempre que el usuario diga que ha revisado: lee features. approved → 7. changes → la note es la solicitud → 3. El usuario dice que aprobó pero la BD no está de acuerdo → el clic no se guardó: díselo, establécelo por él.
  7. Porta de inmediato — el usuario no revisa planes; su criterio es el paso 9. Pon porting; breve según references/port-brief.md. Un agente de portabilidad por área de archivos. Las migraciones se ejecutan sobre una copia del workspace; sobre datos en vivo solo con aprobación explícita y una copia de seguridad.
  8. Envía solo con evidencia en vivo (mediciones, movimiento fotograma a fotograma, ambos temas, los anchos del usuario): shipped + una línea changes + qué verificar.
  9. Verificado es decisión del usuario — su clic en Aceptar, o que él diga en el chat que este elemento está aceptado (entonces tú lo estableces). Un "se ve bien" vago → pregunta qué elementos. Nunca por tu propio criterio.

Estados, quién los establece, el esquema de la BD, escrituras → references/lifecycle.md. Transferencias con lluvia de ideas, planes de escritura, desarrollo dirigido por subagentes, verificación y finalización de ramas → references/superpowers-integration.md.

Seguridad en verificación en vivo

En una aplicación en vivo con datos reales: navega solo lectura, haz clic solo en etiquetas exactas, nunca elimines/borres/edites allí — cualquier verificación que cambie datos se ejecuta sobre una copia del workspace.

Racionalizaciones

PensamientoRealidad
"Es pequeño / fácil de deshacer"El tamaño no es la prueba; lo es apariencia-o-manejo. Los cambios pequeños de UI son donde la ubicación falla.
"Plazo mañana"Una ronda de demo son minutos; una ubicación incorrecta enviada a la demo cuesta más. Mantén el orden, indica el cronograma.
"Mostraré capturas y seguiré a menos que se opongan"El silencio no es aprobación, y una captura de una compilación terminada no es una demo que puedan manejar.
"El lugar correcto es obvio desde primeros principios"Nombra la aplicación de referencia. "Donde los usuarios miran" es cómo se envió el interruptor imposible de encontrar.
"Las pruebas, la revisión y la compilación están en verde, así que está listo"Eso es porting completo. shipped necesita evidencia en vivo; verified necesita al usuario.
"'Se ve bien, supongo' significa aceptado"La aceptación es por elemento. Pregunta cuál.
"De todas formas aprobarán; construiré por adelantado para el plazo"El código no aprobado es el tipo desperdiciado. Indícales lo que se envía hoy; porta en cuanto aprueben.
"Inventaré un estado más claro"Solo seis estados; la página y el usuario leen estos.
"Portar y demo juntos para ahorrar tiempo"Solo los elementos approved reciben código de producto.

Banderas rojas — detente

  • Abrir un componente de producto antes de que la demo muestre el diseño.
  • Un diseño sin una aplicación de referencia nombrada, o sin medición de la UI real.
  • shipped sin evidencia en vivo; verified sin la palabra del usuario sobre ese elemento.
  • Hacer clic en Eliminar/Borrar/Guardar en una aplicación que contenga datos reales.
  • Dos agentes de portabilidad sobre los mismos archivos; ejecutar una migración sobre datos en vivo.

Skills relacionados