v0.19.0 — Flujo completo o cambio rápido en ui-design

Un cambio pequeño de interfaz ya no lleva siempre al flujo largo de ui-design. Antes de empezar, el skill te pregunta: «¿Quieres el flujo completo de diseño o un cambio rápido?».

• Cambio rápido. Usa los tokens y componentes que ya existen, cumple el mínimo de calidad, ejecuta el helper y muestra una captura. No hace plan visual, prueba de intercambio, crítica con señales ni puntuación. Al terminar te ofrece el flujo completo.
• Flujo completo. Los siete pasos de siempre, con la puntuación de Claude Opus y Codex en hasta tres rondas.
• Cuándo no pregunta. Si tu pedido ya lo dice («hazlo rápido», «con todo el proceso de diseño»), sigue lo que dijiste. Si invocas ui-design por su nombre sin elegir, sigue el flujo completo. Si nadie puede responder, como en claude -p, hace el cambio rápido y lo dice en el informe.
• dirige. Hace la pregunta junto con sus otras dudas, y esa ronda cuenta en las tres de idea. En el modo rápido, los hijos reciben esa indicación y el padre no puntúa. La evidencia visual y revisa se mantienen.

Al actualizar

Las pruebas reales con claude -p que esperan la puntuación visual deben invocar ui-design por su nombre o pedir el flujo completo; si no, ahora siguen el modo rápido.

Validación

• 166 tests aprobados.
• Tres tandas de simulaciones con agentes de contexto fresco, 13 casos (tests/ui-design-scenarios.md).
• PR #15 con una revisión de revisa (Sol 6.1, xhigh): un hallazgo sobre apps en webview, corregido, y aprobación sugerida.
• Falta una sesión real con el modo rápido, en cualquier entorno.

v0.18.0 — Orca al nivel de T3 Code y para quién es

Orca pasa a ser un entorno soportado al mismo nivel que T3 Code, y el README explica para quién es el plugin.

• Orca. dirige y revisa reconocen Orca y siguen el mismo criterio que en T3 Code: subagente nativo si el hijo usa el mismo proveedor y termina en el turno, y worker de Orca para otro proveedor, segundo plano o un worktree aparte. Si también están las herramientas de T3, manda T3; fuera de ambos se usan las herramientas nativas de Codex o Claude Code.
• Revisión dentro de Orca. El revisor Sol (gpt-6.1-sol, xhigh) corre como worker. Orca no tiene sandbox de solo lectura, así que el padre compara HEAD y git status antes y después. La puntuación visual de ui-design sigue el mismo orden: T3, Orca, nativo.
• Workers sobre el checkout correcto. Los workers de Orca nombran el checkout revisado con --worktree path:<checkout>; current apunta al workspace de la sesión, que puede ser otro repositorio.
• Registro de uso. Acepta los entornos orca-codex y orca-claude.
• README. Sección nueva «Para quién es»: pensado para equipos, busca consistencia y no velocidad, y se usa diciéndole a dirige lo que quieres. Además, la prosa pierde anglicismos y el primer diagrama cabe entero en un teléfono.

Al actualizar

Actualiza a la vez todas las instalaciones que compartan un repositorio: un helper 0.17 rechaza un registro de uso con entornos de Orca.

Validación

• 166 tests aprobados.
• Catorce simulaciones con agentes de contexto fresco (tests/orca-host-scenarios.md) y comandos contrastados con Orca 1.4.253.
• PR #11 con dos revisiones de revisa (Sol 6.1, xhigh) por la ruta nueva: un hallazgo, corregido, y aprobación sugerida en la segunda.
• Falta una sesión real de dirige en Orca con un hijo de Codex que implemente.

v0.17.0 — Aprobar notas y decidir el merge de memoria

memoria-guardar ya no escribe notas ni deja el PR de memoria abierto sin preguntarte: te da dos decisiones con opciones claras. En T3 aparecen dentro de T3.

