Hoy escribes el archivo más importante del proyecto, y lo escribes tú. Antes de pedirle nada a un agente hay que contarle qué estás construyendo, y eso es PROYECTO.md. En el sendero anterior viste que cada decisión que no tomas la toma el agente por ti. Este archivo es donde tomas las que importan, una sola vez, para no repetirlas en cada orden.
Cinco preguntas
Un buen PROYECTO.md responde cinco preguntas, en este orden: qué es, en dos frases; para quién, quién lo va a usar y desde dónde; qué tiene que tener, la lista corta; qué NO es, lo que no quieres ver aparecer; y cómo se ve terminado, para saber cuándo parar. Cabe en una pantalla. Si necesitas más espacio, lo más probable es que sean dos proyectos.
El de la barbería
El del proyecto que nos acompaña en los próximos senderos, la página de la barbería de la esquina. Carpeta nueva, el archivo en tu editor, y una lectura desde la terminal:
- Click derecho → Nueva carpeta → escribir el nombre
- Doble click para abrir la carpeta
- Abrir el editor → escribir → Guardar como… → elegir la carpeta
$ mkdir barberia$ cd barberia$ code PROYECTO.md# escribe el archivo en el editor, guarda y vuelve a la terminal$ cat PROYECTO.md# Barbería Don Julio — la página## Qué esLa página web de la Barbería Don Julio, la de la esquina de mi barrio. Una sola página, sencilla, para que la gente sepa qué hacemos, cuánto cuesta y cómo reservar.## Para quiénClientes del barrio que nos buscan desde el celular. La mayoría llega por recomendación y quiere ver precios y horario antes de venir.## Qué tiene que tener- Nombre, una foto de la barbería y una frase corta.- Servicios con precio: corte, barba, corte + barba, niños.- Horario de atención y dirección.- Un botón que abra WhatsApp para reservar.## Qué NO es- No es una tienda: no se vende nada en línea.- No tiene sistema de reservas, ni cuentas de usuario, ni blog.- No necesita más de un archivo.## Cómo se ve terminadaUn solo archivo index.html que se abre con doble clic y se ve bien en el teléfono. Con los datos reales de la barbería y el botón de WhatsApp funcionando.Qué NO es vale más que qué es
Cámbialo por lo tuyo: la peluquería de tu hermana, la carta del restaurante, el portafolio de tus fotos. Lo único que importa es que sea un proyecto real, uno que quieras ver terminado. Y cuando lo escribas, cuida sobre todo una sección.
Vuelve a leer la sección «Qué NO es». Sin ella, un agente entusiasta te entrega un sistema de reservas con calendario, cuentas de usuario y una base de datos, porque «una barbería necesita reservas». Tres líneas de no te ahorran tres horas de deshacer. Y la última sección, «cómo se ve terminada», es tu criterio para decir basta: un archivo, doble clic, se ve bien en el teléfono. Cuando eso se cumpla, el proyecto está listo, aunque al agente se le ocurran diez mejoras más.
Todo lo que no escribas aquí, el agente lo va a decidir por ti. En la próxima parada le entregas este archivo a Claude y le pides que se organice él solo.
