1

Nivel 1 de 7 · Context engineering · 9:14 en el video

Entender

En el video · capítulos de esta sección

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

  1. Con la sesión abierta y Sonnet elegido, pide el mapa. No un mapa del código: un mapa del sistema.
Prompt · pégalo en Claude Code
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 desde
que entra hasta que queda persistido, y explícame cómo ese código se
convierte 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.

  1. 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.
Prompt · pégalo en Claude Code
Cuatro preguntas más. Responde cada una en UNA sola frase: solo el
veredicto, 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.

  1. Mira la mesa de trabajo. Tipea /context justo 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.

  2. 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.

  3. Mesa nueva: /clear cuando cambias de tarea. No es botar trabajo: /resume lista las sesiones guardadas, con nombre, rama y peso.

  4. 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.

  5. 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

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.

  1. El deduplicador parece vulnerable a concurrencia. (Nivel 2)
  2. La entrega y la operación de infraestructura son manuales y no tienen contrato. (Nivel 4 y Capstone)
  3. Hay lógica duplicada entre los adaptadores cloud. (Nivel 5)
  4. El worker tiene observabilidad insuficiente: está arriba, no sabemos si está sano. (Capstone C2)
  5. 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/4

Reto 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).

Comunidad

Los retos, las plantillas y el plugin están en Agentic Engineers

Los retos de cada nivel guiados, las plantillas de CLAUDE.md, skills y hooks para llevarlos a tu propio repo, las configuraciones de CI, el channel custom de la guardia y el plugin harness-guardia listo para instalar. La opción gratis alcanza para seguir el curso entero.

Únete a Agentic Engineers →

Canal YouTube

@NicolasNeiraGarcia

Claude Code · Agentes · Automatización · Infraestructura

Suscribirse ›