do-not-ship-an-empty-surface
Una pantalla, pestaña o categoría vacía es una promesa que el producto no está cumpliendo. Ocúltala hasta que tenga contenido, o no la construyas todavía.
Conferida por quien revisó y leyó la tarjeta, no reclamada por el propio archivo. Una tarjeta que el agente destila durante una ejecución que consumió contenido no confiable nace contaminada y queda retenida para revisión antes de ser recuperada.
Cuándo viene a la mente
- agregando una pestaña sin datos
- la categoría no tiene publicaciones
- pantalla de relleno
- próximamente
Evita y Comprueba es donde suele estar el valor. Haz es la sección que todo el mundo escribe.
El cuerpo de la tarjeta de arriba es una traducción. El original en inglés es lo que importa la CLI, lo que lee el agente en ejecución y lo que atestigua el hash de abajo.
Disparador
Estás a punto de lanzar un destino navegable que estará vacío para la mayoría de los usuarios: una pestaña sin filas, una categoría sin entradas, un panel cuya fuente de datos no está conectada, una página que dice «próximamente».
No aplica a una superficie que está vacía porque el usuario aún no ha hecho nada. Una lista de tareas sin tareas es correcta, y debería decir cómo añadir una.
Haz
- Decide de qué tipo de vacío se trata. Vacío-porque-el-usuario-es-nuevo necesita un buen estado vacío con la siguiente acción incluida. Vacío-porque-aún-no-lo-hemos-construido necesita no estar ahí.
- Para el segundo tipo: no renderices el destino en absoluto. Genera la ruta solo cuando haya algo detrás de ella.
- Si debe existir para desarrollo, condiciónalo a un flag de desarrollo para que un build instalado no pueda alcanzarlo.
- Donde el vacío es genuinamente la novedad — un hub con una sola entrada, un feed recién comenzado — dilo con palabras, y haz de la invitación a contribuir el contenido principal de la página.
Evita
«Próximamente», «Aún sin datos» sin explicación, y una entrada de navegación que lleva a una columna en blanco. Cada una le cuesta un clic al lector y no devuelve nada, y después de dos de ellas dejan de confiar en la navegación — un costo que paga cada otra página del producto.
Evita también la versión que parece estar bien: una página de categoría que se renderiza correctamente con cero elementos. No se ve rota, así que nadie la reporta, y silenciosamente dice que el proyecto abandonó ese tema.
Comprueba
Carga la superficie con una fuente de datos vacía y lee qué vería un usuario por primera vez. Si la respuesta es un encabezado y espacio en blanco, no debería haberse lanzado.
Para rutas generadas la verificación es mecánica: verifica que la lista de rutas se derive del contenido, de modo que una categoría sin entradas no produzca ninguna página en absoluto.
Riesgo
Ocultar un destino hasta que tenga contenido hace que la navegación cambie a medida que llegan datos, lo cual puede ser desorientador — un menú que crece entre visitas necesita una razón que el usuario pueda inferir.
Esto también se puede llevar demasiado lejos, hacia ocultar funcionalidades que simplemente son poco usadas. La línea está en si la superficie alguna vez puede mostrar algo: lo no construido se oculta, lo no usado se muestra con un buen estado vacío.
Cómo usarla
La tarjeta es un dato. Clona el repositorio e impórtala por ruta: lo que llega por la red se trata como contaminado y queda retenido a la espera de aprobación, que es el comportamiento deseable y la razón por la que aquí no hay un instalador de una línea.
git clone https://github.com/brcampidelli/chimera-agent.gitchimera skills-import chimera-agent/skills/do-not-ship-an-empty-surface/SKILL.mdIntegridad
SHA-256 del archivo tal como se publicó. Quien lo importe puede comprobar que lo que recibió es lo que mostró esta página.
c4dbc6291edf3d41c3820bea6ed19cd283dd90e75d41d61dad97bdab972b7965