La terminal es solo otra ventana. Con seis comandos recorres tus carpetas; con un AGENTS.md, el agente sabe quién eres y qué puede hacer; con Git puedes deshacer cualquier error.
Objetivo: preparar la carpeta de trabajo del agente con reglas, una red de seguridad y secretos fuera del texto.
01 · Cómo se conectan las piezas
Tú das la tarea, el agente trabaja dentro de la carpeta y tú revisas.
Clase 201 · Cómo se conectan las piezasTú das la tarea, el agente trabaja dentro de la carpeta y tú revisas.
¿No te gustó? git restore devuelve el archivo a la última versión guardada
1/5
Tú
Tú sigues tomando las decisiones: pides, revisas el resultado y lo aceptas o lo deshaces. Dar la tarea, revisar y decidir es gestión.
Desplázate por la página: cada etapa de abajo ilumina su parte del diagrama.
1/5
Tú
Tú sigues tomando las decisiones: pides, revisas el resultado y lo aceptas o lo deshaces. Dar la tarea, revisar y decidir es gestión.
2/5
Terminal
Es por donde llegas a la carpeta y llamas al agente. En Windows, cmd; en Mac y Linux, la Terminal.
3/5
Carpeta del proyecto
Todo lo que el agente necesita saber está aquí: las reglas en AGENTS.md, el trabajo en los archivos, las claves en .env (que Git ignora) y el historial en .git.
4/5
Agente
El agente lee el AGENTS.md antes de empezar, trabaja en los archivos de la carpeta y, si las reglas lo piden, dice qué cambió y cómo puedes revisarlo.
5/5
El ciclo completo
Tú pides, el agente trabaja dentro de la carpeta siguiendo el AGENTS.md y dice qué cambió. Tú revisas. Si te gustó, haces commit; si no, git restore.
Los mismos archivos sirven para Claude Code y Codex: ambos leen el AGENTS.md.
02 · El ciclo de trabajo con el agente
Haz clic en cada etapa.
1. Pedir
Dentro de la carpeta, llama a claude o codex y pide una sola cosa, con el resultado que esperas.
Empieza pidiéndole que lea el AGENTS.md: así seguirá tus reglas.
PedidoLee el AGENTS.md. Crea un index.html con una página sencilla sobre mí, usando lo que dice ahí.
2. Ejecutar
El agente crea y edita archivos en la carpeta. Puede pedir permiso antes de ejecutar comandos.
Tu papel aquí es leer lo que propone, no escribir por él.
Lo que apareceEl agente crea el index.html y explica lo que hizo.
3. Revisar
Abre el resultado (la página en el navegador, el resumen o el archivo) y compáralo con lo que pediste.
Pide al menos una corrección: ese hábito marca la diferencia entre usar y gestionar.
CorrecciónCambia el título por "Consultoría de RR. HH." y agrega una sección de contacto.
4. Guardar o deshacer
¿Te gustó? git add . y git commit -m "..." guardan la versión.
¿No te gustó? git restore index.html vuelve a lo que estaba guardado, sin pánico.
Regla de oroHaz un commit antes de pedir un cambio grande.
03 · Los archivos y comandos de la secuencia
Copia y usa. Cambia el texto entre los signos < > por el tuyo.
Terminal · primera carpeta
mkdir projetos
cd projetos
mkdir meu-primeiro-agente
cd meu-primeiro-agente
dir # Windows (en Mac y Linux: ls)
AGENTS.md
# Quién soy
<tu nombre, tu profesión, para quién trabajas>
# Reglas de este proyecto
- Escribe en portugués, con frases cortas.
- No borres archivos sin preguntar.
- Antes de terminar, dime qué cambió y cómo lo reviso.
- Nunca escribas claves ni contraseñas en un archivo de texto; van en .env.
# Qué hay aquí
- index.html: mi página
Terminal · Git y secretos fuera del texto
git init
echo .env> .gitignore
git add .
git commit -m "primeira versão"
# deshacer un cambio del agente:
git restore index.html
# .env NO debe aparecer aquí:
git status
Ejemplo del repositorio
Llegas a la carpeta solo desde la terminal y sabes decir en qué carpeta estás.
El AGENTS.md tiene al menos tres reglas escritas por ti.
La página se abre en el navegador y pediste al menos una corrección.
git status no muestra el .env.
Saltarse Git: el primer cambio malo del agente se convierte en trabajo manual extra.
Clave en AGENTS.md: todo lo que está en texto puede terminar en GitHub. Las claves van solo en .env.
Pedido vago: "mejora la página" genera un cambio que no sabes revisar. Pide un resultado que puedas ver.
04 · Práctica: los 6 ejercicios de la secuencia 1
Hazlos en orden. Pasa al siguiente solo cuando se cumpla «listo cuando».
E1 · Primera carpeta desde la terminal
10 min
Crea projetos/meu-primeiro-agente, entra y lista su contenido. Abre la misma carpeta en el Explorador (o Finder) y compara.
Listo cuando: llegas a la carpeta solo desde la terminal, sin el mouse, y sabes decir en qué carpeta estás.
E2 · El manual del empleado
15 min
Crea el AGENTS.md con quién eres, las reglas del proyecto y qué hay en la carpeta.
Listo cuando: el archivo existe y tiene al menos tres reglas tuyas, escritas por ti.
E3 · La primera tarea
15 min
Llama al agente y pídele que cree el index.html a partir del AGENTS.md. Ábrelo en el navegador y pide un cambio.
Listo cuando: la página se abre y le pediste al agente al menos una corrección.
E4 · La red de seguridad
20 min
Ejecuta git init, add y commit. Pide un cambio grande y, si no te gusta, vuelve atrás con git restore.
Listo cuando: deshiciste un cambio del agente con un comando, sin entrar en pánico.
E5 · El secreto no va en el texto
10 min
Crea un .env con una clave falsa y un .gitignore con la línea .env. Agrega la regla a AGENTS.md.
Listo cuando: git status no muestra el .env.
E6 · El agente lee tus archivos
20 min
Pon tres textos tuyos en la carpeta y pide un resumen.md con 5 decisiones y 5 pendientes, citando el origen de cada una.
Listo cuando: encontraste en el original al menos dos de las frases citadas.
El agente hizo un cambio grande que no aprobaste. ¿Qué hacer?
Correcto
Con un commit antes del cambio, git restore recupera el archivo con un comando. Por eso la regla: haz un commit antes de pedir un cambio grande.
No es esa
Con un commit antes del cambio, git restore recupera el archivo con un comando. Por eso la regla: haz un commit antes de pedir un cambio grande.Repasar: El ciclo de trabajo con el agente
Pregunta 3 de 3
¿Para qué sirve AGENTS.md?
Correcto
AGENTS.md es el manual del empleado. Claude Code y Codex leen el mismo archivo, así que las reglas valen para ambos.