Nivel 1 de 7 · Context engineering · 9:14 en el video
Entender
En el video · capítulos de esta sección
- 9:14NIVEL 1 · Entender un repositorio que no conoces
- 12:47/model: qué modelo usar para cada tarea
- 15:01El mapa del sistema, no del código
- 18:08/context: la ventana de contexto
- 20:48/compact, /clear y /resume: higiene de contexto
- 23:29/usage y /effort: cuánto cuesta y cuánto piensa
- 26:41Los cinco hallazgos del curso
Objetivo: que el agente entienda un sistema que nunca vio, y que tú sepas cuánto contexto está usando y cuánto cuesta.
Dolor: entras a una empresa nueva, te dan el repo, y el README tiene tres líneas. La persona que sabía cómo funcionaba todo ya no trabaja ahí.
Regla de método: a un repositorio que no conoces no le escribes las reglas: se las sacas. Nada de /init todavía. El CLAUDE.md se escribe en el Nivel 3, con lo que el sistema te haga aprender a los golpes.
Paso a paso
- Con la sesión abierta y Sonnet elegido, pide el mapa. No un mapa del código: un mapa del sistema.
Estás en un repositorio que no conozco. Dame un mapa del sistema completo:aplicación, worker, datos, infraestructura, pipeline de entrega,configuración por ambiente y observabilidad. Sigue POST /incidents desdeque entra hasta que queda persistido, y explícame cómo ese código seconvierte en un proceso ejecutándose en un ambiente. No modifiques nada.Resultado esperado: un informe largo (unos 2 minutos) que describe aplicación, datos, infraestructura, pipeline, configuración por ambiente y observabilidad, y sigue un incidente desde la API hasta la base. Sin que se lo pidas, marca problemas: el deduplicador se duplica bajo ráfaga, el health dice vivo pero no sano, el worker no está desplegado en la nube, y un import de compliance bloquea el arreglo obvio del primer bug.
- Completa el mapa con cuatro preguntas. Fíjate en el formato pedido: una frase por respuesta. Controlar cuánto te responde el agente también es parte del oficio.
Cuatro preguntas más. Responde cada una en UNA sola frase: solo elveredicto, sin explicación ni código.1. ¿Qué partes del despliegue dependen de conocimiento tribal o de pasos manuales?2. ¿Cómo sé exactamente qué versión está corriendo?3. ¿Qué señal probaría que el worker está sano, y no solamente vivo?4. ¿Cómo volveríamos a la versión anterior?Resultado esperado (los temas son estables, el texto varía): todo depende de Marcos a mano · la versión se sabe por /version · no existe señal real de salud del worker · no hay rollback definido.
-
Mira la mesa de trabajo. Tipea
/contextjusto después del mapa, antes de cualquier otra cosa: ahí la conversación (“Messages”) se ve gorda. Lo de fábrica (system prompt y tools) siempre está; las skills casi no pesan; los MCP ocupan cero hasta que se usan; hay una reserva para autocompactar. -
Limpia la mesa:
/compact. El agente resume la conversación y relee solo los archivos clave. Vuelve a/context: Messages baja a la mitad, lo de fábrica queda igual. Compactar es para seguir con el mismo trabajo con la mesa más liviana; los detalles finos se pierden. -
Mesa nueva:
/clearcuando cambias de tarea. No es botar trabajo:/resumelista las sesiones guardadas, con nombre, rama y peso. -
Mira lo que costó:
/usage. Fíjate en dos cosas: cero líneas de código tocadas (le pediste no modificar nada) y el número de “cache read”: lo que ya leyó no lo vuelve a pagar completo. -
Las dos palancas de costo: el modelo (
/model) y el esfuerzo (/effort, un slider de más rápido a más inteligente). Regla de partida: exploración barata, decisiones caras.
Comandos desbloqueados
/context· la ventana de contexto, la mesa de trabajo del agente./compact· resume la conversación y libera mesa./clear· mesa nueva./resume· vuelve a una sesión guardada./usage· costo de la sesión y barras de sesión y semana./model· elegir el modelo por tarea./effort· cuánto piensa el modelo por tarea.- advisor (mención) · consultar a un modelo más fuerte solo para una decisión. Se ve en el Nivel 7.
El backlog de 5 hallazgos
Es el resultado del nivel y el hilo del resto del curso. Cada uno explota o se resuelve antes del final.
- El deduplicador parece vulnerable a concurrencia. (Nivel 2)
- La entrega y la operación de infraestructura son manuales y no tienen contrato. (Nivel 4 y Capstone)
- Hay lógica duplicada entre los adaptadores cloud. (Nivel 5)
- El worker tiene observabilidad insuficiente: está arriba, no sabemos si está sano. (Capstone C2)
- No existen criterios de qué podría automatizar un agente en este repo. (Nivel 6)
Dos precisiones: después del mapa el agente no “domina” el sistema. Te entrega una hipótesis inicial de calidad; la comprensión la construyes tú usando el mapa. Y un mapa que termina en el controlador HTTP está incompleto: el sistema sigue en el build, en la identidad con la que corre, en el runtime, en los logs y en el rollback.
Cumples el nivel cuando
0/4Reto 1
Toma el repositorio más feo de tu trabajo y córrele el prompt del mapa. Compara lo que te devuelve con lo que tú creías de tu sistema.
Marcador: autonomía sube (lee solo) · control sube (sabes qué lee y cuánto cuesta).