Clase 3 · 16 min
Cuando todo está en una sola carpeta, la IA lee material que no tiene nada que ver con el pedido y tú no sabes de dónde salió cada frase. Una carpeta por tema, con un archivo para las personas y otro para el agente, resuelve eso antes del primer pedido.
Empezar la lección
Objetivo: armar el árbol proyectos/config y la carpeta del proyecto con entradas, salidas, README.md y AGENTS.md en Markdown.
Cada cajón guarda un tema. Haz clic en cada parte.
Desplázate por la página: cada etapa ilumina su parte del diagrama.
Reúne trabajos independientes. Cada carpeta que contiene es un contexto: el material de un solo tema. Cuando abres el agente en una carpeta, trabaja desde ahí.
Está dentro de projetos, pero fuera de cada proyecto. Guarda lo que siempre se aplica, como «prefiero informes cortos, con los pendientes al final». Lo escribes una vez y lo usas en todos.
Entradas es lo que lee la IA; salidas es lo que produce para que lo revises. Separadas, puedes comparar una con otra. No mezcles aquí material de otro cliente o de otro grupo.
El agente busca el AGENTS.md por su cuenta al empezar. El resto lo lee cuando se lo indicas: la IA no abre cada archivo de la carpeta por su cuenta.
Una carpeta por tema hace que la IA lea menos cosas y te permite saber de dónde salió cada frase. Dibuja el árbol en papel antes de crearlo: elige los nombres con calma.
Nombres cortos, sin espacios ni acentos: meu-primeiro-agente, entradas, saidas.
Texto organizado con tres marcas.
El # al inicio de la línea crea un título, ## crea un subtítulo y el guion crea un elemento de lista. El archivo termina en .md y se abre en cualquier editor de texto.
Sigue siendo texto: quien lo lee entiende la estructura incluso sin formato.
# Feria de ciencias ## Materiales - algodón y un vaso
Dice para qué sirve el proyecto y cómo revisar el resultado. Tiene cinco secciones: Propósito, Lee primero, Organización, Cómo verificar y Estado actual.
¿Aún no sabes qué poner en un campo? Escribe "por definir". Es mejor dejar un campo abierto con honestidad que usar un texto de plantilla que nadie revisó.
Todos los grupos inscritos aparecen en la lista final.
Le dice al agente quién eres, cuáles son las reglas del proyecto y qué hay en la carpeta. Claude Code y Codex leen el mismo archivo, así que las reglas sirven para ambos.
Empieza con tres reglas tuyas. En la clase 7, el manual crecerá e incluirá reglas que se pueden comprobar.
Antes de terminar, di qué cambió y cómo puedo comprobarlo.
notepad README.md abre el archivo en el Bloc de notas; Ctrl+S lo guarda. type README.md muestra en cmd lo que quedó guardado.
Si en cmd los acentos aparecen cambiados, como ç en lugar de ç, solo es la pantalla; el archivo está bien.
nano README.md para editar, cat README.md para ver.
Crea las carpetas desde cmd y pega las plantillas en el Bloc de notas. Reemplaza lo que esté entre < >.
cd %USERPROFILE%\projetos mkdir config cd meu-primeiro-agente mkdir entradas mkdir saidas dir /b
# Mi primer agente ## Propósito <qué produce este proyecto, en una frase> ## Lee primero 1. AGENTS.md 2. ../config/decisoes.md 3. ../config/memoria.md ## Organización - entradas: lo que lee la IA - saidas: lo que produce para que yo lo revise ## Cómo verificar <cómo puede alguien comprobar que el resultado es correcto> ## Estado actual Por definir.
# Quién soy <tu nombre, tu profesión, para quién trabajas> # Reglas de este proyecto - Escribe en español, con frases cortas. - Trabaja solo dentro de esta carpeta. No borres archivos sin preguntar. - Antes de terminar, di qué cambió y cómo puedo comprobarlo. # Qué hay aquí - entradas/: material que puedes leer - saidas/: donde entregas los borradores
notepad README.md notepad AGENTS.md type AGENTS.md
C:\Users\ana\projetos ├─ config └─ meu-primeiro-agente ├─ AGENTS.md ├─ README.md ├─ entradas └─ saidas
El Bloc de notas pregunta si quieres crear el archivo nuevo: responde Sí. Guárdalo con Ctrl+S y ciérralo.
notepad AGENTS.md en cmd.Crea las carpetas y revisa, como en tu computadora.
Misiones
config aquí en projetos.meu-primeiro-agente.entradas.saidas (sin tilde).Simulación: Ana es un ejemplo. En cmd, las mayúsculas y minúsculas del nombre del archivo se consideran iguales.
En la carpeta creada en la clase 1.
Dibuja el árbol en papel, crea config, entradas y saidas con cmd y escribe el README con las cinco secciones.
Listo cuando: dir /b muestra entradas, saidas y README.md, y cada sección del README tiene información real o "por definir".
Crea el AGENTS.md con quién eres, las reglas del proyecto y lo que hay en la carpeta.
Listo cuando: type AGENTS.md muestra al menos tres reglas tuyas, escritas por ti.
La explicación aparece después de tu respuesta.
Pregunta 1 de 3
Quieres guardar "prefiero informes cortos, con los pendientes al final". ¿Dónde guardas esa nota?
Pregunta 2 de 3
¿Cuál es la diferencia entre README.md y AGENTS.md?competencia
Pregunta 3 de 3
Pediste un resumen de la feria de ciencias y apareció una nota de calificaciones en medio. ¿Cuál es la causa probable?
Elige una alternativa. La explicación aparece después de tu intento.