Contenido detallado
Este es el módulo de referencia de la Ruta 1. No necesitas memorizarlo todo: léelo una vez para reconocer los términos y vuelve aquí siempre que una palabra aparezca "de la nada" en una ruta técnica. La regla de cada entrada es sencilla: una frase concreta + una analogía cotidiana.
🪪 Identidad y CLAUDE.md
📖 ¿Qué es Identidad?
En una frase: es quién es el OS, a quién sirve y qué nunca debe rechazar.
Analogía: la descripción del puesto que le entregas a un asistente nuevo el primer día: sin ella, es competente, pero está perdido.
La Identidad vive en un archivo concreto: el CLAUDE.md. Es un archivo de texto común (formato Markdown — solo texto con algunos símbolos) que el harness — el programa de terminal que le da manos a la IA, como el Claude Code — lee primero, antes que cualquier otra cosa. Por eso el autor llama al CLAUDE.md de "el archivo del alma".
📖 ¿Qué es el CLAUDE.md?
En una frase: el archivo esencial de Identidad, que se lee antes que todo y donde reside quién es el OS.
Analogía: la primera página del manual de la casa: quién vive aquí, las reglas de la casa, lo que nunca debes hacer.
| Entra en CLAUDE.md | Ejemplo concreto |
|---|---|
| Quién eres | "Soy fotógrafo de bodas y trabajo solo." |
| A quién sirve | "Este OS me sirve a mí; los clientes nunca lo ven." |
| Qué nunca rechazar | "Nunca te niegues a ayudar a redactar contratos." |
Por qué aprender
Porque la Identidad es la primera capa de todo (la Trilha 2, Módulo 2.1, está dedicada a ella). Si reconoces el término ahora, no te trabarás después cuando el curso diga «escribe tu CLAUDE.md conciso».
Conceptos clave
🗃️ Substrato vs. Contexto
📖 ¿Qué es Substrato & Contexto?
En una frase: es todo el conocimiento del dominio: el material bruto, el historial, los documentos y los datos en los que se basa el OS.
Analogía: lo que hay detrás de la cocina: la despensa, las recetas anotadas, el inventario que el cliente nunca ve, pero sin el cual el plato no sale.
Conviene separar dos sentidos que suelen confundirse. El Sustrato es todo lo que está guardado en el disco: toda la base de conocimiento del dominio. El Contexto es la parte de ese material que efectivamente entra en la "ventana" del modelo durante una conversación. Como la ventana es limitada, guardas mucho (substrato) e inyectas poco y bien elegido (contexto).
| Sustrato | Contexto | |
|---|---|---|
| Qué es | todo lo que está en el disco | lo que entra en la conversación |
| Tamaño | grande, siempre crece | pequeño, limitado por la ventana |
| Analogía | la despensa entera | los ingredientes sobre la mesa ahora |
💡 Por qué importa la distinción
"El camión de basura en llamas" (Módulo 2.2) es precisamente el sustrato desordenado. Organizarlo antes de conectar la IA permite inyectar en el contexto solo lo que importa, sin desperdiciar la ventana con ruido.
Por qué aprender
Porque esta capa representa, en muchos dominios, la mayor porción de la pizza. Quien confunde "guardar todo" con "inyectar todo" satura el contexto y empeora las respuestas. La distinción te enseña a separar el archivo (sustrato) de lo que sirves (contexto).
Conceptos clave
🚧 Regla vs. Gancho
Este es el par más importante que no debes confundir. Ambos sirven para imponer límites, pero tienen fuerzas diferentes: una regla pide, un gancho obliga.
📖 ¿Qué es una Regla?
En una frase: una sugerencia sólida al modelo: casi siempre obedece, pero no está garantizado.
Analogía: un letrero de «no entres». Convence a casi todo el mundo, pero no lo impide físicamente.
📖 ¿Qué es un Gancho?
En una frase: una acción determinista que siempre (o nunca) ocurre — no es una opinión del modelo, es código.
Analogía: una puerta cerrada con llave. No importa lo que quieras: no se abre.
| Regla (rule) | Gancho (hook) | |
|---|---|---|
| Fuerza | probabilística (casi siempre) | determinista (siempre/nunca) |
| Dónde vive | texto en rules/ | código (p. ej.: settings.json, pre-commit) |
| Úsala para | tono, preferencias, buenas prácticas | lo que NO puede fallar (PII, dinero, escritura en la base de datos) |
💡 La regla práctica
Determinista donde importa. Si un error cuesta caro —filtrar un dato personal, borrar una tabla, enviar dinero por error— no confíes en una regla «flexible»: usa un gancho. Para el resto (estilo, tono, orden de preferencia), basta con la regla.
Por qué aprender
Porque la Trilha 2 (Módulo 2.3) trata por completo sobre graduar reglas e instalar ganchos. Confundir ambos te lleva a confiar en un cartel cuando necesitabas una puerta cerrada con llave, y así ocurren los accidentes costosos.
Conceptos clave
🧩 Skill (habilidad)
📖 ¿Qué es una Skill?
En una frase: una tarea repetible, empaquetada para ejecutarse igual cada vez: un único «verbo» que el OS sabe ejecutar.
Analogía: una tarjeta de receta. Los mismos pasos, en el mismo orden, dan el mismo plato cada vez que la sigues.
No Claude Code, una skill suele aparecer como un slash command — un comando que empieza con barra, como /resumo. Activás el verbo por su nombre y ejecuta el proceso que empaquetaste. El autor refuerza una idea central: empieza manual (hazlo a mano primero), captura los pasos después y nunca dejes de perfeccionarlo.
✓ Buena candidata a skill
- ✓Algo que ya haces a mano y repites mucho.
- ✓Pasos estables, con un resultado predecible.
- ✓Vale la pena empaquetarlo porque ahorra tiempo de verdad.
✗ Skill deficiente
- ✗Algo que nunca hiciste a mano (no sabes los pasos).
- ✗Escribir 10 de una vez, sin usar ninguna.
- ✗Tratarla como «lista»: una skill nunca se termina.
Por qué aprender
Porque las skills son la primera capa de "acción" (Trilha 3, Módulo 3.1). Saber que es un verbo repetible y que comienza de forma manual evita el error clásico de intentar automatizar algo que todavía no entiendes.
Conceptos clave
🤖 Agente
📖 ¿Qué es un Agente?
En una frase: un papel con criterio que elige qué skills usar, en qué orden, normalmente con una instancia de revisión antes de que algo salga.
Analogía: el chef que elige la herramienta adecuada, prepara el plato y lo prueba antes de servirlo — a diferencia de la tarjeta de receta (skill), que solo ejecuta un paso.
La diferencia con skill es la clave: la skill es un verbo (hace una cosa); el un agente es un trabajador (decide qué verbos usar). Por eso el agente es la última capa: necesita skills para orquestar. Y solo vale la pena ascender a agente una rutina que tú ya lo hace manualmente hoy.
| Skill | Agente | |
|---|---|---|
| Es un… | verbo (1 tarea) | rol (decide tareas) |
| Juicio | ninguno: solo ejecuta | elige y ordena |
| Analogía | tarjeta de receta | el chef |
Por qué aprender
Porque «agente» es la palabra que más entusiasma y más confunde. Fijar que agente = chef (criterio) y skill = receta (ejecución) te inmuniza contra el error n.º 1 del Módulo 1.2: saltar a los agentes antes de tener skills.
Conceptos clave
🔌 Skill vs. CLI vs. MCP vs. API
Estas son las cuatro formas en que el OS "actúa en el mundo" — y cómo saber cuándo usar cada una es una de las preguntas centrales del curso (Módulo 3.2). Van desde lo más «tuyo» (una skill que tú mismo empaquetas) hasta lo más externo (la API sin procesar de un servicio).
Cómo leer: de izquierda a derecha, pasas de lo que es "muy tuyo" (una Skill que empaqueta tu manera de hacer las cosas) a lo que es "puramente externo" (la API sin procesar del servicio). La CLI queda en el medio: la construyes sobre una API para tener un control sencillo y seguro.
| Término | En una frase | Analogía | Cuándo usar |
|---|---|---|---|
| Skill | verbo repetible que empaquetas | la forma de hacer las cosas aquí | proceso tuyo, sin necesitar un servicio externo |
| CLI | programa de línea de comandos para un servicio | control remoto conciso | cuándo quieres control (y seguridad de solo lectura) |
| MCP | protocolo que conecta la IA con una herramienta | adaptador de corriente | conexión rápida y estándar (menos relevante con el tiempo) |
| API | la puerta de datos de un servicio | la entrada de servicio del edificio | la base — sueles envolverla en una CLI |
🌱 ¿Nuevo aquí?
CLI = "command-line interface", un programa que manejas escribiendo comandos. MCP = "Model Context Protocol", una forma estándar de conectar herramientas a la IA. API = "application programming interface", la puerta por la que los programas solicitan datos a un servicio. No necesitas saber programar ninguno de ellos ahora; solo reconocer qué significa cada sigla.
Por qué aprender
Porque la pregunta «¿skill, CLI, MCP o API?» vuelve a aparecer cada vez que el OS necesita interactuar con algo externo. Con este esquema en mente, eliges con intención y entiendes por qué el autor prefiere CLIs de solo lectura para lo que es peligroso.
Conceptos clave
💎 Nugget · context rot · reverse meta-prompting
Tres términos que el autor dice que "la mayoría de las personas ignora" — y que distinguen un OS amateur de uno que se mantiene activo. Cada uno viene con su frase y su analogía.
Nugget
Un resumen muy destilado (como 10 viñetas) del material en bruto, listo para inyectar en el contexto.
Analogía: el concentrado reducido — concentrado, sin el agua.
Context rot
El deterioro del contexto: el punto en que la información envejece y necesita actualizarse.
Analogía: comida con fecha de vencimiento: en algún momento se echa a perder.
Reverse meta-prompting
Pedirle a la IA que, al final de una sesión, destile la conversación en una skill reutilizable.
Analogía: escribir la receta después de haber cocinado.
💡 Cómo se conectan los tres
Destilas el material en hallazgos, monitorea el context rot para saber cuándo actualizarlos, y usa reverse meta-prompting para convertir lo que aprendiste en una skill, en vez de reescribir todo desde cero la próxima vez.
Por qué aprender
Porque son los conceptos que mantienen el OS "cultivado" (Módulo 1.1) en lugar de dejarlo pudrirse. Vuelven a aparecer en Trilha 5 (producción): los crons de síntesis, los puntos de corte por dominio y los resúmenes posteriores a la sesión salen de aquí.
Conceptos clave
📦 datos sin procesar vs. sintetizados
📖 ¿Qué es raw vs. sintetizado?
En una frase: tú guardas el material en bruto en una carpeta raw/ (como garantía) e inyecta en el OS solo la versión destilada —los nuggets— de una carpeta synthesized/.
Analogía: despensa (crudo, guardado) vs. plato listo (destilado, servido). Cocinas a partir de la despensa, pero sirves solo el plato.
La regla de oro del autor es una sola frase: "inyecta solo las pepitas". El material en bruto (transcripciones completas, PDFs largos) se guarda, pero nunca va directo al contexto, porque llenaría la ventana de ruido. Un modelo barato (un "workhorse", como Gemini Flash) resume el material en bruto en nuggets, en un bucle.
Cómo leer: lo bruto entra por la izquierda y queda guardado; el modelo workhorse lo reduce a nuggets; y solo los nuggets cruzan la última flecha hacia el contexto. La carpeta raw/ nunca alimenta el modelo directamente — es la protección, no el ingrediente del plato.
Por qué aprender
Porque «raw → sintetizado → inyectado» es el patrón de datos que se repite en TODO el dominio del curso. Fijarlo ahora hace que la Trilha 2 (Substrato) y la Trilha 5 (producción) parezcan obvias: ya sabes que guardas mucho e inyectas poco.
Conceptos clave
✅ Resumen del módulo
Siguiente ruta:
Ruta 2 · Técnica I — empieza por la Identidad (2.1), la primera capa real. 🪪