🏛️ La arquitectura (4 Cs)

Qué es

Una sesión nueva de Claude debe responder "¿qué hace este negocio y quién trabaja aquí?" sin navegar por ningún archivo. Si no responde con precisión, no hay Context configurado.

Por qué aprender

Context es el punto de partida de todo resultado. Sin él, Claude responde de forma genérica: útil para cualquier empresa, específico para la tuya.

Conceptos clave

Sesión nueva: nueva ventana sin historial. Prueba de identidad: nombre, rol, principal problema. Baseline: lo que existe antes de construir.

Qué es

Tres archivos: about-me.md (identidad, rol, top_pain), about-business.md (oferta, ICP, modelo de ingresos), priorities.md (prioridades de 90 días). Hechos interpretados — no un volcado de documentos.

Por qué aprender

Estos tres archivos se cargan en cada sesión. Definen el "personaje" de Claude para tu contexto específico. Sin ellos, cada conversación empieza desde cero.

Conceptos clave

ICP: Perfil del cliente ideal. top_pain: el dolor más frecuente del operador. Hechos interpretados: lo que significa ese dato para el negocio, no el dato bruto.

Qué es

Archivo en la raíz del proyecto, cargado automáticamente por Claude Code. Documenta: quién eres, cómo piensas (3 Ms), dónde están las cosas en el proyecto y cómo trabajar contigo. Lo completa el /onboard.

Por qué aprender

El CLAUDE.md es el "briefing permanente" de tu asistente. Reduce a cero el trabajo de darle contexto en cada sesión: Claude ya sabe dónde está y qué esperas de él.

Conceptos clave

Canónico: una única fuente de verdad. Carga automática: Claude Code lee CLAUDE.md automáticamente al abrir el proyecto. /onboard: skill que completa el archivo el Día 1.

Qué es

Muestras de tu voz real pegadas literalmente en el archivo; nunca descritas ni escritas en el chat. La instrucción para Claude: "Imita este registro; no finjas mi voz en contenido externo sin mostrármelo antes."

Por qué aprender

Describir tu voz en el chat es contaminar el proceso — Claude interpreta la descripción, no aprende el patrón real. Las muestras textuales enseñan con ejemplos. Los resultados de contenido se vuelven indistinguibles de tu estilo.

Conceptos clave

Verbatim: copia literal, sin editar. Contaminación: el riesgo de que Claude imite una descripción, no la voz real. Few-shot: técnica de aprendizaje mediante ejemplos concretos.

Qué es

Registro append-only de decisiones estratégicas. Formato estándar: fecha · Decisión · Por qué · Alternativas consideradas · Owner. El «por qué» es el campo más importante: sin él, el registro no tiene valor.

Por qué aprender

Las decisiones sin contexto generan debates repetidos. El registro permite que Claude entienda el razonamiento anterior y evite contradicciones. También es un registro de auditoría para /audit.

Conceptos clave

Solo para agregar: nunca edita entradas antiguas, solo agrega. Registro de auditoría: rastro verificable de decisiones. Owner: responsable de la decisión.

Qué es

Frameworks, SOPs, guías de API, voz. La regla: solo los hechos interpretados van aquí — lo que ese dato significa para el negocio, no el dato sin procesar. El wiki NO es un depósito de documentos.

Por qué aprender

El conocimiento interpretado acelera las sesiones futuras. Claude no necesita deducir el significado de un dato: ya está documentado. Las referencias de API guardadas aquí evitan tener que volver a investigar cada vez.

Conceptos clave

SOP: Procedimiento operativo estándar. Hecho interpretado: dato + significado. Investigado una vez, guardado para siempre: principio de no volver a investigar lo que ya se descubrió.

Qué es

"¿Qué tengo en la agenda mañana y qué tareas vencen?" → Claude responde con datos en tiempo real, sin pegar manualmente. Si tuviste que pegar, no hay Connections.

Por qué aprender