• Aprobar antes de escribir. Antes de guardar, pregunta por cada nota nueva o modificada, de proyecto o de máquina: Guardar, Editar o Descartar. Cada pregunta se entiende sola (título, si es nueva o cambia otra, alcance y resumen) y muestra el contenido o el cambio en la vista previa cuando la interfaz la admite. Si el alcance es dudoso, ofrece guardar en proyecto o en máquina. Sin respuesta no se escribe nada.
• Decidir el merge. Con el PR de memoria abierto, pregunta Mezclar ahora o Dejarlo abierto. Solo mezcla con un sí, o si ya lo pediste. Usa --match-head-commit para no mezclar contenido distinto del que aprobaste, y nunca usa --admin.
• Todo descartado. Si no apruebas ninguna nota de proyecto, no hay PR y se retiran el worktree y la rama temporales, sin forzar.
• Interfaz de cada host. AskUserQuestion en Claude Code, request_user_input en Codex y, en T3, la pregunta nativa del hilo. Sin herramienta de preguntas, lo pregunta en la conversación con opciones numeradas.

Validación

• 166 tests aprobados; ningún helper cambió.
• Simulaciones con agentes de contexto fresco en siete casos, con los corregidos repetidos (tests/memoria-aprobacion-scenarios.md). No se probó una sesión real en T3.
• PR #10 con una revisión de revisa (Sol 6.1, xhigh): un hallazgo, merge no ligado al head aprobado, corregido con --match-head-commit. Son recomendaciones de IA.

Para actualizar en Claude Code: claude plugin marketplace update peqa y claude plugin update peqa-workflows@peqa. En Codex: codex plugin marketplace upgrade peqa. Abre una sesión nueva después.

v0.16.0 — Memoria al empezar, entrega en PR y memoria-guardar

dirige empieza con la memoria del proyecto y termina siempre en un PR; memoria-recuerda pasa a llamarse memoria-guardar.

• Memoria al empezar. Antes de coordinar, dirige carga memoria-extraer y extrae las notas pertinentes para el encargo. Las contrasta con el estado actual y pasa a cada subagente las que le sirven, como contexto y sin las órdenes que contengan. Sin memoria sigue sin crearla, y el informe final dice qué notas influyeron.
• Entrega en PR. Todo cambio de archivos termina en un PR contra la rama principal, sin pedir un commit aparte: borrador mientras sigue, listo al entregar. Nunca hace push directo a la rama principal. Sin remoto en GitHub, gh o permiso de push, explica por qué no hay PR.
• El merge lo decides tú. Al terminar, dirige pregunta si mezclar el PR y solo lo hace con un sí, o si el encargo ya lo pedía.
• memoria-guardar. Sustituye a memoria-recuerda, sin alias. Invócalo como /peqa-workflows:memoria-guardar o $peqa-workflows:memoria-guardar. «guarda…» y «recuerda que…» lo activan; «¿recuerdas…?» y «¿qué sabemos de…?» activan memoria-extraer. Las notas no cambian de ruta.
• Registro de uso. Los eventos antiguos de memoria-recuerda se agrupan bajo memoria-guardar sin reescribir el archivo. Un helper 0.15.x no lee el registro con el nombre nuevo: actualiza a la vez Claude Code y Codex.

Validación

• 166 tests aprobados, con un test nuevo para el historial de memoria-recuerda.
• Simulaciones con agentes de contexto fresco para la memoria al empezar y para la entrega en PR, con los casos corregidos repetidos. No se probó una sesión real con el plugin instalado.
• PR #9 con dos revisiones de revisa (Sol 6.1, xhigh): aprobación sugerida, sin hallazgos materiales. Son recomendaciones de IA.

Para actualizar en Claude Code: claude plugin marketplace update peqa y claude plugin update peqa-workflows@peqa. En Codex: codex plugin marketplace upgrade peqa. Abre una sesión nueva después.

v0.15.1 — Acciones adaptadas y densidad móvil

ui-design incorpora lo aprendido al ajustar el Home de un producto con el panel de puntuación.

