Del chat al agente|INEMA.CLUB-PRO

Clase 2 · 12 min

Nivel 1: del chat a la terminal (OSWork)

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.

Comenzar la lección

En esta lección vas a

  1. 1Recorrer las carpetas desde la terminal
  2. 2Escribir el manual del agente (AGENTS.md)
  3. 3Deshacer cualquier cambio con Git
  4. 4Mantener las claves fuera del texto

Objetivo: preparar la carpeta de trabajo del agente con reglas, una red de seguridad y secretos fuera del texto.

01Cómo se conectan las piezas

Tú das la tarea, el agente trabaja dentro de la carpeta y tú revisas.

Desplázate por la página: cada etapa de abajo ilumina su parte del diagrama.

  1. 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. 2/5

    Terminal

    Es por donde llegas a la carpeta y llamas al agente. En Windows, cmd; en Mac y Linux, la Terminal.

  3. 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. 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/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.

02El 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í.

03Los 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
  1. Llegas a la carpeta solo desde la terminal y sabes decir en qué carpeta estás.
  2. El AGENTS.md tiene al menos tres reglas escritas por ti.
  3. La página se abre en el navegador y pediste al menos una corrección.
  4. git status no muestra el .env.

04Prá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.

Ejercicios completos, con el desafío extra (repetir con el otro agente): jornada-agentes/exercicios/01-oswork.md.

05La secuencia 1 en video

Seis comandos, un AGENTS.md y la primera tarea.

Del chat a la terminal · 1 min 52 sPágina del video con guion →

06Pon a prueba lo que aprendiste

La explicación aparece después de tu respuesta.

Pregunta 1 de 3

¿Dónde va la clave de una API en el proyecto?competencia

Para profundizar en el nivel 1

Clase anteriorSiguiente clase