Las conexiones en vivo eliminan el ciclo manual de copiar y pegar datos en el chat. AIOS se vuelve proactivo porque tiene acceso a la información sin intervención.

Conceptos clave

Dato en vivo: leído directamente de la fuente, no copiado. Pega: antipatrón — indica que no hay una conexión real. Lectura vs. escritura: conexión que lee vs. que también escribe.

Qué es

Los 7 dominios esenciales: (1) Ingresos/Finanzas · (2) Interacciones con clientes · (3) Calendario · (4) Comunicación · (5) Proyectos/tareas · (6) Inteligencia de reuniones · (7) Conocimiento/archivos. Todo negocio tiene equivalentes.

Por qué aprender

/audit puntúa Connections según la cobertura de estos dominios. Conocerlos ayuda a priorizar qué conexiones construir primero: empieza por los dominios con mayor apalancamiento.

Conceptos clave

Nivel 1: dominios presentes en cualquier negocio, independientemente del sector. Cobertura: cuántos de los 7 están conectados. Apalancamiento: impacto de agregar cada dominio.

Qué es

Cuatro mecanismos para conectar sistemas: mcp (servidor MCP) · script (Python/Bash que consulta la API) · export (volcado CSV/JSON) · key+ref (clave .env + documentación de la API). El kit prioriza la API; la auditoría no prefiere MCP.

Por qué aprender

No hay una única manera de conectar. MCP es conveniente, pero no obligatorio: un script Python que consulta una API es igualmente válido. Lo importante es que los datos sean accesibles.

Conceptos clave

MCP: Model Context Protocol. API-first: preferir la API directa a las automatizaciones frágiles. .env: archivo de variables de entorno para claves de API.

Qué es

Tabla con columnas: # · Dominio · Tool · Mecanismo · Auth · Última verificación. Una fila por sistema conectado. Es el inventario de Connections de tu AIOS.

Por qué aprender

Sin un registro, no sabes qué está conectado. /audit lee connections.md para calcular el puntaje de Connections. Un registro completo garantiza que no se olvide ningún dominio.

Conceptos clave

Inventario: lista auditable de sistemas. Autenticación: método de autenticación (API key, OAuth). Actualidad: cuándo se verificó por última vez.

Qué es

Al conectar una API, guarda references/{tool}-api.md con endpoints, auth y las consultas principales. /audit recompensa esto; las futuras skills no vuelven a investigar.

Por qué aprender

Investigar una API consume tiempo. Si guardas lo que descubriste, cada uso futuro de ese sistema comienza donde te quedaste — sin volver a investigar la documentación, los endpoints ni los formatos de autenticación.

Conceptos clave

API ref doc: documento de referencia de endpoints. Endpoints: URLs de la API con parámetros. Compounding: cada conexión documentada agiliza las siguientes.

Qué es

Al menos una conexión debe ESCRIBIR — enviar un correo, publicar, crear una tarea. Si todo es de solo lectura, AIOS es un visor, no un OS.

Por qué aprender

Leer sin escribir es monitoreo pasivo. Un OS actúa. La capacidad de escribir (enviar, crear, actualizar) es lo que diferencia un panel de un operador.

Conceptos clave

Solo lectura: solo lee datos, no los modifica. Write permission: autorización para crear/actualizar/eliminar. OS vs. panel: distingue el sistema operativo de un simple dashboard.

Qué es

Jerarquía de confiabilidad de integración: API directa (más confiable) > CLI > automatización del navegador > scraping (más frágil). Prefiere siempre el nivel más confiable disponible.

Por qué aprender

El scraping falla cuando cambia el diseño. La automatización del navegador falla cuando cambia la interfaz. Las APIs son contratos estables; cuando están disponibles, siempre son preferibles. Conocer la jerarquía evita integrar por el escalón equivocado.

Conceptos clave

Integration Ladder: modelo de decisión del mecanismo. Confiabilidad: probabilidad de que funcione mañana. Contrato de API: interfaz estable y versionada.

