# Cómo empaquetar una herramienta para entregar

> ¿Cómo hago que una herramienta funcione sin que yo esté al lado?

Pasale tres empaques: que se explique sola (título, para quién, cada campo con su ejemplo), que maneje sus estados (vacío, cargando, sin resultados) y que falle con mensajes amables, no errores técnicos. La prueba real: mandásela a alguien que no sabe nada del proyecto y mirá dónde se traba.

> Fuente: https://magoallegri.com/biblioteca/como-empaquetar-una-herramienta-para-entregar

---

Una herramienta puede funcionar **con vos al lado** y fallar sin vos. Vos sabés qué poner en cada campo, qué significa cada número, qué hacer si algo no carga. La persona que la abra mañana no sabe nada de eso. Empaquetar es la diferencia entre "me anda" y "se entrega".

## Los tres empaques

[Figura: Los tres empaques de una herramienta entregable: se explica sola, estados claros y errores amables]

Elegí tu mejor herramienta y pasale los tres, de a uno.

**1. La herramienta se explica sola.** Un título que dice qué hace, una línea de para quién, y cada campo con su etiqueta clara y un ejemplo adentro. Si hace falta un manual, el diseño falló.

```
Hacé que la herramienta se explique sola: título claro de qué hace,
una línea de para quién es, y cada campo con etiqueta inequívoca y un
ejemplo de valor adentro (placeholder). Una persona que la ve por
primera vez tiene que poder usarla sin que nadie le explique nada.
```

**2. Estados vacíos y de espera.** ¿Qué se ve antes de cargar datos? ¿Mientras carga? Una herramienta profesional nunca muestra un agujero blanco: muestra qué hacer.

```
Revisá los estados de la herramienta: ¿qué ve el usuario antes de
ingresar nada? ¿mientras los datos cargan? ¿si no hay resultados?
Cada estado tiene que decirle qué pasa o qué hacer, nunca quedar
en blanco o congelado sin explicación.
```

**3. Errores amables.** Todo lo que pueda fallar, falla con un mensaje humano que dice cómo seguir.

```
Buscá todo lo que pueda fallar (datos que no cargan, campos vacíos,
valores inválidos, sin internet) y poné en cada caso un mensaje amable
en español que diga qué pasó y qué hacer. Prohibido mostrar errores
técnicos crudos al usuario.
```

## La prueba de fuego: el usuario en frío

Mandale el link a alguien que **no sabe nada** del proyecto, con este mensaje y ni una palabra más:

> *"¿Me probás esto y me decís si se entiende? No te explico nada a propósito."*

Después mirá (o preguntá): ¿dónde se trabó? ¿qué preguntó? Cada pregunta que te haga es un cartel que le falta a la herramienta. Volvé a Claude con esa lista — es la iteración más valiosa, porque viene del mundo real.

## Por qué esto es lo que se cobra

La diferencia entre cobrar una vez y que te recomienden es exactamente esto: que la herramienta viva sola, sin vos de soporte técnico eterno. Empaquetar es la mitad invisible del producto, y la mayoría de la competencia ni sabe que existe.