Ruta única · 6 clases breves
En seis sesiones de 15 a 21 minutos, sabrás explicar las cuatro capas de un sistema de IA, por qué la terminal con agente es la que realmente hace el trabajo, cómo escribir las reglas para que trabaje a tu manera y dónde vive todo esto en las carpetas del proyecto.
Video de 2 minutos: las cuatro capas, del chat al harness, y dónde vive todo. Míralo antes de la clase 1 o después de la clase 2. Versión vertical para Shorts/Reels.
Clases
Termina sabiendo decir, con ejemplos de tu trabajo, en qué te ayuda el chatbot del navegador y en qué punto exacto se traba.
Termina sabiendo dibujar en una servilleta las capas de chat, editor, terminal y harness, y explicar por qué el terminal tiene manos.
Termina sabiendo reconocer, en una sesión real con un agente, qué leyó, qué ejecutó, cuándo pidió permiso y cómo verificó el resultado.
Termina con la primera versión de las instrucciones fijas de tu agente escrita y las siete piezas del harness identificadas.
Termina con cinco tareas de tu semana clasificadas por capa y al menos una lista para pasar al terminal.
Termina con la estructura de carpetas de tu proyecto definida: una carpeta por proyecto, el cajón .claude, el AGENTS.md abierto, la wiki de conocimiento y el formato OKF.
Clase 1 · Fundamento
Al final de esta clase podrás señalar, en una tarea real de tu trabajo, el momento exacto en que el chatbot del navegador deja de ayudar y empieza a hacerte perder tiempo.
Ya pagas por una IA y aun así pasas la tarde copiando y pegando. Pegas un informe, lees la respuesta, pegas otro, corriges a mano y al día siguiente la conversación no recuerda nada. La molestia es real y no es culpa tuya: es el límite de la capa que estás usando.
↓ rol para estudiar
Uno chatbot web es la IA que abres en el navegador y con la que conversas. Es la primera capa de cualquier sistema de IA y es buena en lo que hace: pensar contigo, redactar, resumir, traducir, darte una segunda opinión en segundos. No requiere preparación. La abres, escribes y recibes una respuesta.
Helena, directora de operaciones de una industria de empaques, lo usa así todos los días: pega el acta de la reunión de producción y pide los tres riesgos que nadie mencionó en voz alta. En veinte segundos obtiene un análisis que valdría una hora de trabajo de un consultor. Para este tipo de tarea, una conversación con un solo texto, la capa 1 es imbatible.
antes, sin IA
Helena leía toda el acta por la noche, hacía anotaciones con bolígrafo y escribía el resumen por la mañana. Una hora y media.
con el chat web
Pega el acta, pide los riesgos y revisa la respuesta con lo que sabe de la fábrica. Doce minutos.
Balance: cerca de 80 minutos por reunión, en tareas de un solo texto. Aquí es donde brilla el chat.
El asesor por teléfono tiene un problema: no está en tu oficina. No ve las carpetas sobre el escritorio. Todo lo que sabe es lo que le lees. Con el chat web pasa lo mismo. No ve tu computadora, así que cada archivo debe copiarse y pegarse, y la respuesta debe copiarse de vuelta. Te conviertes en mensajero entre la IA y tu propio trabajo.
Rafael, arquitecto, lo sintió durante la semana de las propuestas. Tenía catorce presupuestos antiguos en una carpeta y quería una tabla que comparara el precio por metro cuadrado. En el chat, pegó uno por uno. En la séptima propuesta, la conversación "olvidó" la primera. En la décima, se rindió y lo hizo a mano en una hoja de cálculo. El problema no era la inteligencia de la IA. Era que no tenía acceso a la carpeta.
Fíjate en el patrón: la tarea con uno el texto funciona; la tarea con varios se rompen archivos. Ese es el límite de la capa 1, y aparece justo en las tareas que más tiempo te llevan.
Ponte a prueba
Camila, dentista, quiere un resumen de los puntos de atención de 30 fichas de anamnesis que están en archivos separados en la computadora de la clínica. ¿Qué pasa si usa solo el chat web?
El segundo límite es la memoria. Le explicas al chat cómo escribe tu empresa, qué clientes son prioritarios y qué formato de informe te gusta. Mañana, en una nueva conversación, lo habrá olvidado todo. Es como un consultor que en cada llamada te pide que vuelvas a contarle la historia de la empresa.
Denise, consultora de marketing, tiene un documento con "las reglas de mi escritura" y lo pega al inicio de cada conversación. Funciona, pero es una solución improvisada: ella es la memoria de la IA. Cuando se olvida de pegarlo, el texto sale con el tono equivocado y solo se da cuenta después de enviárselo al cliente.
Recuerda estos dos límites: acceso y memoria. Las siguientes capas existen para superar precisamente esos dos.
El chat es excelente para conversar sobre un texto. Se traba cuando el trabajo está repartido entre varios archivos y se repite cada semana.
Practica ahora 0/4 completados
En unos 10 minutos, elige una tarea real de tu semana que implique más de un archivo y registra dónde deja de ayudarte el chat web. Te llevarás escrito el "punto de bloqueo".
Nada de esto cambia nada en tu computadora ni en tus conversaciones. Solo es observación. Si la tarea elegida no se traba, perfecto: anótalo también; es una tarea que corresponde a la capa 1.
Acabas de identificar, con una tarea tuya, el límite exacto de la capa 1. Esa es la frase que las próximas clases resolverán.
Resumen
Clase 2 · Fundamento
Al final de esta clase podrás dibujar en una servilleta las cuatro capas de un sistema de IA (chat, editor, terminal, harness) y decir, para cada una, cuál es su ventaja y en qué punto se atasca.
Cada mes aparece una herramienta nueva de IA y alguien de tu equipo dice que "esta sí es buena". Sin un mapa, compras por el ruido. Con el mapa de las capas, miras cualquier herramienta y sabes en diez segundos en qué nivel está y qué puede hacer en realidad.
↓ rol para estudiar
La segunda capa es la IA que vive dentro de un editor de código. Si el chat es un consultor por teléfono, esta es una asistente sentada a tu lado, mirando la misma pantalla. Ve el archivo que está abierto y sugiere cambios allí mismo, sin que tengas que copiar nada.
Es un gran salto para quienes programan. Para Rafael, arquitecto, es menos útil: el editor está hecho para código, no para propuestas y planos. E incluso para quien programa, el asistente solo ve lo que está en la pantalla. Si la respuesta depende de otros veinte archivos de la carpeta, los adivina. Y quien ejecuta, prueba y verifica sigue siendo la persona.
Ventaja: ves el archivo abierto y lo editas ahí mismo. Límite: solo ve la pantalla, y las manos siguen siendo tuyas.
O terminal es una ventana de texto que existe en todas las computadoras. Escribes una solicitud, la computadora la ejecuta y responde por escrito. Sin menús ni botones. Parece antiguo, y lo es: es la forma más directa de hablar con la máquina, anterior a cualquier pantalla bonita.
¿Por qué importa esto? Porque un agente puesto en este mostrador puede hacer todo lo que haría una persona haciendo clic, solo que por escrito y más rápido. Abre toda la carpeta de Rafael, lee las catorce propuestas, arma la tabla, comprueba que la suma sea correcta y avisa cuando termina. Tú no copias nada. Es el empleado con las llaves de la oficina, no el consultor al teléfono.
chat web
Rafael pega 14 propuestas, una por una. Pierde las primeras. Se da por vencido en la décima y lo hace en la hoja de cálculo.
agente en la terminal
Rafael escribe: «lee las propuestas de esta carpeta y arma una tabla de precios por metro cuadrado». El agente lee las 14, la arma, la verifica y se la entrega.
Balance: de perder una tarde a 4 minutos, y la tabla queda verificada con los archivos originales.
Un empleado con las llaves de la oficina, sin manual ni límites, es un riesgo. Por eso existe la cuarta capa. El harness es todo lo que rodea al agente para que trabaje a tu manera: el manual de «cómo hacemos las cosas aquí», la credencial que indica qué puede abrir por su cuenta y qué debe pedir, las recetas para tareas repetidas, los avisos automáticos, las puertas de acceso al calendario y al correo electrónico.
Camila, dentista, no quiere un agente que envíe mensajes a pacientes por su cuenta. En su harness está escrito: "mensajes a pacientes solo con mi aprobación; agenda e inventario, puede modificar". Esto no es programación. Es una hoja de reglas que el agente lee cada vez que empieza a trabajar. La clase 4 explica el harness pieza por pieza.
Ponte a prueba
Helena quiere que el agente prepare solo el informe semanal de producción, pero que nunca envíe nada a la dirección sin que ella lo lea. ¿En qué capa vive esta regla?
Toda tarea útil con IA pasa por un ciclo: entender la solicitud, planificar, hacer, revisar el resultado, corregir y entregar. El chat web se detiene en "planificar": te dice qué hacer y tú lo haces. El editor hace una parte, en el archivo abierto, y tú revisas. El agente en el terminal recorre el ciclo completo porque tiene acceso a los archivos, puede ejecutar y puede revisar lo que salió.
Denise, consultora de marketing, le pidió al agente: "genera el informe mensual de los tres clientes con los datos de esta carpeta y usa el modelo del mes pasado". El agente leyó los datos, preparó los tres informes, notó que faltaba una hoja de cálculo de un cliente, se lo avisó y entregó los otros dos listos. En el chat habría pegado datos durante una hora y habría descubierto que faltaba la hoja de cálculo después de enviarlos.
Por eso el terminal es la mejor capa. No es la más bonita ni la más fácil de abrir la primera vez. Es la única en la que la IA tiene manos y ojos al mismo tiempo: hace, verifica y corrige sin que tengas que intervenir.
El chat responde. El terminal ejecuta. El harness garantiza que lo haga a tu manera.
Practica ahora 0/3 completados
En unos 8 minutos, lee el caso, decide la capa de cada tarea y compara con la clave de respuestas. Te llevarás el mapa de capas aplicado a una semana real.
Es un análisis en papel: no se abre ninguna herramienta. Si tu respuesta difiere de la clave, lee la justificación: en las decisiones sobre capas, la diferencia suele estar en «cuántos archivos» y «si se repite o no».
El caso. Helena, directora de operaciones, enumeró cuatro cosas de la semana: (1) responder un correo electrónico delicado de un proveedor atrasado; (2) cruzar las 12 hojas de cálculo de turnos para encontrar las paradas de máquina sin justificar; (3) todos los lunes, armar el informe de producción de la semana anterior con el mismo modelo, a partir de los archivos que genera la fábrica; (4) el ingeniero de procesos quiere hacer un ajuste rápido en un archivo de cálculo que tiene abierto en su pantalla.
(1) Chat web. Un texto, una respuesta, el tono importa: es el mejor uso de la capa 1. (2) Terminal. Doce archivos, cruce y verificación: solo el agente con acceso a la carpeta completa el ciclo. (3) Terminal + harness. Es una tarea con varios archivos que se repite cada semana con el mismo modelo: el agente la ejecuta, y el modelo y la regla «no envíes sin que yo lo lea» quedan escritos en el harness. (4) Editor. Un único archivo, abierto en la pantalla de quien programa: la capa 2 lo resuelve en el momento.
Acabas de aplicar el mapa de las capas a una semana de trabajo, tarea por tarea.
Resumen
Clase 3 · Herramienta
Al final de esta clase podrás leer una sesión real de un agente en la terminal y señalar, línea por línea, dónde leyó archivos, dónde ejecutó, dónde pidió permiso y dónde revisó el resultado.
La primera vez que alguien abre una terminal, la pantalla negra asusta y la persona la cierra. Eso aleja precisamente a quienes más podrían aprovecharla. Esta clase disipa el miedo mostrando qué aparece en la pantalla y qué significa cada línea, para que sepas qué estás viendo cuando alguien de tu equipo, o tú, se siente allí.
↓ rol para estudiar
En la computadora de cualquiera hay un programa llamado Terminal (en Mac) o Terminal de Windows. Abre una ventana casi vacía con un cursor parpadeando. Eso es todo. No se activó ni modificó nada. Es una hoja en blanco que espera una solicitud por escrito.
Rafael abrió el suyo por primera vez esperando «algo de programadores». Vio el cursor y escribió, sin entender mucho, el comando que le indicó su sobrino. La computadora respondió con la lista de sus carpetas. La pantalla negra solo asusta hasta que responde por primera vez.
Lo que verás a continuación es una receta mínima: una solicitud de una palabra y la respuesta de la computadora. No necesitas memorizar nada, solo reconocer el formato de pregunta y respuesta.
solicitud y respuesta
$ ls
Propostas Plantas Contratos Fotos-obra
Con la terminal abierta en la carpeta correcta, una palabra llama al agente (en el ejemplo, Claude Code). A partir de ahí, escribes el pedido en portugués común, como se lo escribirías a un empleado. La diferencia con el chat es que el agente está dentro de la carpeta: puede leer los archivos sin que tengas que pegar nada.
Denise, consultora de marketing, hace esto para el informe mensual: entra en la carpeta del cliente, llama al agente y escribe "prepara el informe de septiembre con el modelo de agosto y los datos de las hojas de cálculo de esta carpeta". El agente enumera lo que va a hacer, lee los archivos y empieza.
Error común
Llamar al agente desde la carpeta equivocada. Solo ve la carpeta desde la que se abrió y las que están dentro de ella. Si lo abriste en toda la carpeta "Documentos", revisará todo y tardará; si lo abriste en una carpeta vacía, dirá que no encontró nada. Antes de llamarlo, revisa el nombre de la carpeta en la respuesta de la computadora.
en la carpeta correcta
$ cd Clientes/Padaria-Nova $ claude > monte o relatório de setembro no modelo do de agosto, com as planilhas desta pasta
Vou ler: agosto-relatorio.docx, setembro-vendas.xlsx, setembro-redes.xlsx Lendo 3 arquivos… Montando relatorio-setembro.docx
en la carpeta equivocada
$ claude > monte o relatório de setembro no modelo do de agosto
Não encontrei nenhuma planilha nem relatório de agosto nesta pasta (Documentos). Quer que eu procure nas subpastas? Isso pode demorar.
El agente lee archivos por su cuenta. Para crear, modificar o eliminar, pregunta antes, y tú respondes sí o no. Es la misma lógica que con un empleado nuevo: puede consultar libremente, pero antes de firmar cualquier cosa, viene a preguntar. En la clase 4 verás cómo cambiar este comportamiento mediante el harness; por defecto, pregunta.
A Camila, dentista, le gusta esto. Cuando le pidió al agente que "reorganizara la carpeta de radiografías por paciente", este le mostró el plan, le avisó que iba a mover 212 archivos y esperó su aprobación. Ella leyó el plan, vio que iba a separar por apellido y no por nombre, lo corrigió en una frase y entonces sí le dio el visto bueno.
Lo que aparece en pantalla siempre tiene el mismo formato: qué quiere hacer, sobre qué y la pregunta. Abajo, un ejemplo.
solicitud de permiso
> reorganize a pasta Radiografias em subpastas por paciente
Plano: criar 48 subpastas (uma por paciente, pelo nome no arquivo) e mover 212 arquivos. Nenhum arquivo será apagado. Posso mover os arquivos? [s/n]
La parte que distingue al agente del chat está al final: después de hacerlo, revisa el resultado. ¿Contó los archivos movidos? ¿Coincide con el plan? ¿Se abrió el informe? Si algo no cuadra, lo dice, en vez de entregar algo bonito pero incorrecto. Helena lo llama «el empleado que revisa antes de traerlo a mi escritorio».
En el informe semanal de producción, el agente de Helena avisó: «el turno de la noche del jueves no tiene hoja de cálculo; preparé el informe sin ese turno y marqué el dato faltante en rojo». En el chat, ese vacío habría pasado desapercibido hasta la reunión de dirección.
Qué buscar en una sesión con un agente
Practica ahora 0/3 completados
En unos 8 minutos, lee la transcripción de abajo, numera dónde el agente leyó, planificó, pidió permiso, ejecutó y revisó, y compara con la clave de respuestas.
Es una lectura, no se ejecuta nada. Quien ya se sienta cómodo puede, después, abrir su propio terminal y escribir solo la primera línea de la lección (el comando para listar), que no cambia nada. No es obligatorio para esta práctica.
La sesión. Rafael escribió en la carpeta Propuestas: "arma una tabla con el nombre del cliente, el área y el precio por metro cuadrado de cada propuesta de esta carpeta". En pantalla apareció, en este orden: (a) "Encontré 14 archivos: proposta-alves.pdf, proposta-bento.pdf…"; (b) "Voy a extraer el cliente, el área y el valor de cada uno, y calcular el precio por m²"; (c) "¿Puedo crear el archivo tabela-propostas.xlsx en esta carpeta? [s/n]"; (d) "Creando tabela-propostas.xlsx… 14 filas"; (e) "Verifiqué: 14 propuestas, 14 filas. A proposta-lima.pdf le falta el área; dejé la celda en blanco y la marqué en amarillo."
(a) leyó · (b) planificó · (c) pidió permiso · (d) ejecutó · (e) verificó. Si Rafael decía "no" en (c), no se creaba nada: la carpeta quedaba exactamente como estaba, porque el permiso va antes de cualquier cambio. Fíjate también en que la etapa (e) señaló una laguna (la propuesta sin área) en vez de inventar un número: es el comportamiento que quieres de un agente y es algo que el chat no puede hacer.
Acabas de leer una sesión completa de un agente sabiendo qué significa cada línea. La pantalla negra dejó de ser negra.
Resumen
Clase 4 · Fundamento
Al final de esta clase podrás nombrar las siete piezas del harness y escribir, en portugués, la primera versión de las instrucciones fijas de tu agente, con al menos tres reglas y un límite.
Un agente sin harness es como un empleado brillante en su primer día: no sabe cómo escribe tu empresa, qué puede firmar ni quién tiene prioridad. Terminas repitiendo todo en cada sesión, el mismo problema que con el chat. El harness convierte a un agente genérico en tu agente, y su pieza más importante cabe en una hoja.
↓ rol para estudiar
La primera pieza del harness es una hoja de texto que el agente lee cada vez que empieza a trabajar. Se llama instrucciones fijas. Allí escribes, una sola vez, lo que hoy repites en cada conversación: cómo escribe tu empresa, qué clientes tienen prioridad, qué formato de informe usas y qué nunca debe hacer.
Denise transformó el documento "reglas de mi escritura", que pegaba a mano en el chat, en esta hoja. Ahora el agente ya empieza sabiendo: "tono directo, sin jerga, párrafos cortos, nunca prometer resultados de campaña". Ya no pega nada. Resolvió con una hoja el problema de la memoria entre conversaciones que faltaba en la clase 1.
sin instrucciones fijas
Denise explica el tono y las reglas en cada sesión. Cuando se olvida, el texto sale mal y se da cuenta después de enviarlo.
con instrucciones fijas
Las reglas están en la hoja. Cada sesión empieza con su lectura. ¿Cambió una regla? Edita la hoja; se aplica para siempre.
Balance: cero repeticiones por sesión, y el tono equivocado dejó de llegar al cliente.
El agente actúa mediante herramientas: leer y escribir archivos, ejecutar tareas en la computadora, buscar en internet, abrir un sitio. Son sus manos. Sin herramientas, vuelve a ser un chat. La tercera pieza, los permisos, es la credencial: define qué puede hacer por su cuenta y qué debe preguntar. Leer casi siempre está permitido. Eliminar, publicar, enviar, pagar: solo con tu aprobación, o totalmente prohibido.
Camila decidió la credencial del agente de la clínica en cinco líneas: agenda e inventario, puede modificar; carpeta de radiografías, puede organizar, pero nunca borrar; mensajes a pacientes, solo con su aprobación; datos de historias clínicas, fuera de su alcance. No es un sistema de seguridad que haya comprado. Es una lista escrita que el agente respeta.
Fíjate en que la herramienta y el permiso se complementan: la herramienta indica lo que puede hacer; el permiso indica lo que está autorizado a hacer.
Una tarea que se repite merece una receta. Una skill es esto: el paso a paso para «hacer el informe mensual», escrito una vez, con el modelo, el orden y las verificaciones. Después, solo dices «haz el informe mensual» y sigue la receta. Es el patrón de costura reutilizable: corta el mismo vestido en cualquier tela.
Uno hook es un disparador: «cada vez que termines un informe, compara los totales con la hoja de cálculo» o «avísame antes de publicar cualquier cosa». Helena tiene uno: «al final de cada sesión, enumera lo que cambió y lo que quedó pendiente». No lo pide; sucede.
Ponte a prueba
Rafael quiere que, cada vez que el agente arme una propuesta, verifique automáticamente si el precio por metro cuadrado está dentro del rango de la oficina. ¿Eso es una skill o un hook?
La sexta pieza son las conexiones con otros sistemas. El nombre técnico es MCP, pero piensa en enchufes: uno para la agenda, otro para el correo electrónico y otro para la hoja de cálculo del equipo. Al conectar el enchufe, el agente empieza a ver ese sistema como ve la carpeta.
La séptima es la memoria y la división del trabajo. El agente puede guardar lo que aprendió sobre tu manera de trabajar entre sesiones y, en tareas grandes, llamar a otros agentes para que trabajen en paralelo, como un gerente que distribuye una auditoría entre analistas. Helena usa esto al cierre del mes: un agente se ocupa de las hojas de cálculo de turnos, otro de las de mantenimiento, y el principal reúne todo y lo revisa.
No necesitas conectar las siete piezas el primer día. Las instrucciones fijas y los permisos ya lo cambian todo. El resto se incorpora cuando una tarea lo requiera.
Une las piezas y el ciclo de la clase 2 mejora. Llega la solicitud y el agente ya leyó el manual de la empresa. Planifica dentro de sus credenciales. Si la tarea tiene una receta, la sigue. Ejecuta con las manos que autorizaste, en los enchufes que conectaste. Revisa, y el disparador de fin de sesión enumera lo que cambió. La próxima vez, lo recuerda.
Para Camila, la diferencia práctica es que el agente de la clínica se comporta como una recepcionista con diez años en el puesto, y no como una suplente en su primer día. El modelo de IA es el mismo. Lo que cambió fue la hoja que lo acompaña.
El modelo es el mismo para todos. El harness es lo que hace que sea tuyo.
Practica ahora 0/4 completados
En unos 12 minutos, usa tu chatbot de siempre para redactar la hoja de instrucciones fijas de tu futuro agente: tres reglas sobre cómo trabajar y un límite sobre lo que nunca hace. Te llevarás la hoja lista para pegarla cuando exista el agente.
Es solo un texto, nada más. No activa ningún agente ni cambia nada en la computadora. Si la respuesta es genérica, es porque faltó tu contexto: agrega un ejemplo real y vuelve a pedirlo.
Você vai me ajudar a escrever as instruções fixas de um agente de IA que vai trabalhar comigo. Sou <sua profissão e contexto, ex.: dentista com clínica de 3 cadeiras>. As tarefas que ele vai fazer: <2 ou 3 tarefas reais, ex.: organizar agenda, montar relatório mensal>. Como eu gosto que as coisas sejam feitas: <tom, formato, prioridades>. O que ele nunca deve fazer sem me perguntar: <ex.: enviar mensagem a paciente, apagar arquivos>. Escreva a folha em português, com estas seções: "Quem eu sou", "Como trabalhamos aqui" (3 a 5 regras curtas), "Pode fazer sozinho", "Só com minha aprovação", "Nunca". Frases curtas, sem jargão.
Acabas de escribir la pieza más importante del harness. Cuando exista el agente, será lo primero que lea.
Resumen
Clase 5 · Práctica
Al final de esta clase podrás revisar cinco tareas de tu semana y decir, en segundos y con un motivo, cuál va al chat, cuál al editor, cuál a la terminal y cuál merece entrar en el harness.
Sin una regla para decidir, la tendencia es usar el chat para todo, porque es lo que está abierto. Así, las tareas grandes siguen siendo manuales y la IA se convierte solo en un redactor más rápido. La regla de esta clase cabe en cuatro líneas y te devuelve las horas que se pierden en tareas con varios archivos.
↓ rol para estudiar
Todo el curso se resume en una pregunta por tarea: ¿cuántos archivos abarca y se repite? La respuesta señala la capa. La regla de abajo es la que Helena pegó en la pared de su sala, y sirve igual para el consultorio de Camila o la oficina de Rafael.
La regla de decisión
Denise, consultora de marketing, aplicó la regla un lunes. En su lista quedaron: responder la propuesta de un nuevo cliente (un texto: chat). Preparar el informe mensual de tres clientes con las hojas de cálculo de cada carpeta (varios archivos y tarea repetida: terminal, con la receta en el harness). Revisar los subtítulos de la semana de un cliente (un texto a la vez: chat). Verificar que todos los informes enviados durante el trimestre coincidan con las facturas (varios archivos y verificación: terminal).
Resultado de la semana: dos tareas se quedaron en el chat, donde ya estaban bien. Dos pasaron al terminal, y eran precisamente las que consumían la tarde del viernes. Nada pasó al editor, porque Denise no programa. La regla no le quita el chat a nadie: devuelve al terminal lo que nunca debió copiarse y pegarse.
Cuando la regla se vuelve un hábito, el patrón es siempre el mismo: el chat sigue en el día a día, el terminal absorbe las tareas pesadas y el harness crece una línea por semana con lo que descubres que quieres mantener siempre igual. En un mes, la hoja de instrucciones fijas ya refleja tu operación.
En tu profesión
Practica ahora 0/4 completados
En unos 10 minutos, haz una lista de cinco tareas reales de la próxima semana, pasa cada una por la regla de cuatro líneas y marca al menos una como candidata para la terminal. Te llevarás tu primer plan de capas.
Es una lista en papel o en el celular. No se abre ni configura nada. Si ninguna tarea termina en el terminal, vuelve a leer la línea 3 de la regla: casi todas las semanas hay al menos una tarea con varios archivos escondida en una «tarde de organización».
Acabas de decidir, con criterio, dónde debe invertirse cada hora de tu semana. La tarea marcada es tu primer trabajo para la terminal.
Resumen
Clase 6 · Fundamento
Al final de esta clase podrás dibujar la estructura de carpetas de un proyecto tuyo (una carpeta por proyecto, el cajón oculto de reglas, la hoja de instrucciones, las recetas y la base de conocimiento) y explicar para qué sirve cada una.
En las clases anteriores, el harness apareció como «una hoja que el agente lee». Pero las hojas están en algún lugar. Quien no sabe dónde, deja al agente suelto en toda la carpeta Documentos, pierde las reglas entre proyectos y acumula conocimientos en conversaciones que desaparecen. La respuesta es organizar las carpetas, y cabe en un dibujo.
↓ rol para estudiar
Recuerda la clase 3: el agente solo ve la carpeta desde la que se abrió y las que están dentro. Esto se convierte en una regla de organización: una carpeta por proyecto, todas dentro de una carpeta principal llamada, por ejemplo, "projetos". Así, "projetos/projeto1" es la oficina del proyecto 1. El agente abierto allí ve todo el proyecto 1 y nada más. No recorre la computadora, no mezcla clientes ni tarda.
Rafael tenía todo en una carpeta "Escritorio" con decenas de obras mezcladas. Cuando pedía "arma la tabla de las propuestas", el agente leía propuestas de tres obras diferentes. Pasó todo a "proyectos/obra-vila-nova", "proyectos/obra-centro" y el problema desapareció. Cada carpeta se convirtió en una oficina con paredes.
una carpeta para todo
El agente lee 40 obras para responder sobre una. Las reglas de un cliente se filtran a otro. Tarda y se equivoca.
projetos/projeto1
El agente abre la carpeta de la obra correcta, lee solo lo que importa y las reglas de esa obra están ahí mismo.
Balance: alcance definido por la carpeta. Cambiar de proyecto es cambiar de carpeta.
Dentro de cada proyecto hay una carpeta cuyo nombre empieza con un punto: ".claude". El punto al inicio es una convención: esas carpetas quedan ocultas en la lista normal, como el cajón de procedimientos que permanece cerrado, pero todos saben dónde está. Allí vive el harness del proyecto: la hoja de instrucciones fijas (el archivo CLAUDE.md, que escribiste en la clase 4), el archivo de permisos, la carpeta "skills" con las recetas y la carpeta "agents" con los subagentes.
Camila tiene, dentro de "projetos/clinica", el cajón ".claude" con la hoja de reglas ("nunca enviar mensajes a pacientes sin aprobación") y una receta llamada "fechamento-do-mes". Cuando abre el agente en la carpeta de la clínica, este lee el cajón antes que nada. En la carpeta del consultorio nuevo, otro cajón, otras reglas.
Lo que sigue es la pantalla real de un listado que muestra el cajón. Léelo como un mapa de carpetas, nada más.
el cajón oculto aparece con -a
$ cd projetos/clinica $ ls -a .claude
CLAUDE.md settings.json skills/ agents/ $ ls .claude/skills fechamento-do-mes/ confirmar-agenda/
El cajón ".claude" es de Claude Code. Otros agentes (Codex, Cursor, Gemini) tienen los suyos. Para no escribir la misma hoja cinco veces, el mercado acordó un estándar abierto: un archivo llamado AGENTS.md en la raíz del proyecto, y una carpeta ".agents/skills" para las recetas. Claude Code lee ambas. Codex también. Una hoja, varios empleados.
Vercel publicó una herramienta que copia recetas listas en la carpeta correcta de cada agente y mantiene un catálogo abierto de recetas. Eso es lo que hace que una skill sea portátil: una carpeta pequeña con un SKILL.md dentro, que cualquier agente entiende. Helena aprobó la estandarización en la fábrica por un motivo sencillo: si el equipo cambia de agente, las reglas y las recetas siguen vigentes.
Regla práctica: escribe las reglas generales en AGENTS.md; deja en ".claude" solo lo específico de ese agente. En proyectos grandes, cada subcarpeta puede tener su propio AGENTS.md, y el agente usa el más cercano.
Ponte a prueba
Denise usa Claude Code hoy, pero el nuevo cliente trabaja con Codex. ¿Dónde escribe las reglas de tono de la agencia para no mantener dos copias?
Las reglas dicen cómo trabajar. Falta lo que sabe el proyecto: reuniones, decisiones, datos, referencias. Andrej Karpathy, uno de los nombres más conocidos del área, propuso un patrón simple que se convirtió en referencia: dos carpetas. En "raw" pones todo lo que llega (actas, PDFs, correos, recortes), sin modificarlo. En "wiki", el agente escribe, a partir de raw, páginas de texto simple enlazadas entre sí, una por tema, y las mantiene actualizadas. Es un LLM wiki.
Tres operaciones, siempre las mismas: ingerir (llega una nueva acta, el agente actualiza las páginas afectadas), preguntar (tú preguntas, responde citando las páginas) y revisar (revisa contradicciones y páginas huérfanas). Helena armó la wiki de la fábrica en dos semanas: cada acta de producción va a raw, y la página "paradas de máquina" está siempre actualizada, con la fecha y la fuente de cada línea.
La diferencia con el chat es la de siempre: la conversación desaparece; la wiki queda en una carpeta, es texto que puedes abrir y corregir, y el agente de la próxima sesión encuentra todo allí.
La wiki resuelve un proyecto. Cuando el conocimiento necesita circular entre áreas, empresas y agentes diferentes, ayuda tener un formato acordado. Google Cloud publicó uno: el OKF, Open Knowledge Format. Es mínimo a propósito: una carpeta de archivos de texto, cada uno con un encabezado breve al principio que indica el título, el tipo, la descripción y el autor; un archivo "index.md" en cada carpeta que enumera lo que hay allí; y un "log.md" con el historial de cambios.
Dos detalles importan para quien toma decisiones. Primero, el encabezado registra quién escribió cada página: una persona («human:helena») o un agente («agente/versión»). Así puedes confiar de forma distinta en lo que confirmó una persona. Segundo, el índice permite que el agente vea lo que existe antes de abrirlo todo, lo que ahorra tiempo y evita que lea lo que no necesita. Rafael usa el encabezado para marcar «verificado por: human:rafael» en las páginas de costos que revisó.
No hace falta adoptar el OKF el primer día. La idea que queda es la misma de las clases anteriores: conocimientos en una carpeta, en texto simple, con responsable y fecha, que las personas y los agentes leen y actualizan.
Reglas en el cajón, conocimiento en el armario, una sala por proyecto. El agente entra y ya sabe dónde está.
Practica ahora 0/4 completados
En unos 12 minutos, usa tu chatbot de siempre para dibujar el árbol de carpetas del proyecto que marcaste en la clase 5: carpeta del proyecto, cajón de reglas, base de conocimiento. Te llevarás el dibujo listo para crear las carpetas cuando te sientes frente a la terminal.
Es un esquema en texto. No se crea ninguna carpeta, nada cambia en la computadora. Si la respuesta incluye carpetas que no entiendes, pide «explica cada carpeta en una frase, como si fuera a organizar un armario».
Quero organizar as pastas de um projeto em que um agente de IA vai trabalhar comigo. Projeto: <nome e o que é, ex.: relatório mensal de produção da fábrica>. Arquivos que ele vai usar: <ex.: 12 planilhas de turno por semana, atas de reunião em PDF>. Regras que ele deve ler sempre: <cole a folha de instruções fixas da aula 4, ou resuma>. Desenhe a árvore de pastas em texto, começando em projetos/<nome-do-projeto>/, com: 1) a pasta oculta .claude (com CLAUDE.md, settings.json, skills/ e agents/) e um AGENTS.md na raiz com as regras gerais; 2) uma base de conhecimento no padrão wiki (pastas raw/ e wiki/) com 3 páginas iniciais sugeridas; 3) um index.md na raiz listando cada pasta com uma frase. Explique cada pasta em uma frase, sem jargão. Diga o que eu NÃO devo colocar dentro dessa pasta.
Acabas de diseñar la oficina de tu agente. Crear las carpetas es una solicitud de una línea para él, en la clase 3.
Resumen