Skip to content

Instrucciones para agentes ​

Eres un agente que crea o cambia interfaz en un producto de Tomatesoft. Estas reglas no se negocian. Si una tarea te pide romper una, detente y explícale a la persona por qué.

Antes de escribir código ​

  1. Identifica la plataforma: POS (táctil, pantalla completa, Tauri + React) o web (paneles con mouse, Vite + React).
  2. Lee la página de esa plataforma y solo las de los componentes que vas a tocar.
  3. Busca en el catálogo antes de crear un componente. Si existe, úsalo.

Reglas ​

  • Tokens siempre (var(--ts-*)). Nunca un color, radio, peso o tamaño de texto suelto. No inventes tokens: si falta uno, dilo como propuesta.
  • Archivo es la única familia tipográfica. No agregues otra.
  • Verde (--ts-primary) para la acción principal, una por pantalla o ventana. Rojo (--ts-accent) solo para lo irreversible, con confirmación. Nunca rojo para decorar.
  • Avisos como toast, no cajas fijas en la página.
  • Cargas con skeleton del mismo tamaño que el contenido.
  • Animaciones de 300 ms o menos, y respeta prefers-reduced-motion.
  • Textos en español de México, de tú, cortos, en el archivo de idioma (es.ts), nunca dentro del componente. Código y nombres en inglés.
  • Accesibilidad: foco visible, áreas táctiles de 44 px o más, estados con texto además de color, aria-label en botones de solo ícono.

Solo en el POS ​

  • Todo lo que se toca mide 56 px o más (mínimo 44 px).
  • Texto nunca menor a 16 px.
  • Todo campo de texto con teclado táctil (data-keyboard="text|numeric" o <TouchKeyboard />).
  • Sin barras de desplazamiento.
  • Nada que dependa de internet (fuentes, íconos, imágenes de un CDN).
  • El POS vende, no administra: si es configuración, va en el panel web.

Si algo no cuadra ​

Si la tarea pide algo que este sistema no cubre (un componente nuevo, un color nuevo), no lo improvises en silencio: hazlo con lo más cercano que exista y repórtalo como desviación.

Checklist de salida ​

Al terminar, reporta esto a la persona:

text
Tomatesoft Design — resumen
- Plataforma: POS | web
- Componentes usados: …
- Componentes nuevos o cambiados: ninguno | cuáles y por qué
- Tokens usados: …
- Valores sueltos: ninguno | cuáles y por qué
- Textos: en es.ts, de tú, cortos (sí/no)
- Accesibilidad: foco, tamaños táctiles, estados con texto (sí/no)
- POS: teclado táctil en cada campo, sin barras de desplazamiento (sí/no/no aplica)
- Desviaciones del sistema: ninguna | cuáles y por qué