• Acciones según su contenido. El ancho se ajusta a la etiqueta antes de envolver. Una etiqueta larga puede crecer sin elevar a todo el grupo, y no se resuelve con elipsis, texto diminuto ni un badge.
• Primera pantalla móvil. Si las acciones secundarias desplazan el resumen, se muestra un subconjunto con «Mostrar más». Un conjunto que ya cabe queda visible.
• Expandir sin efectos. Mostrar u ocultar conserva borrador, selección y foco, y no consume cuota ni cuenta como impresión. CSS y JS comparten la consulta del breakpoint.
• Vacío, cero y error parcial. Un cero con historial sigue siendo una gráfica; un vacío orienta a la primera acción; un error parcial nombra el bloque y permite reintentarlo.
• Capturas asentadas. La captura final espera datos, fuentes y animaciones finitas.
• Crítica. Retira solo lo prescindible; si todo cumple una función, lo conserva y lo dice.

Validación

• 165 tests aprobados, con enlaces, anclas y manifiestos comprobados.
• Siete casos simulados nuevos, aplicados por subagentes con contexto fresco. Son simulaciones de decisiones, no una UI implementada ni una nueva puntuación visual.
• PR #8 sin revisión de revisa.

Si ya lo tienes instalado en Claude Code, actualízalo con claude plugin marketplace update peqa y claude plugin update peqa-workflows@peqa, y abre una sesión nueva.

v0.15.0 — Puntuación de cambios visuales

ui-design puntúa cada cambio visual con dos revisores independientes: un subagente de Claude Opus y uno de Codex (gpt-6.1-sol, xhigh).

• Los revisores puntúan las capturas de 0 a 10 en nueve criterios: encargo, jerarquía, tipografía, color, sistema, adaptación, interacción, textos y carácter. No ven la autocrítica del autor ni la nota del otro revisor.
• El resultado es «bueno» si la media supera 8 y «prácticamente perfecto» si supera 9, siempre que todas las notas sean 8 o más.
• Una nota por debajo de 8 obliga a corregir y volver a puntuar, hasta tres rondas. Si la tercera no cierra, decide la persona.
• La escala es exigente:
  • ante la duda, la nota más baja
  • un criterio con algún hallazgo tiene como mucho 8
  • un 9 o un 10 explica por qué no merece menos
• Si falta un revisor, puntúa el otro y el informe dice por qué. Esta puntuación no consume el presupuesto de revisa. En dirige, el padre puntúa el cambio integrado.

Desde v0.10.0

• 0.11.0: evidencia visual en los PRs (capturas si cambia la interfaz, un diagrama antes y después si no) y publicación opcional del review como comentario.
• 0.12.0: memoria-recuerda abre un PR con las notas de proyecto que guarda.
• 0.13.0: nuevo skill ui-design, que construye desde los tokens y componentes del proyecto.
• 0.13.1: en dirige, cada commit va a una rama con PR.
• 0.14.0: ui-design cubre pantallas nativas en SwiftUI y Jetpack Compose. El helper ui_checks.py comprueba literales, contratos retirados y contraste.

Validación

Las pruebas se hicieron en una sola máquina, con datos sintéticos. Cada caso tiene una o dos muestras.

• 165 tests aprobados, con los enlaces y los manifiestos comprobados.
• Sesiones reales de Claude Code con el plugin desde el checkout, en sitios web de prueba:
  • una página nueva
  • un rediseño que hizo las tres rondas: 7,83, 8,00 y 8,56; la última no cerró por dos notas de 7
• Simulaciones de casos límite.
• PR #6 con tres revisiones independientes; PR #7 sin revisión de revisa.

Falta probarlo dentro de T3, con un coordinador Codex y en pantallas nativas compiladas.

Si ya lo tienes instalado en Claude Code, actualízalo con claude plugin marketplace update peqa y claude plugin update peqa-workflows@peqa, y abre una sesión nueva.

