cerebro-architect-ui
Analiza maquetas y prototipos visuales del proyecto (exportaciones de Stitch en HTML o PNG, Figma, HTML a mano) y los traduce a especificaciones técnicas, mapeando CADA control a su regla de negocio d
SKILL.md.claude/skills/cerebro-architect-ui/SKILL.md
GitHubCuándo se usa
Cuando hay que evaluar una interfaz, un prototipo o una maqueta y asegurar que esté alineada con el Cerebro Digital antes de escribir código.
Principio rector
Todo control visual mapea a una regla de negocio documentada en el OKF.
- Un control sin regla que lo respalde → no debe existir.
- Una regla sin control que la materialice → falta UI.
Las dos direcciones se chequean. La segunda es la que más se saltea.
📋 Flujo de análisis y trazabilidad
- Lectura de maquetas — archivos HTML, CSS, SVG o diseños en
entregables/disenos/yentregables/presentaciones/(presentaciones en HTML). Ahí viven los artefactos ya promovidos desdeborrador/. - Mapeo funcional con wikilinks — correlacionar cada botón, formulario y campo visible con
su regla de negocio del OKF (
[[regla-negocio]]). - Definición de componentes (Atomic Design) — átomos, moléculas y organismos.
- Generación de la especificación técnica — en
entregables/especificaciones-tecnicas/: qué APIs consumir, qué validaciones de front aplicar y qué comportamientos reactivos se esperan. El código de la aplicación no vive en este repositorio (DEC-001): la spec viaja acá y el repo de código hermano la referencia por ruta, no la copia.
🚫 Anti-patrones — prohibidos
| Anti-patrón | Qué es | Cómo se detecta |
|---|---|---|
| Fake toggle | Interruptor o botón que no persiste ni cambia estado real | No tiene una RN-xxx asociada, o al accionarlo no cambia ningún dato del dominio |
| Botón cosmético | Acción visible que no dispara ninguna operación | No hay flujo en el OKF que lo justifique |
| Estado visual huérfano | Un estado de UI (gris, deshabilitado) sin equivalente lógico | No existe regla que defina cuándo el elemento se deshabilita |
| Regla sin UI | Regla del OKF que ningún componente materializa | La regla existe y no aparece en pantalla |
| Hardcode de estado | Estado fijo en el código sin consultar el dominio | El componente no lee datos de negocio para decidir su estado |
Cómo se valida
Paso 1 — Inventariar las reglas. Para la pantalla en cuestión, listar las RN-xxx del
bundle (contexto.md, el módulo, fuentes.md) que aplican.
Paso 2 — Mapear cada control a su regla, en una tabla: componente · regla del OKF · estado según la regla.
La trampa de este paso. Una cita que simula respaldo es peor que no citar nada: pasa la revisión. Toda
RN-xxxque se escriba en esa tabla se abre y se lee. Si no dice lo que se le atribuye, el hallazgo es la cita, no el componente.
Paso 3 — Trazabilidad inversa. Toda RN del módulo tiene que tener al menos un componente que la materialice. Si sobra una RN sin UI, se reporta como hueco.
Paso 4 — Checklist.
- Cada toggle, botón y checkbox mapea a una RN del OKF, con wikilink.
- Ningún control está hardcodeado: lee el estado del dominio.
- Los estados deshabilitados o visibles corresponden a condiciones documentadas.
- No hay fake toggles: todo cambio de estado persiste.
- Toda RN del módulo tiene UI que la materialice.
- Cada
RN-xxxcitada se abrió y dice lo que se le atribuye.
🛡️ Reglas de validación visual
- Consistencia de estados — que los estados de los botones correspondan a la lógica de negocio (ej.: "Confirmar" inhabilitado si falta un dato obligatorio).
- Trazabilidad bidireccional — la especificación generada enlaza de vuelta a las reglas aprobadas del OKF, para que el analista y el programador entiendan el porqué de cada componente.
Cómo se reporta
⚠️ [Componente] viola el guardarraíl [anti-patrón]:
- Regla esperada: RN-MOD-00X (wikilink a la nota)
- Estado actual: [descripción]
- Corrección sugerida: [acción]
La corrección prioriza SIEMPRE la regla del OKF por sobre la maqueta. Si la maqueta contradice una regla verificada, la que está mal es la maqueta.