Contenido detallado
🧪 La prueba de contexto
Existe una prueba sencilla y contundente para saber si tu Context funciona: abre una sesión de Claude completamente nueva y pregunta "¿a qué se dedica este negocio y quién trabaja aquí?". Si Claude responde sin navegar por ningún archivo externo, tienes Context. Si no responde, no lo tienes, independientemente de cuántos documentos haya en otros lugares.
Abrir una sesión nueva
Sin historial. Sin archivos abiertos manualmente. Claude Code lee automáticamente solo lo que está en el proyecto mediante CLAUDE.md y context/.
Preguntar sin pistas
Frase exacta de la prueba:
Evaluar la respuesta
Una respuesta con nombres, servicios y funciones reales = Contexto funcional. Una respuesta vaga («es una empresa de tecnología...») = Contexto insuficiente o inexistente.
💡 Por qué importa una «sesión nueva»
En una sesión existente, Claude ya tiene contexto acumulado en la ventana. La prueba solo sirve en una sesión nueva porque replica el estado real de una automatización, un agente o un colaborador nuevo que entra en tu AIOS por primera vez. Es la prueba de fuego honesta.
📁 La carpeta context/
La carpeta context/ es el corazón de tu AIOS. Contiene los tres archivos que definen quién eres, qué vendes y en qué estás enfocado. No es un volcado de documentos: son hechos interpretados, escritos con la voz de alguien que conoce el negocio.
✓ Hechos interpretados
- ✓"Vendemos consultoría de producto para scale-ups B2B SaaS"
- ✓"Mi top_pain es un ciclo de ventas largo (promedio de 45 días)"
- ✓"Q3 2026: cerrar 3 nuevos clientes enterprise"
- ✓Redactado como un briefing para alguien que no te conoce
✗ Volcado de documentos
- ✗Pegar la presentación de pitch completa (50 diapositivas)
- ✗Contratos de clientes o NDA como "contexto"
- ✗Historial completo de correos de ventas
- ✗Notes/misc/inbox como «archivos de contexto»
⚡ Regla de oro
Si no puedes escribir el archivo about-business.md en menos de 30 minutos, el problema no es la falta de información, sino la falta de claridad sobre el propio negocio. El proceso de escribir es el diagnóstico.
📋 CLAUDE.md — Manual de Operación
O CLAUDE.md queda en la raíz del proyecto y es canónico: es el único archivo que Claude Code lee automáticamente en cada sesión. Funciona como un manual de operación: quién eres, cómo piensas (3 Ms), dónde están las cosas y cómo trabajar contigo. Lo completa /onboard.
📊 Por qué tener un solo CLAUDE.md
- Canonicidad — sin conflictos de versiones entre carpetas
- Carga garantizada — Claude Code lo lee automáticamente
- Mantenimiento sencillo — un lugar para actualizar
- Revisión trimestral — cadencia natural y predecible
🚫 Qué NO incluir
- Credenciales o claves de API
- Contenido sensible de clientes
- CLAUDE.md anidado en subcarpetas
- Información duplicada de context/
💡 Consejo práctico
Ejecuta /onboard para generar el primer CLAUDE.md: la skill guía 7 preguntas y arma todo automáticamente. Para futuras actualizaciones, edítalo directamente o vuelve a ejecutarla (idempotente). Revisión recomendada: cada trimestre o cuando cambie el enfoque estratégico.
🎙️ references/voice.md — La regla de la voz
O references/voice.md guarda muestras reales de tu escritura, pegadas textualmente, nunca escritas durante una conversación. Es el archivo que evita que Claude invente un «tono profesional genérico» cuando genera contenido en tu nombre.
⚠️ La única regla que no se flexibiliza
Las muestras de voz deben ser pegadas literalmente de algo que hayas escrito de verdad — un email real, una publicación publicada, un mensaje de Slack. Nunca escritas en el chat durante la conversación con Claude.
✓ Buenas muestras de voz
- ✓Correo de seguimiento de ventas enviado
- ✓Publicación publicada en LinkedIn sin una edición exhaustiva
- ✓Mensaje de Slack para el equipo (tono informal)
- ✓Fragmento de una propuesta comercial escrita por ti
✗ Muestras que no sirven
- ✗Texto generado por IA y revisado por ti
- ✗Descripción de cómo escribes («soy directo…»)
- ✗Texto escrito durante la conversación con Claude
- ✗Publicación editada ampliamente por un redactor externo
📌 Instrucción predeterminada en voice.md
Siempre que generes contenido externo, incluye al final del archivo:
Esto protege tu reputación cuando Claude genere borradores autónomos mediante Cadence.
📝 decisions/log.md — Registro de Decisiones
O decisions/log.md es el registro append-only de decisiones y sus motivos. No es una lista de tareas pendientes ni un diario: es la memoria institucional del razonamiento que sustentó cada decisión relevante de tu AIOS y de tu negocio.
🔑 La prueba decisiva del AIS-OS
"Mientras no estás en tu puesto, tu AIS-OS observa un evento real y produce un resultado más rápido y preciso de lo que tú producirías."
El decisions/log.md es lo que garantiza que el AIOS reproduzca tu razonamiento, no solo tus tareas. Sin registrar el porqué, cada nueva sesión empieza desde cero.
Solo para agregar; nunca borrar
El valor del registro aumenta con el tiempo. Las decisiones antiguas explican por qué el sistema está configurado de determinada manera. Si lo eliminas, pierdes el contexto histórico que necesitarás cuando algo falle.
Generado también por /level-up
La skill /level-up crea una entrada en decisions/log.md cada vez que defines el alcance de una nueva automatización: fecha, decisión, motivo, alternativas y responsable. No tienes que escribirla manualmente cada vez.
⚡ Cuándo registrar una decisión
Toda decisión que no es obvia o que quieras explicarle a alguien (incluido a ti mismo dentro de 3 meses). Regla práctica: si dudaste entre dos opciones durante más de 30 segundos, regístralo. Si cambiaste de enfoque a mitad de camino, regístralo con el motivo del cambio.
📚 references/ — Conocimiento Interpretado
La carpeta references/ guarda conocimientos que Claude necesita para trabajar contigo: frameworks que usas, guías de API de herramientas conectadas y SOP de tu proceso. Es el wiki operativa, no un depósito de documentos sin procesar.
✓ Qué va en references/
- ✓Guía de API que investigaste una vez (investigada-una-vez-guardada-para-siempre)
- ✓SOP de un proceso recurrente que otros replican
- ✓Framework externo que aplicas (ej.: puntuación ICE)
- ✓Glosario de términos internos de tu negocio
✗ Qué NO va en references/
- ✗Dump de emails o hilos de Slack
- ✗Documentos legales o contractuales de clientes
- ✗Notas personales sin procesar (misc, inbox)
- ✗Carpetas dentro de carpetas sin motivo (carpeta-de-carpeta-de-carpeta)
🔁 Principio: investigar una vez y guardar para siempre
Al conectar una herramienta nueva, dedica 30 minutos a crear references/{tool}-api.md con endpoints, auth y 3 consultas de ejemplo. /audit recompensa esto; las futuras skills no vuelven a investigar lo que ya descubriste.
references/notion-api.md
references/hubspot-api.md
🧭 Context no se puede omitir — por diseño
En el grafo de dependencias de los 4 Cs: Context va primero, siempre. Connections + Capabilities pueden desarrollarse en paralelo, pero Cadence (automatizaciones recurrentes) solo tiene sentido después de que el Context esté consolidado.
Si Context está vacío, AIOS está volando a ciegas. Una automatización de Cadence sin Context produce resultados genéricos, a veces peores que nada.
✅ Resumen del módulo
Próximo módulo: 2.2 — Connections
Con el Context en su lugar, AIOS sabe quién eres. Ahora es hora de enseñarle qué tienes y dónde está — conectando las herramientas que forman parte de tu día.