Contenido detallado
📄 Qué es el archivo-alma
La capa de Identidad vive en un único archivo: el CLAUDE.md. El autor lo llama "el archivo del alma" porque es el primero que el harness lee antes de cualquier tarea. Define el tono de todo: quién es el OS, qué es el negocio y qué nunca debe rechazar.
🌱 ¿Nuevo aquí?
O CLAUDE.md es un archivo de texto común en formato Markdown (texto plano con algunos símbolos de formato). El harness es el programa de terminal que le da manos a la IA: el Claude Code lee el CLAUDE.md; o Codex lee un archivo equivalente (p. ej.: AGENTS.md). La idea es la misma: un texto de apertura que enseña a la IA a ser ese OS, y no un asistente genérico.
Cómo leer: o CLAUDE.md (a la izquierda) es solo un texto corto en cuatro bloques. El harness lo lee primero (flecha cian) y, a partir de él, deja de ser genérico y actúa como el OS de ese dominio.
Por qué aprender
Porque es la pieza que más cambia el comportamiento con menos esfuerzo. Un CLAUDE.md si está bien escrito, la IA acierta el tono a la primera; si falta o está inflado, tienes que volver a explicar el contexto en cada conversación. Es la primera capa de la base, y la base sostiene todo lo que viene después.
Conceptos clave
🧾 Qué va en el CLAUDE.md
El contenido siempre es el mismo puñado de bloques, adaptados al dominio: tú, o negocio, o mercado en la que opera, los eventos actuales relevantes, tuyas preferencias y lo que quieres siempre o nunca ver. Lo que NO entra es igual de importante: el conocimiento en bruto y los documentos van al Sustrato (Módulo 2.2), no aquí.
🧩 Qué es
Un retrato breve y estable del contexto que sirve para cada conversación de ese dominio — no la tarea de hoy, sino el trasfondo permanente.
- •Tú y el negocio: nombre, función, objetivo del dominio en una frase.
- •Mercado y eventos actuales: dónde operas y qué cambió recientemente.
- •Preferencias: formato de salida, tono, qué incluir siempre/nunca.
✓ Entra en la Identidad
- ✓Quién eres y a quién sirve el OS.
- ✓El mercado, la jurisdicción, los acontecimientos actuales.
- ✓Preferencias de formato y qué nunca rechazar.
✗ NO entra (va al Sustrato)
- ✗Documentos en bruto, transcripciones, leyes completas.
- ✗Historiales largos y tablas de datos.
- ✗Paso a paso de tareas (esto se convierte en Skill).
Por qué aprender
Porque mezclar identidad con sustrato es el error más común: la gente vuelca todo en el CLAUDE.md y se infla. Saber qué entra (contexto estable) y qué sale (material de referencia) mantiene el alma breve y el OS rápido.
Conceptos clave
✂️ Conciso < 30 líneas — recorta hasta que duela
La regla práctica es estricta: mantén el CLAUDE.md conciso, por debajo de ~30 líneas, e recorta hasta que duela. Una identidad inflada confunde al OS: el modelo gasta atención leyendo cosas que no importan y diluye lo que importa. Ser breve es una decisión de diseño, no de pereza.
💡 La prueba del corte
Para cada línea, pregunta: "si borro esto, ¿el OS se equivocará?". Si la respuesta es "no", bórralo. Si es "tal vez", es material de referencia: envíalo al Substrato. Solo se queda lo que cambia el comportamiento cada vez.
✓ Identidad acotada
- ✓Cabe en una pantalla; se lee en 20 segundos.
- ✓Cada línea cambia el comportamiento.
- ✓Apunta al Sustrato en vez de copiarlo.
✗ Identidad inflada
- ✗Se desplaza por páginas con todo «por si acaso».
- ✗Pega leyes, historiales y tablas enteras.
- ✗Diluyen lo esencial entre el ruido.
Por qué aprender
Porque la tentación de «guardar todo aquí» es la forma más rápida de degradar el OS. Tratar la identidad como un breve texto editorial, y no como un depósito, es lo que separa un OS que responde con precisión de uno que se pierde. Ese hábito de recortar también protege tu ventana de contexto.
Conceptos clave
👥 A quién le sirve: tú vs. un equipo
La siguiente pregunta es "¿a quién le sirve este OS?". Si es solo para ti, la identidad es sencilla. Si es para un equipo, necesitas incorporar los roles y responsabilidades — quién hace qué y cómo se divide el trabajo, para que el OS responda de forma coherente a distintas personas.
Un dueño, una voz. La identidad habla de «mí»: mis preferencias, mis límites. Más breve y directa.
Varios roles. La identidad describe las responsabilidades de cada función y lo que cada rol puede pedir o ver.
🔎 El detalle que lo cambia todo
En un OS de equipo, "a quién sirve" incluye límites por rol: un pasante júnior, por ejemplo, quizás solo pueda leer datos, nunca escribir. Este mecanismo empieza en la identidad y se convierte en una regla o un gancho concreto en el Módulo 2.3.
Por qué aprender
Porque el mismo dominio genera identidades diferentes según el público. Definir desde el principio "tú o un equipo" evita crear un OS que no le sirva bien a nadie. Y ya siembra la idea de los límites: quién puede hacer qué.
Conceptos clave
🛡️ Cuándo Claude debe suprimir las negativas
Los modelos modernos se volvieron más "jueces" — a veces rechazan cosas legítimas de tu dominio o piden confirmación. La identidad es el lugar adecuado para un guía rápida de rechazos: indicar explícitamente cuándo el OS debe dar el beneficio de la duda y seguir, en lugar de bloquearse.
🌱 ¿Nuevo aquí?
"Suprimir un rechazo" no es eludir la seguridad: es evitar que la IA se bloquee en tareas legítimas y sus. Ej.: leer tu propia acta de nacimiento en tu Freedom OS o categorizar tus propios estados de cuenta en el Tax OS. Describes el contexto ("son mis datos, en este dominio, con este objetivo") para que el modelo no te pida confirmación a cada paso.
💡 Por qué esto empeora con modelos mejores
Cuanto más «inteligente» es el modelo, más opina. El autor observa que cada generación tiende a ser más cautelosa y a llenarse de salvedades. Un CLAUDE.md que anticipa esto — "en este dominio, con mis datos, continúa" — ahorra fricción en cada sesión.
⚠️ La línea que no se cruza
La cheat sheet de rechazos sirve para tareas tuyas y legítimas. No uses la identidad para intentar sortear límites reales de seguridad ni para modificar datos de terceros: eso es abuso, no ingeniería de OS.
Por qué aprender
Porque la fricción de las negativas repetidas es lo que hace que la gente abandone el OS. Un cheat sheet bien redactado mantiene el flujo: el OS ayuda sin sermonear, dentro de lo que es tuyo y legítimo.
Conceptos clave
🌐 Patrón multi-OS: apuntar a un archivo global
Cuando tienes varios OS (Freedom, Tax, Skool…), comparten algunas cosas: tu nombre, tus preferencias de escritura y datos sobre ti. En vez de repetirlos en cada CLAUDE.md, usa el estándar multi-OS: uno archivo global con lo que es común, y cada OS apunta a él («consulta siempre X»).
Cómo leer: cada OS (a la izquierda) tiene un CLAUDE.md corto que apunta (flechas cian) a un archivo de identidad global (centro). ¿Cambió alguna preferencia tuya? Edítala en un solo lugar: todos los OS la heredan.
Por qué aprender
Porque, a medida que pasas de 1 a 5 OS, repetir la identidad se convierte en una pesadilla de mantenimiento. Centralizar lo común en un archivo global es el patrón que mantiene todo coherente y actualizable desde un solo lugar, y además ayuda a mantener cada CLAUDE.md conciso.
Conceptos clave
🧪 Done-check: la prueba del extraño
¿Cómo saber si la identidad está bien? Usa el prueba de la persona ajena: da el CLAUDE.md para alguien que no conoce el proyecto. Si esa persona puede describir para qué sirve el OS e mencionar 1 cosa que rechaza, la identidad pasó. Si queda confusa, falta claridad o sobra ruido.
✅ El done-check en 3 pasos
Entrégale el archivo a alguien desconocido (o a un chat sin tu contexto).
Pregunta: "¿para qué sirve este OS y qué nunca hace?".
¿Acertaste con los dos? Listo. ¿Te equivocaste? Elimina el ruido y deja explícito el propósito.
💡 Truco sin conejillo de Indias humano
Si no tienes a un extraño a mano, pega el CLAUDE.md en un chat nuevo, sin ningún otro contexto, y pide el resumen. El modelo "frío" hace muy bien el papel de desconocido.
Por qué aprender
Porque «está bien» es vago; la prueba del extraño es un criterio objetivo para darlo por listo. Obliga a que la identidad sea clara y autosuficiente, exactamente lo que el /os-coach exige antes de avanzar a la siguiente capa en la Trilha 4.
Conceptos clave
⚡ Práctico: generar un CLAUDE.md conciso
Hora de ponerse manos a la obra. Abajo hay un prompt copy-run listo para pegar en Claude Code (o Codex): te entrevista con 3 preguntas y escribe un CLAUDE.md conciso, por debajo de 30 líneas, con una guía rápida de rechazos. Cambia solo los fragmentos entre <corchetes>.
🎯 Objetivo
Terminar esta sección con un archivo CLAUDE.md real para un dominio tuyo, breve y que supera la prueba del desconocido.
Pega en Claude Code — prompt copy-run
promptVocê é meu engenheiro de OS. Crie o arquivo CLAUDE.md da camada de Identidade para o meu <domínio: ex. Tax OS>. Contexto: - Quem sou eu: <seu nome + papel, 1 linha> - Objetivo do domínio: <o que eu quero poder perguntar/mandar fazer> - Mercado / jurisdição: <onde opero, ex. Ontário/Canadá> - Serve a: <só a mim | um time com papéis X, Y> - Sempre ver: <formato/tom preferido> - Nunca ver: <o que me irrita> Regras de escrita (obrigatórias): 1. Máximo de 30 linhas. Corte tudo que não muda o comportamento. 2. NÃO cole documentos, leis ou dados brutos — isso é Substrato, não Identidade. 3. Inclua um bloco "Não recusar" com 2-3 itens: tarefas minhas e legítimas neste domínio em que você deve prosseguir sem pedir confirmação (nunca para burlar segurança nem mexer em dados de terceiros). 4. Antes de escrever, faça no máximo 3 perguntas se algo essencial faltar. 5. Ao final, rode o "teste do estranho": resuma, em 2 frases, para que serve este OS e 1 coisa que ele recusa. Se não couber, encurte o arquivo. Escreva o arquivo em ./CLAUDE.md e me mostre o conteúdo.
✔️ Cómo verificar
- 1.Abre el CLAUDE.md generado y cuenta las líneas: debe tener ≤ 30.
- 2.Confirma que existe un bloque "No rechazar" con tareas tuyas y legítimas.
- 3.Pega el archivo en un chat nuevo y pide un resumen: debe acertar el propósito y 1 rechazo (prueba del extraño).
- 4.¿No hay ningún documento, ley o tabla pegado dentro? Si lo hay, pide que lo muevan al Sustrato.
Por qué aprender
Porque leer sobre identidad no sustituye escribir una. Este prompt convierte los 7 temas anteriores en un artefacto real en minutos, y el mismo patrón (entrevistar → escribir → done-check) es lo que el /os-coach automatiza en la Trilha 4.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
2.2 — Sustrato y Contexto: el camión de basura en llamas 🗑️🔥