1. El brief que se puede construir
Nivel: básico
Qué construir. El brief completo de la web de un negocio real (el tuyo o el de alguien que conozcas), más su sistema visual, guardados en el repositorio antes de crear una sola página.
Quedó bien si:
- El objetivo está en una frase con número, plazo y forma de contarlo.
- El visitante principal está descrito con los cinco datos, sacados de clientes reales y no de suposiciones.
- Cada página del mapa tiene su dirección, su acción principal y sus secciones en orden.
- Los textos clave de la portada están escritos; lo que falta está marcado como «PENDIENTE» y no inventado.
- Cada imagen tiene archivo, origen, licencia o permiso, y fecha de lectura anotados en un registro.
- El sistema visual lista roles de color, familias, escala de tamaños y espacios, con la razón de contraste medida de cada par de texto y fondo.
- Existe una sección «Fuera de alcance» con al menos tres cosas que no van en la primera versión.
- En modo plan, Claude Code lee el brief y no necesita suponer nada importante para construir la portada.
2. Un sitio que resiste la revisión
Nivel: básico
Qué construir. El sitio de ese brief con Astro y Tailwind, dirigido con Claude Code: layout común, al menos tres páginas, una página 404 propia y una colección de contenido con dos entradas reales.
Quedó bien si:
npm run buildtermina sin errores y el sitio se recorre completo connpm run preview.- El historial de Git muestra commits pequeños con mensajes que dicen qué cambió en el sitio, y ningún archivo de claves.
- El menú y el pie existen en un solo archivo, y el enlace de la página actual queda marcado.
- Una búsqueda de
[#y depx]en el proyecto no encuentra colores ni tamaños escritos a mano: todo sale de los tokens. - A 320 px de ancho no hay desplazamiento horizontal en ninguna página, y lo compruebas también en un celular real.
- Recorres el sitio entero solo con el teclado, con el foco siempre visible, y cada página tiene un único
h1. - Cada imagen informativa tiene un
altque la describe y ninguna foto del contenido vive enpublic. - Publicas una entrada nueva de la colección creando un solo archivo, sin tocar ningún componente.
- Puedes explicar con tus palabras qué hace cada carpeta de
src.
3. Un formulario que no pierde mensajes
Nivel: intermedio
Qué construir. Un formulario de contacto que valida en el servidor, frena bots, guarda cada mensaje en Supabase y te avisa por correo, con las claves fuera del código.
Quedó bien si:
- La tabla nació de una migración guardada en el repositorio y tiene RLS activado.
- Un script que usa solo la clave publicable no logra leer ni una fila de la tabla.
- Una llamada directa a la función de servidor con datos inválidos, o con el campo trampa lleno, no deja ninguna fila nueva.
- El formulario muestra sus cuatro estados (vacío, enviando, éxito y error) y los errores aparecen junto a cada campo, sin borrar lo escrito.
- Si el envío del correo falla, el mensaje queda guardado igual y el fallo queda en los registros.
- El aviso llega a tu bandeja y al apretar «Responder» la respuesta va dirigida a quien escribió.
- Ninguna clave secreta aparece al buscarla dentro de
distni en el historial de Git. - Junto al botón hay una frase que dice para qué se usan los datos y un enlace a la política de privacidad.
4. En tu dominio, con candado y correo
Nivel: intermedio
Qué construir. El sitio publicado en un dominio propio, con despliegue automático desde GitHub, vistas previas por rama y una dirección de correo del dominio funcionando.
Quedó bien si:
- Un
git pusha la rama principal actualiza el sitio sin subir ningún archivo a mano. - Un cambio hecho en una rama se revisa en su vista previa antes de llegar a producción, y la vista previa no usa claves de producción.
- El dominio está inscrito a nombre del dueño del negocio y su fecha de renovación está anotada con un recordatorio.
- Las cuatro variantes de la dirección (con y sin
www,httpyhttps) terminan en la misma, con candado. - Una dirección inventada muestra tu página 404 propia.
- El formulario del reto 3 funciona en producción: la fila aparece en la base y el aviso llega.
- Un mensaje enviado a
contacto@de tu dominio desde otra cuenta llega a una bandeja que alguien revisa. - Un correo salido de tu dominio muestra SPF, DKIM y DMARC aprobados al ver el original en Gmail, y el dominio tiene un solo registro SPF.
- Todas las cuentas involucradas tienen verificación en dos pasos.
5. Encontrable y rápida
Nivel: intermedio
Qué construir. La puesta a punto del sitio publicado para buscadores, asistentes de IA y celulares lentos, con las mediciones guardadas en el repositorio.
Quedó bien si:
- Cada página tiene título y descripción propios, dirección canónica con tu dominio definitivo y tarjeta correcta al compartir el enlace en un chat.
- El ícono de la pestaña es el tuyo, no el de la plantilla.
- El sitemap lista solo direcciones con tu dominio real,
robots.txtlo declara y no queda ningúnnoindexolvidado. - La propiedad está verificada en Search Console y el sitemap figura enviado sin errores.
- La prueba de resultados enriquecidos de Google detecta tus datos estructurados sin errores, y coinciden con lo que se ve en la página.
- Lighthouse en modo móvil, sobre la versión construida, marca LCP de 2,5 s o menos y CLS de 0,1 o menos en la portada y en la página con más imágenes.
- La imagen principal carga sin diferir y con prioridad; las demás, diferidas y con ancho y alto declarados.
- Las cinco preguntas más frecuentes de tus clientes están respondidas en texto, con el dato en la primera frase.
- Hay un archivo con los números antes y después de cada cambio, con fecha.
6. Un cobro que no se puede engañar
Nivel: avanzado
Qué construir. Un flujo de compra con Mercado Pago Checkout Pro para al menos dos productos: catálogo, pedido, pago y confirmación por webhook. Si tu negocio no vende en línea, hazlo con productos de prueba.
Quedó bien si:
- Puedes justificar por escrito por qué elegiste link de pago, compra directa o carrito para ese caso.
- El precio vive en un solo lugar y la función de cobro lo lee de ahí: un total manipulado desde el navegador no cambia lo que se cobra.
- El pedido se crea antes del pago, con un número propio que viaja como referencia externa.
- Abrir a mano la dirección de «pago aprobado» no marca ningún pedido como pagado.
- Un aviso con firma inválida se descarta, y la función consulta el pago a la API antes de cambiar el pedido.
- El mismo aviso recibido dos veces no duplica el descuento de stock ni el correo de confirmación.
- La tabla de pedidos no se puede leer con la clave publicable.
- Probaste un pago aprobado, uno rechazado y un abandono, y después una compra real pequeña que devolviste.
- Antes del botón de pago se ven el total con despacho, quién vende y las condiciones, cada una respaldada por el artículo de la norma vigente que leíste tú, con su fecha de lectura.
7. Medir, mantener y cumplir
Nivel: avanzado
Qué construir. La operación de la web ya publicada: medición, rutina de mantenimiento, revisión de seguridad y documentos legales que describen lo que el sitio hace de verdad.
Quedó bien si:
- La analítica cuenta tus visitas y, al revisar las cookies en una ventana privada, sabes exactamente cuáles deja tu sitio y de qué dominio.
- Tienes definida una conversión principal, su conteo de los últimos 30 días sacado de tu base y la tasa calculada con fecha.
- Hiciste una actualización de dependencias en una rama, la probaste en su vista previa y recién entonces la fusionaste.
- Existe un respaldo de tus datos fuera del repositorio, lo abriste y comprobaste que sirve.
- Un monitoreo te avisa si la portada o la función del formulario dejan de responder.
- La búsqueda de claves en el historial de Git no encuentra ninguna y la prueba con la clave publicable no lee ninguna tabla.
- El inventario de datos (qué recoges, para qué, dónde queda y hasta cuándo) coincide con lo que hacen tu formulario y tus tablas.
- La política de privacidad nombra a tus proveedores reales, está enlazada en el pie y junto al formulario, y lleva fecha de última actualización.
- Tienes anotado, con fecha de consulta, el estado de vigencia de la Ley 21.719 leído en la fuente oficial.
- Hay una rutina mensual escrita y agendada, con dueño.