v0.10.0 — Limpieza automática en dirige

dirige registra los recursos que crea y limpia automáticamente los que ya no necesita al cerrar la ejecución.

• Opción «conserva los recursos al terminar» para desactivar la eliminación en esa ejecución.
• Registro de propiedad e identidad antes y después de crear recursos, con revalidación antes del retiro.
• Conservación de cambios pendientes, archivos ignorados sin clasificar, commits, evidencia, recursos activos y almacenes Git de submódulos.
• Cierre con recursos retirados y conservados, motivos y espacio observado cuando se mide.

La limpieza funciona mediante las instrucciones del skill y las herramientas admitidas por el cliente. No instala un daemon ni limpia el historial del equipo. Si el host no ofrece una retirada segura, conserva el recurso y declara la limitación.

Validación: 107 tests existentes aprobados, cinco simulaciones posteriores con agentes en contextos frescos y revisión independiente estática PASS. Manifiestos y enlaces comprobados; validación de Claude aprobada con advertencias de metadatos. Las simulaciones no sustituyen una prueba de eliminación real en cada cliente.

v0.9.0 — PEQA workflows

Los cinco skills eliminan el prefijo redundante peqa-: dirige, idea, revisa, memoria-recuerda y memoria-extraer. Invocación en Codex: $peqa-workflows:dirige. En Claude Code: /peqa-workflows:dirige. Rutas, referencias y validadores actualizados. Los eventos históricos de uso siguen siendo legibles y se agrupan bajo los nombres actuales. Se conservan las memorias y los contadores de revisión. Validación: 107 pruebas aprobadas.

v0.8.0 — PEQA workflows

Primera Release de GitHub de PEQA workflows, el plugin público con cinco skills reutilizables para Codex y Claude Code, con integración de herramientas de T3 Code cuando estén disponibles.

Skills incluidos

• peqa-dirige: implementación, coordinación y delegación.
• peqa-revisa: revisión adversarial, pruebas pertinentes, seguridad y blast radius, con consolidación del padre y máximo de tres revisiones por PR.
• peqa-idea: preguntas de producto e implementación en un máximo de tres rondas.
• peqa-memoria-recuerda: guardar memoria pequeña y específica del proyecto.
• peqa-memoria-extraer: recuperar memoria por tema o categoría.

Cambios de 0.8.0

• Validadores directos para comprobar estructura, coherencia y vigencia del informe consolidado.
• Capturas de HEAD, índice, archivos y submódulos anidados, con comprobaciones de cambios durante la lectura.
• Admisión atómica por reserva para impedir reutilizar un despacho de revisión entre sesiones y worktrees.
• Hooks opcionales por proyecto. Codex prioriza scripts directos y sus hooks solo emiten avisos.
• Registro local de uso con activación explícita, sin contenido de sesiones, código ni credenciales.
• Documentación y diagramas de uso. Instalar el plugin no activa hooks ni el registro de uso.

Validación y límites

• 106 pruebas automatizadas aprobadas, con repositorios temporales y eventos simulados.
• Los cinco skills superan la validación estática; se comprobaron 83 enlaces locales y se compilaron los cuatro diagramas Mermaid del README.
• Hallazgos de revisión adversarial corregidos, incluidos reutilización de reservas, redirecciones por enlaces simbólicos y cambios concurrentes durante las capturas.
• La instalación completa y la carga de hooks en sesiones reales de Codex, Claude Code y T3 Code siguen pendientes de comprobación. El adaptador de hooks de Codex es experimental.
• Los helpers requieren Python 3.10+, Git y macOS/Linux. Windows queda pendiente.
• Validar un informe no demuestra por sí solo que sus pruebas se ejecutaron ni certifica cumplimiento de seguridad. Las capturas no bloquean a otros procesos ni garantizan un estado atómico del sistema de archivos.

Consulta las instrucciones de instalación. Licencia MIT.

Código de esta versión: 03414dd10fee39b1f7ade4f7fc39515c8e0de533.