Qué es

Una frase corta activa un workflow de varios pasos que produce un artefacto concreto. Si necesitas cinco mensajes para explicar lo que quieres antes de recibir algo útil, no hay ninguna Capability configurada.

Por qué aprender

Capabilities es el índice de automatizaciones de tu AIOS. Cada skill es una acción empaquetada que cualquier miembro del equipo puede activar con una frase natural.

Conceptos clave

Artefacto: resultado concreto (documento, correo electrónico, análisis). Workflow: secuencia de pasos con un resultado definido. Trigger natural: frase en lenguaje común que activa la skill.

Qué es

Skill = SKILL.md con frontmatter (activador + instrucciones paso a paso). Agent = subasistente de varios pasos con contexto propio y un modelo más económico. Primero Skills; los agents son para cuando las Skills no bastan.

Por qué aprender

Los Agents son más complejos y costosos de mantener. Las Skills son simples, predecibles y fáciles de depurar. La regla es empezar por lo más sencillo que resuelva el problema.

Conceptos clave

Frontmatter: metadatos YAML al inicio de SKILL.md. Subasistente: Claude ejecutándose en un contexto separado. Contexto propio: aislamiento de la sesión principal.

Qué es

Tres skills incluidas: /onboard (configuración del Día 1), /audit (diagnóstico Four-Cs), /level-up (publica 1 automatización por semana). Deliberadamente concisas — tú construyes sobre ellas.

Por qué aprender

Estas tres skills cubren el ciclo de vida básico de AIOS: configurar, medir y evolucionar. Entender qué hace cada una te orienta sobre dónde agregar primero tus propias capabilities.

Conceptos clave

/onboard: completar el CLAUDE.md. /audit: diagnóstico y puntaje 0-100. /level-up: ciclo semanal de entrega de automatización.

Qué es

Frontmatter con name e description (cuándo activarlo) + cuerpo con ejecución paso a paso. Localización: .claude/skills/<nome>/SKILL.md.

Por qué aprender

Conocer la anatomía permite crear skills nuevas desde cero sin depender de skill-creator. Claude Code usa el frontmatter para decidir cuándo invocar la skill automáticamente.

Conceptos clave

name: identificador de la skill. description: disparador semántico: cuándo debe usarla Claude. cuerpo: instrucciones paso a paso para la ejecución.

Qué es

Orden de preferencia Boring-is-Beautiful: prompt guardado → skill determinística (script, sin IA) → skill asistida por IA (1 llamada) → sub-agent (último recurso). Usa siempre el nivel más simple que funcione.

Por qué aprender

La IA es poderosa, pero no es la solución más sencilla para todo. Un script que se ejecuta siempre de la misma manera es más confiable que una llamada a un LLM. Aburrido = predecible = operativo.

Conceptos clave

Determinístico: mismo input → mismo output siempre. Asistido por IA: usa LLM para razonar. Boring-is-beautiful: principio de preferir soluciones simples y confiables.

Qué es

Cada ejecución de /level-up produce 1 artefacto (skill o automatización). Usa skill-creator (Anthropic) o escribe el SKILL.md a mano. Todo artefacto empieza con bike-method-phase: 1.

Por qué aprender

/level-up es el motor de crecimiento de AIOS. Una automatización por semana = 52 automatizaciones al año. Empezar en la fase 1 garantiza un alcance pequeño y una entrega segura.

Conceptos clave

bike-method: metodología de entrega incremental. phase 1: alcance mínimo viable. skill-creator: herramienta de Anthropic para generar SKILL.md.

Qué es

Cuando el trabajo exige razonamiento + uso repetible de herramientas. Los sub-agents se ejecutan en su propio contexto para mantener despejada la sesión principal. Ubicados en .claude/agents/.

Por qué aprender

Los Agents aíslan el trabajo complejo del contexto principal. Esto evita que un análisis largo consuma tokens de la sesión del operador. Son el nivel máximo de autonomía: úsalos con criterio.

