Contrato de Activación
Úsalo para diseñar, revisar o refinar una interfaz de terminal (paneles, raíles, barras de estado, tarjetas, prompts), especialmente Gentle Shell. La sensación objetivo es un IDE dentro de una terminal: denso, calmado, primero para desarrolladores, nunca un disfraz de cromo retro de TUI. No es para páginas web (usa gentle-design).
Reglas Estrictas
- Nunca juzgues una interfaz de terminal desde el código o la memoria: captúrala (
references/visual-loop.md) y mira el PNG antes y después de cada cambio. - Lee
references/terminal-craft.mdantes de cualquier edición de UI; es el piso, no una sugerencia. - Modo de operación: la familiaridad supera a la expresión. Usa vocabulario de IDE (paneles, árbol, pestañas, barra de estado, paleta de comandos); la marca vive en la paleta, la densidad y un movimiento característico.
- Cada fila cuesta. La jerarquía proviene del rol de color, peso y alineación, nunca de filas en blanco o cajas anidadas.
- Di cada hecho una vez por pantalla. Los datos mostrados en el encabezado nunca se repiten en un panel.
- Un comando, un objetivo. El refinamiento preserva el sistema; el rediseño lo reemplaza. Nunca pulir un aspecto que se va a desechar.
- El renderizado se mantiene barato: sin E/S ni recomputación en las rutas de renderizado, caché con clave para todo lo que cambia en la salida (estilo, ancho, tema).
- Los mockups (a través de
gentle-design) deben ser expresables en terminal: cuadrícula de celdas monoespaciadas en unidadesch, solo colores fg/bg, negrita/atenuado/cursiva/subrayado/tachado, dibujo de cajas y glifos.
Puertas de Decisión
| Pregunta | Comando | Cargar |
|---|---|---|
| Sin contexto de producto/diseño aún | document | references/design-doc.md |
| Nueva superficie o rediseño | shape, luego mockups, luego implementar | references/commands.md |
| "¿Cómo se ve / qué está mal?" | critique | references/critique.md |
| Demasiado recargado, espacio desperdiciado, redundante | distill / layout / quieter | references/commands.md |
| Plano, sin jerarquía, ilegible | typeset / colorize / bolder | references/commands.md |
| Casos límite, terminales estrechas, texto largo | harden / adapt | references/commands.md |
| Último pase antes del commit | polish | references/commands.md |
Pasos de Ejecución
- Carga el contexto de
DESIGN.mdsi el proyecto lo tiene; de lo contrario, propóndocumentprimero. - Captura el estado actual con el bucle visual en los tamaños enviados (ancho 180x50, punto de quiebre 140, estrecho 80x24).
- Ejecuta el comando elegido contra un objetivo nombrado; escribe los hallazgos antes de cambiar el código.
- Cambia, vuelve a capturar, compara con el PNG anterior y el resumen; itera como máximo 3 rondas, luego informa.
- Termina cada comando de refinamiento con comprobaciones
polishy las pruebas enfocadas del repositorio (recuentos de render, desbordamiento).
Contrato de Salida
Devuelve: objetivo, comando ejecutado, rutas de los PNGs antes/después, hallazgos corregidos etiquetados con P0-P3, hallazgos pendientes y comprobaciones realizadas.
Referencias
references/terminal-craft.md: reglas básicas y anti-patrones de terminal.references/commands.md: manuales de comandos adaptados para terminales.references/critique.md: crítica puntuada y rúbrica de gravedad.references/design-doc.md: forma de DESIGN.md para un producto de terminal.references/visual-loop.md: arnés de captura de pantalla y bucle de comparación.NOTICE.md: atribución.