🧱 Técnica I — la base del OS
Las tres capas de fundación, el "back of house" de tu OS: Identidad (el archivo-alma), Sustrato y contexto (el camión de basura en llamas) y Reglas y ganchos (las cercas). Sin esta base estática, los agentes no tienen dónde apoyarse.
Cómo leer: la base se construye de arriba abajo en cuanto a comprensión, pero se apila como cimiento: Identidad, Sustrato y Reglas forman el suelo estable (en azul) sobre el que se apoyarán las capas de acción (en cian, atenuadas: Trilha 3). Esta trilha cubre solo los fundamentos.
Mapa de la ruta
Contenido detallado
🪪 Identidad — el archivo del alma (CLAUDE.md)
El primer archivo que lee el OS. Quién es, a quién sirve, qué nunca rechaza: conciso, con menos de 30 líneas y una guía práctica de generación al final.
La capa de Identidad vive en el CLAUDE.md — el primer archivo que lee el harness, antes de cualquier tarea.
Es la pieza que más cambia el comportamiento con menos esfuerzo; un buen archivo acierta el tono desde el principio.
Archivo esencial · leído 1.º · Markdown · define el tono.
Tú, el negocio, el mercado, los eventos actuales, las preferencias y lo que siempre o nunca debes ver. Los datos en bruto NO se incluyen.
Mezclar identidad con sustrato infla el archivo; conocer el límite mantiene la esencia breve.
Contexto estable · siempre/nunca · identidad ≠ datos.
Mantener el archivo por debajo de ~30 líneas y eliminar todo lo que no cambie el comportamiento cada vez.
Una identidad inflada diluye la señal y consume la atención del modelo; que sea breve es una decisión de diseño.
< 30 líneas · cortar hasta que duela · señalar > pegar.
Si el OS está al servicio de un equipo, la identidad incorpora funciones, responsabilidades y límites para cada rol.
El mismo dominio genera identidades diferentes según el público; define desde el principio «tú o equipo».
A quién sirve · roles · límites por rol.
Una hoja de referencia que indica cuándo el OS debe darte el beneficio de la duda en tus tareas legítimas.
Los modelos se vuelven más evaluadores; anticipar los rechazos evita fricciones en cada sesión.
Cheat sheet · beneficio de la duda · solo lo legítimo.
Un archivo global con lo que es común para ti; cada OS indica «consulta siempre X» en vez de repetirlo.
A medida que pasas de 1 a 5 OS, centralizar lo que tienen en común evita la pesadilla del mantenimiento.
Archivo global · apuntar, no copiar · 1 punto de edición.
Un desconocido lee el CLAUDE.md y describe el propósito del OS + 1 cosa que rechaza.
"Está bien" es vago; la prueba del desconocido es un criterio objetivo para darlo por terminado.
Prueba de lo extraño · describe el propósito · chat en frío.
Un prompt listo que te entrevista con 3 preguntas y escribe un CLAUDE.md conciso, con una guía rápida de rechazos.
Leer sobre identidad no reemplaza escribir una; el prompt se convierte en un artefacto real en minutos.
Copy-run · entrevista > volcado · done-check integrado.
🗑️🔥 Substrato y Contexto — el camión de basura en llamas
Del caos de 500–5.000 archivos a los nuggets inyectables: organiza antes de usar la IA, recoge el conocimiento tácito y destila con un modelo workhorse.
Empiezas con entre 500 y 5.000 archivos caóticos de distintos tipos; el Substrato transforma el caos en una referencia.
La mayoría conecta la IA sobre el caos y se frustra; aceptar y tratar el caos con método es lo que marca la diferencia.
Sustrato vs. contexto · 500–5.000 archivos · diseño.
Mini ingeniería de datos: separa por tipo de archivo y después por antigüedad (reciente vs. antiguo).
La calidad del OS está limitada por la del Sustrato; organizar primero multiplica todo lo que viene después.
Mini ing. de datos · por tipo · por antigüedad.
Recopilar lo que falta para crear al especialista ideal — de YouTube, expertos, leyes, abogados.
Lo que ya tienes rara vez es suficiente; el harvesting cierra la brecha a propósito.
Harvesting · especialista de tus sueños · fuentes externas.
El conocimiento práctico, rara vez escrito: atajos, excepciones, «lo que sale mal» — que el modelo genérico no tiene.
Es el conocimiento tácito que hace que el OS parezca especialista y no chatbot; es la prueba de lo no genérico.
Tácito vs. explícito · excepciones · no genérico.
Reunir fuentes en un compendium.md (referencia destilada) y playbooks (cómo hacer X).
Es el formato en el que el conocimiento se vuelve utilizable; un buen playbook es casi una Skill.
Compendio · playbook · pregunta-objetivo (done-check).
Carpeta raw/ (sin procesar, guardado) frente a synthesized/ (nuggets). Inyecta solo los nuggets.
Es el patrón que se repite en todo dominio; inyectar lo crudo desborda la ventana y encarece.
raw/ · synthesized/ · despensa vs. plato listo.
Un modelo económico (p. ej., Gemini Flash) que recorre todos los archivos en un bucle para destilar nuggets.
Destilar a mano no escala y usar el modelo de primera línea es un desperdicio; la combinación de bajo costo + loop hace viable el volumen.
Workhorse · en bucle · humano en el bucle.
Prompt que barre raw/ con el workhorse y escribe un nugget por archivo en synthesized/.
Es el corazón operativo del Substrato; generalizado, se convierte en la skill "knowledge harvester".
raw/ intacto · 1 nugget/archivo · compendium.md.
🚧 Reglas y ganchos — las barreras
Regla = sugerencia firme; gancho = determinístico. Reflex hooks, settings.json con denegación de escritura, pre-commit de PII y la verificación final del peor error.
Una sugerencia firme para el modelo: el letrero de «no entrar». No es determinista: puede fallar.
Saber qué regla es «flexible» calibra la confianza y reserva los ganchos para lo que no puede fallar.
Regla · no determinista · útil para preferencias.
La puerta cerrada: siempre lo hace o nunca lo permite, sin depender del juicio del modelo.
La PII, el dinero y las operaciones bancarias no pueden depender de que el modelo lo «recuerde».
Gancho · siempre/nunca · donde duele.
Mover las líneas "siempre/nunca" de CLAUDE.md demasiado grande para una carpeta rules/.
La base crece sin volverse un desorden: identidad concisa, reglas auditables.
Graduar · always/never · mover > duplicar.
Un mecanismo que se activa al instante: ¿se subió PII (SIN, tarjeta) a GitHub? Acción bloqueada de inmediato.
Los errores más costosos son silenciosos; el reflejo convierte «espero que no» en «no puede pasar».
Reflex hook · PII · reflejo > memoria.
Prohibir comandos de escritura de Bash (p. ej., nunca escribir en una tabla), salvo override explícito.
Es donde "nunca escribas aquí" deja de ser texto y se convierte en una regla de máquina: alto rendimiento.
settings.json · permissions.deny · salvo override.
Un verificador que se ejecuta antes de cada commit y bloquea el envío si encuentra PII.
Un backup sin protección es una puerta para las filtraciones; el pre-commit te permite versionar con tranquilidad.
Pre-commit · bloquea el commit · + .gitignore.
Nombra el peor error del dominio, escríbelo como una regla clara de nunca hacer y refuérzala con 1 reflejo determinista.
Criterio accionable en 5 minutos: la pregunta adecuada, en la dosis adecuada (texto + gancho).
Peor error · regla de nunca hacer · doble cerco.
Un settings.json listo, que deniega comandos de escritura y agrega un hook PreToolUse (exit 2 bloquea).
Transforma la teoría de las cercas en protección real, en minutos: el «1 reflejo» del done-check.
permissions.deny · PreToolUse · exit 2 · override.