Conceptos clave

Contexto propio: sesión de Claude aislada. Modelo más barato: los agents pueden usar modelos más pequeños. Haiku para agentes: menor costo para tareas repetitivas.

Qué es

Laptop cerrada. Llega un brief a la bandeja de entrada. Un colega pregunta y recibe una respuesta real. Si esto ocurre sin que lo hayas iniciado manualmente, hay Cadence. Si tuviste que abrirlo y ejecutarlo, no la hay.

Por qué aprender

Cadence es el nivel en el que el AIOS deja de ser una herramienta y empieza a ser un sistema operativo de verdad: autónomo en su ritmo, no solo en su respuesta.

Conceptos clave

Proactivo: actúa sin que se lo pidan. Reactivo: responde cuando lo llaman. Cadencia: ritmo regular y autónomo de operación.

Qué es

Hooks en .claude/settings.json, o skills nombradas con un prefijo de frecuencia: daily-* / weekly-* / monthly-* / morning-* / standup.

Por qué aprender

Los triggers son la infraestructura de Cadence. Sin ellos, toda automatización es manual: tienes que recordar ejecutarla. Con triggers, el sistema sabe cuándo actuar.

Conceptos clave

Hook: evento que activa la ejecución. settings.json: archivo de configuración de hooks de Claude Code. Prefijo de frecuencia: convención de nomenclatura para skills recurrentes.

Qué es

El ancla del kit no es cron: es el ritual: /audit semanal (Día 7) + /level-up todos los viernes. El comportamiento crea el hábito; la infraestructura es secundaria.

Por qué aprender

Los sistemas de cron sin hábito se abandonan. Los rituales crean el ciclo de retroalimentación que mantiene el AIOS en evolución. El /audit cada semana es lo que hace subir la puntuación.

Conceptos clave

Ritual: acción repetida con intención y regularidad. Cron: programador automático. Ciclo de retroalimentación: medir → ajustar → repetir.

Qué es

Grafo de dependencias completo: Context (base) → Connections + Capabilities (en paralelo) → Cadence (cima). No automatices workflows que no funcionan manualmente. La automatización amplifica, no corrige.

Por qué aprender

Automatizar un proceso deficiente crea más problemas y más rápido. Validarlo manualmente primero garantiza que lo que se automatizará ya funciona; así, la automatización solo lo acelera.

Conceptos clave

Grafo de dependencias: orden obligatoria de construcción. Amplificación: la automatización escala lo que existe, para bien o para mal. Primero manual: validar antes de automatizar.

Qué es

Tres señales de que el AIOS cambió tu forma de trabajar: (1) El equipo se comunica contigo — tus colegas te buscan como referente de IA. (2) Reducción del cambio de contexto — menos cambios de contexto mental. (3) El conocimiento sale de tu cabeza — el conocimiento sale de tu cabeza y pasa al sistema.

Por qué aprender

Los KPIs son fáciles de manipular. Las experiencias son difíciles de falsificar. Estas tres señales muestran que AIOS generó un cambio real de comportamiento, no solo automatizaciones en el papel.

Conceptos clave

El equipo se comunica contigo: reconocimiento externo de competencia. Cambio de contexto: costo cognitivo de cambiar de tarea. Externalización del conocimiento: convertir lo tácito en explícito.

Qué es

Cuando los indicadores aparecen para una persona, la misma arquitectura de datos escala: dashboards, automatizaciones, implementación para el equipo. Una empresa donde cada operador ejecuta un AIOS personal es una empresa realmente preparada para la IA.

Por qué aprender

El AIOS individual no es un proyecto personal aislado: es el prototipo de lo que la empresa puede llegar a ser. Dominar los 4 Cs a nivel individual es la base para escalar a nivel organizacional.

Conceptos clave

AI-ready: estructura preparada para adoptar y escalar la IA. Implementación: expansión del modelo a todo el equipo. Arquitectura replicable: patrón que pueden aplicar varias personas.