Especificación y recorrido del usuario

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

convertir una necesidad en una especificación que cabe en una página;
describir el recorrido de la persona que usará la herramienta;
fijar una versión mínima y criterios comprobables;
decidir los datos de la herramienta y quedarte solo con lo necesario.

Por qué te interesa

Un agente puede construir una herramienta en pocos minutos. Pero si no sabes exactamente lo que quieres, lo decidirá por ti: las pantallas, los datos, lo que se envía y adónde. La especificación es tu encargo. Cabe en una página, se discute antes de construir y te servirá para comprobar el resultado. Es el mismo principio que la ficha del proyecto del módulo 6, aplicado a una herramienta.

Antes de empezar


Necesitas	Claude Code (app o terminal), en modo Manual, una carpeta de proyecto vacía (por ejemplo en `mon-espace-ia/projets`) y la plantilla de especificación (recurso)
Costo	La suscripción del agente: como mínimo Claude Pro, 18 € al mes sin IVA con facturación mensual, o 15 € al mes sin IVA con la suscripción anual de 180 € pagada por adelantado; precios mostrados en claude.com/pricing a fecha de 24/10/2026
Duración	60 minutos
Recordatorio	La especificación describe los datos de la herramienta: nada más que lo necesario

Entenderlo en 3 minutos

Las partes de una especificación (plantilla en el recurso):

Parte	La pregunta
El problema	¿Qué es lo que no funciona hoy?
Quién la usa	¿Quién, en qué dispositivo, en qué momento?
El recorrido	¿Qué hace la persona, paso a paso?
La versión mínima	¿Cuál es la herramienta más pequeña que ya resuelve el problema?
Fuera del alcance por ahora	¿Qué no se hace en esta versión?
Funcionó si	¿Qué criterios, comprobables con un sí o un no?
Los datos	¿Cuáles, dónde se quedan, qué no se guarda?

El recorrido se cuenta desde el punto de vista de la persona: «Abro el archivo, veo los libros que todavía no se han devuelto, escribo el título y el nombre…». No «la aplicación muestra una tabla».

Los datos. La CNIL (autoridad francesa de protección de datos) aconseja, antes de cualquier recogida, pensar en los tipos de datos necesarios y limitar la recogida a lo estrictamente necesario. Para un registro de préstamos, bastan un nombre de pila y un título: ni dirección ni teléfono.

Restricciones sencillas para empezar: un solo archivo, que se abre en el navegador, sin cuenta, sin servidor, sin instalar nada y sin cargar nada desde Internet. Todo se queda en tu computadora.

Hagámoslo juntos

1Paso 1: La necesidad, en dos frases

El ejemplo del módulo: el club de lectura quiere saber quién se llevó prestado qué libro de su «caja de libros» y qué libros todavía no se han devuelto. Escribe tu propia necesidad en dos frases, o quédate con esta para practicar.

2Paso 2: Hacer que te propongan la especificación

Abre Claude Code en tu carpeta de proyecto, en modo Manual, y usa la solicitud del recurso.

En nuestra prueba del 24/10/2026, con la necesidad del club y las siete partes de la tabla anterior (la plantilla del recurso agrega dos apartados, RESTRICCIONES y POR DECIDIR), la especificación siguió esas siete partes, con criterios comprobables («Anoto un préstamo (título + nombre) en menos de 30 segundos»), marcó con «[por decidir]» lo que había que resolver (quién lleva el registro, al cabo de cuántos días un libro está atrasado) y advirtió por sí sola de que los datos quedarían ligados a este navegador, en esta computadora, por lo que había que prever una copia de seguridad. Terminó con tres preguntas.

3Paso 3: Decidir

Responde a las preguntas y sustituye cada [por decidir] por tu decisión. Luego relee con la lista del recurso:

¿cada criterio se comprueba con un sí o un no?
¿los datos se reducen a lo necesario?
¿la versión mínima cabe en una frase?

4Paso 4: Guardar la especificación

Guarda specification.md en la carpeta del proyecto: es la referencia de las lecciones siguientes. Anota la fecha arriba.

Ahora te toca a ti

Elige un problema pequeño y real: un seguimiento, una lista, un cálculo que se repite, una página de información.
Haz que te propongan la especificación, con tus restricciones.
Decide cada punto y relee con la lista del recurso.
Guarda la especificación en la carpeta del proyecto, con fecha.

Recursos para descargar

Plantilla de especificación de una pequeña herramienta: las partes, la solicitud para tu agente y la lista que hay que releer antes de construir.

Comprobar

Funcionó si:

tu especificación tiene sus partes, y ya no queda ningún [por decidir];
cada criterio se comprueba con un sí o un no;
los datos se reducen a lo necesario, y sabes dónde se quedan;
la versión mínima cabe en una frase.

Errores frecuentes:

empezar a construir «para ver», antes de la especificación;
una versión mínima que ya lo contiene todo;
criterios vagos («sencillo», «bonito»);
guardar datos «por si acaso».

Guardar y retomar

La especificación vive con el proyecto: cuando cambies de opinión, cámbiala primero a ella y luego la herramienta.
Anota tu decisión y su motivo en tu diario (módulo 5, lección 3).

Para ir más lejos

opcional

La guía RGPD para desarrolladores de la CNIL: cnil.fr, «Guide RGPD du développeur» (en francés).

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
Especificación	La página que dice lo que debe hacer la herramienta y cómo sabremos que funcionó
Recorrido del usuario	Los pasos, vistos por la persona que usa la herramienta
Versión mínima	La herramienta más pequeña que ya resuelve el problema
Minimización de datos	Recoger solo los datos realmente necesarios