Clase 05 · Módulo 03
El brief que le entregas a Claude
El brief que le entregas a Claude
Qué logras en esta clase
Sales con el brief de tu web: un solo documento que reúne lo decidido en este módulo.
- Sabes qué secciones lleva y por qué.
- Lo guardas donde Claude Code lo puede leer.
- Lo pones a prueba antes de construir.
02
Qué es un brief
El brief es el documento donde queda escrito todo lo que ya decidiste, para que Claude no tenga que adivinarlo.
03
Por qué en un archivo y no en el chat
Lo que dices solo en la conversación puede perderse: cuando una sesión larga se compacta para liberar contexto, los detalles se resumen. Un archivo del proyecto se puede volver a leer completo cuantas veces haga falta.
Además, el archivo queda bajo Git, como viste en el módulo 2. Puedes ver cómo cambió y volver a una versión anterior.
04
Las secciones y para qué sirve cada una
| Sección | Viene de | Evita que Claude |
|---|---|---|
| Objetivo y acción principal | Clase 1 | Reparta la atención en todo |
| Público | Clase 1 | Escriba para nadie en particular |
| Mapa y secciones por página | Clase 2 | Invente páginas o cambie el orden |
| Textos | Clase 3 | Rellene con frases y datos falsos |
| Recursos visuales | Clase 4 | Use imágenes de ejemplo |
| Fuera de alcance | Tu decisión | Construya de más |
05
Lo que el brief no es
| Brief | CLAUDE.md | |
|---|---|---|
| Qué contiene | Qué web quieres y para quién | Cómo se trabaja en el proyecto |
| Ejemplo | «La acción principal es reservar hora» | Comandos, carpetas, convenciones |
| Cuándo se lee | Al planificar y construir contenido | Al inicio de cada sesión |
El CLAUDE.md se vio en el módulo 2. El sistema visual tiene su propio documento y se arma en el módulo 4.
06
Dónde vive
Guárdalo como archivo Markdown dentro de la carpeta del proyecto, por ejemplo docs/brief.md. Markdown es texto simple con títulos y listas, y Claude lo lee sin problemas.
Los textos largos de cada página pueden ir en archivos aparte, y las imágenes en su carpeta. El brief dice dónde está cada cosa.
07
Cómo se usa el brief
En modo plan, Claude lee y propone sin editar archivos hasta que apruebas. Se activa con /plan o con Shift+Tab en la terminal.
08
Cuánto detalle es suficiente
| Insuficiente | Suficiente |
|---|---|
| Público: clientes del sector | Dueños de auto de la comuna que buscan hora rápida y temen el sobreprecio |
| Página de servicios | Servicios: lista de cuatro, cada uno con qué incluye y precio desde |
| Fotos del local | fachada.jpg en portada; equipo.jpg en Nosotros |
La medida: alguien que no conoce tu negocio debería poder construir la web sin llamarte.
09
Corto y completo
Para una web chica, el brief ocupa de una a tres páginas. Si crece mucho más, saca los textos largos a archivos por página y deja en el brief solo la referencia.
10
Lo que falta, se rellena
Lo que no esté en el brief, Claude lo completa con lo más común. Y lo más común rara vez es tu negocio.
11
Marca lo que todavía no sabes
Un brief honesto tiene vacíos. Lo importante es que estén a la vista:
- Escribe «PENDIENTE» donde falte un dato: un precio, una foto, un horario.
- Indica que lo pendiente se deja señalado en la página y no se inventa.
- Revisa esa lista antes de publicar.
12
Separa hechos de preferencias
En el brief conviven dos tipos de contenido, y conviene distinguirlos:
- Hechos: precios, horarios, dirección, qué incluye cada servicio. No se cambian ni se adornan.
- Preferencias: tono, orden sugerido, estilo de las fotos. Claude puede proponer alternativas.
Si no los separas, Claude puede tratar un precio como una sugerencia o una idea suelta como una regla fija.
13
Ponlo a prueba antes de construir
- Abre Claude Code en modo plan.
- Pídele que lea el brief y liste dudas, contradicciones y datos que faltan, sin proponer código.
- Responde cada punto en el archivo, no en el chat.
- Repite hasta que no queden dudas importantes.
Diez minutos de esta revisión ahorran varias rondas de corrección sobre páginas ya hechas.
14
Un pedido de revisión
La pregunta «qué tendrías que suponer» es la que más rinde: cada suposición es un vacío del brief que todavía puedes llenar tú.
15
El brief cambia, y está bien
Vas a cambiar de idea mientras construyes. El orden correcto es:
- Primero actualizas el brief.
- Después le pides el cambio a Claude, apuntando al brief.
- Guardas un commit que incluya ambos.
Así el documento y la web dicen siempre lo mismo, y una sesión nueva parte con la información correcta.
16
El brief de una línea
No hace falta un documento perfecto. Hace falta que las decisiones de las clases 1 a 4 estén escritas, aunque sea de forma simple.
17
El brief fuera del proyecto
Un solo archivo, dentro del proyecto y con historial en Git. Si lo escribiste en otro programa, pásalo a Markdown antes de empezar.
18
Revisión final del brief
- El objetivo tiene número, plazo y forma de contarlo.
- Cada página del mapa indica su acción principal y sus secciones.
- Los textos clave están escritos o marcados como pendientes.
- Cada imagen tiene archivo, ubicación y origen anotado.
- Hay una lista de lo que queda fuera de alcance.
19
Lo que te llevas
- El brief reúne objetivo, público, mapa, textos y recursos en un solo archivo.
- Vive dentro del proyecto, en Markdown y bajo Git.
- No reemplaza al
CLAUDE.mdni al sistema visual. - Lo pendiente se marca; no se deja para que se invente.
- Se prueba con Claude en modo plan antes de construir.
20
Hazlo ahora
En 15 minutos:
- Crea
docs/brief.mden la carpeta de tu proyecto. - Copia ahí lo que escribiste en las clases 1 a 4, ordenado por sección.
- Marca con «PENDIENTE» todo lo que falte.
- En modo plan, pídele a Claude que liste lo que tendría que suponer, y completa el archivo con tus respuestas.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026