E7 · La primera tarea
20 minHaz el pedido 1 (solo lectura) y el pedido 2. Abre la página con start index.html y pide un cambio.
Listo cuando: la página se abre en el navegador y pediste al menos una corrección al agente.
Clase 4 · 18 min
Primero el agente lee, después cambia
“Ordena el proyecto” mezcla diagnóstico y cambios: si algo sale mal, no sabes en qué parte ocurrió. Separar la lectura de los cambios, dar el mínimo permiso necesario y pedir un cierre que indique qué se verificó transforma al agente en alguien a quien puedes dirigir.
Empezar la lección
En esta lección vas a
- 1Pedir que lea sin editar y revisar los archivos que usó
- 2Autorizar un cambio pequeño y específico
- 3Escribir una autorización en cinco partes
- 4Exigir el cierre: hecho, verificado, pendiente
Objetivo: darle al agente una tarea con alcance definido, revisar lo que leyó y cambió, y pedir al menos una corrección.
01Inspección antes de la remodelación
El orden del primer trabajo, en cuatro etapas.
Desplázate por la página: cada etapa ilumina su parte del diagrama.
- 1/5
Inspeccionar
En esta etapa no cambia ningún archivo. Pídelo claramente: sin editar. Y pídele que diga qué archivos leyó, para que puedas compararlos con
dir /b. - 2/5
Planear
La lista de lo que falta es tu referencia. Si avisó que no abrió un archivo, el plan todavía no conoce ese contenido: dile en el siguiente pedido en qué debe basarse.
- 3/5
Cambiar
Tú dices qué archivo puede crear o cambiar. Si el agente pregunta antes de editar, verifica que sea solo ese archivo y aprueba. Si es otro, rechaza.
- 4/5
Validar
La última palabra es tuya. Abre el resultado y compáralo con lo que pediste. Pide al menos una corrección: asignar la tarea, revisar y decidir es gestionar.
- 5/5
Usar × gestionar
Quien usa pide y acepta. Quien gestiona separa la lectura de los cambios, autoriza con un alcance definido y revisa antes de aprobar. La diferencia está en el hábito, no en la herramienta.
Funciona igual en Claude Code y en Codex: ambos leen AGENTS.md y trabajan en la carpeta desde la que se abrieron.
02La autonomía es autorización con un alcance definido
Cinco partes que caben en una nota adhesiva.
1. Objetivo y archivos
Di qué hay que producir y qué puede leer. "Borrador del informe de septiembre, solo a partir de la hoja de cálculo de septiembre."
Una carpeta pequeña, solo con el material de la tarea, ya limita lo que puede alcanzar.
Ejemplo
Objetivo: index.html sobre mí. Archivos: solo AGENTS.md.
2. Acciones y detención
Di qué acciones autorizas y cuáles prohíbes: leer y crear, sí; borrar y cambiar nombres, no. Enviar, publicar y borrar son acciones externas: cada una requiere una instrucción explícita.
Que exista el botón no significa que tenga permiso. Di dónde debe detenerse y esperarte.
Detención
Entrega el borrador y detente antes de enviarlo.
3. Permiso mínimo
Leer archivos implica poco riesgo; escribir, un riesgo medio; ejecutar comandos, un riesgo alto. Empieza por el nivel más restringido que permita completar la tarea.
Una regla escrita orienta; lo que realmente lo impide son los permisos del programa. En Codex, /permissions muestra y cambia lo que puede hacer.
No hagas esto
Quitar todas las protecciones para solucionar un error.
4. Cierre
Pídele siempre que termine diciendo qué hizo, cómo lo verificó y qué quedó pendiente.
Así, el resultado se convierte en algo que puedes revisar y no en algo que tienes que creer.
Cierre
Hecho: index.html. Revisado: se abre en el navegador. Pendiente: foto.
03Los pedidos, en orden
Abre el agente dentro de la carpeta (claude o codex) y pega un pedido a la vez.
Pedido 1 · solo lectura
Lee AGENTS.md y README.md. Explica el propósito del proyecto y enumera lo que falta, sin editar nada. Al final, di qué archivos usaste.
Pedido 2 · cambio con nombre y límite
Lee el AGENTS.md. Crea solo el index.html con una página sencilla sobre mí, usando lo que aparece allí. No modifiques ni borres otros archivos. Al final, di: qué hiciste, cómo lo revisaste y qué quedó pendiente.
cmd · revisar el cambio
dir /b start index.html
Pedido 3 · la corrección
Cambia el título por "<tu título>" y agrega una sección de contacto. Solo en index.html.
Pedido 4 · el agente lee tus archivos
Lee los archivos .txt de la carpeta entradas y escribe saidas/resumo.md con 5 decisiones y 5 pendientes. Indica de qué archivo proviene cada una.
cmd · punto de retorno antes de Git (lección 6)
cd %USERPROFILE%\projetos xcopy /e /i meu-primeiro-agente meu-primeiro-agente-antes rem después del cambio, compara: fc /n meu-primeiro-agente-antes\*.md meu-primeiro-agente\*.md
Simulación: ejemplo ilustrativo
Pedido 1: "El propósito es crear una página sobre Ana. Falta: el index.html, el formato y cómo comprobarlo. Archivos leídos: AGENTS.md y README.md. También consulté el listado. No se editó nada."
Explicó, enumeró lo que falta y dijo qué leyó y qué no. Ningún archivo cambió.
- Los archivos que dice haber leído aparecen en
dir /b. - Después del pedido 2, solo apareció el index.html.
- La página se abre en el navegador y pediste una corrección.
- En resumo.md, encontraste en el original al menos dos de las frases citadas.
- "Mejora la página": genera un cambio que no sabes cómo comprobar. Pide un resultado que puedas ver.
- Aprobar sin leer: el agente pregunta antes de editar, justamente para que veas qué archivo cambia.
- Cita que no aparece en el original: anota en AGENTS.md la regla que faltó ("cita solo frases que aparezcan en el archivo").
04Práctica
Con el agente abierto dentro de meu-primeiro-agente.
E8 · El agente lee tus archivos
20 minPon tres textos tuyos en entradas (anotaciones, un acta, un correo largo) y haz el pedido 4. Comprueba dos citas en el archivo original.
Listo cuando: encontraste en el original al menos dos de las frases citadas. Si alguna no aparece, agrega la regla que faltó en AGENTS.md.
05Pon a prueba lo que aprendiste
La explicación aparece después de tu respuesta.
Pregunta 1 de 3
¿Cuál es el mejor primer pedido en una carpeta nueva?competencia
Correcto
Primero, una inspección: leer sin editar y decir qué usaste. Así tienes una referencia antes de cualquier cambio.No es esa
Primero, una inspección: leer sin editar y decir qué usaste. Así tienes una referencia antes de cualquier cambio.Repasar: Inspección antes de la remodelaciónPregunta 2 de 3
La autorización decía solo "organiza la carpeta de las pruebas", y el agente borró tres archivos que parecían copias. ¿Qué parte faltó?
Correcto
Sin decir qué puede y qué no puede hacer (leer y crear, sí; borrar, no), borrar quedó implícito.No es esa
Sin decir qué puede y qué no puede hacer (leer y crear, sí; borrar, no), borrar quedó implícito.Repasar: La autonomía es autorización con un alcance definidoPregunta 3 de 3
AGENTS.md dice "no envíes nada". ¿Eso impide técnicamente el envío?
Correcto
Una regla escrita orienta el comportamiento; los permisos limitan lo que se puede hacer. Ambas se complementan.No es esa
Una regla escrita orienta el comportamiento; los permisos limitan lo que se puede hacer. Ambas se complementan.Repasar: La autonomía es autorización con un alcance definidoPrueba completada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.Elige una alternativa. La explicación aparece después de tu intento.