Módulo 01

El concepto: contexto antes que prompts.

La diferencia entre un agente que hace trabajo mediocre y uno que parece parte del equipo es exactamente una cosa: cuánto sabe sobre el proyecto antes de que empieces a pedirle cosas.

Las tres capas de información

Todo el contexto que el agente necesita se divide en tres capas. Solo la tercera cambia en cada sesión.

1. Quién eres / qué es el proyecto

Identidad, objetivos, audiencia. Sin esto, el agente trabaja en genérico, como si nunca hubiera oído hablar del proyecto.

"Somos un equipo de 5 diseñando una plataforma B2B para pymes."

2. Cómo trabajas

Metodología, design system, convenciones de nomenclatura, tono de voz, stack de herramientas. Lo que no sabe, lo inventa.

"Usamos tokens en kebab-case. No usamos librerías de iconos externas."

3. Qué necesitas ahora

La tarea concreta de cada sesión. Esta es la única capa que cambia. Las otras dos se definen una vez y persisten.

"Audita estos 3 componentes contra el design system."

Antes y después de tener contexto

La diferencia entre repetir el briefing en cada sesión y dar instrucciones concretas desde el primer día.

Sin contexto — cada sesión

Antes

tú

Necesito un componente de card para productos. Usamos Next.js, los estilos van en Tailwind, seguimos naming en PascalCase, los colores están en el design system que exportamos con Style Dictionary, el tono es sobrio y directo, no uses iconos externos...

agente

Claro, aquí va un componente genérico que probablemente no encaje del todo con tu sistema...

Con contexto — desde el primer día

Después

tú

Crea un componente ProductCard para el listado de resultados.

agente

Lo creo siguiendo las convenciones del sistema: PascalCase, tokens de Style Dictionary, sin iconos externos. ¿Lo quieres con variante compacta?

El salto más grande

Dejas de describir el proyecto en cada conversación. Tus prompts se convierten en instrucciones concretas, no en briefings repetitivos.

Esto no es magia de prompts

Cuatro cosas que este framework NO es.

No se trata de escribir prompts perfectos

Un buen contexto compensa prompts imprecisos. Un prompt brillante no compensa la ausencia de contexto del proyecto.

No es un chatbot que hay que entrenar

Claude no aprende entre sesiones. El contexto hay que dárselo explícitamente en archivos que el agente puede leer.

No necesitas saber programar

Los archivos de contexto son documentos de texto. Markdown. Lo mismo que usarías para tomar notas en Notion.

No es un proceso de una sola vez

El contexto se mantiene vivo. Se actualiza sprint a sprint, decisión a decisión. Es parte del trabajo del equipo.