Contenido detallado
🧪 La prueba de conexiones
Existe una prueba sencilla y contundente para saber si tu AIOS tiene Connections reales: haz una pregunta que requiera dato en tiempo real. No un dato que pegaste en el chat: un dato que el sistema debe buscar por sí solo. Si obtienes la respuesta sin copiar nada, tu Connections funciona.
🎯 La prueba en 1 frase
"¿Qué tengo en la agenda mañana y qué tareas vencen?" — si esa respuesta llega sin pegar, tienes Connections.
- • Dato pegado = todavía haces el trabajo manual de búsqueda.
- • Dato en vivo = AIOS accede al sistema, busca y responde. Tú solo lees.
- • La prueba sirve para cualquier ámbito: finanzas, tareas, comunicación, reuniones.
✓ Connections reales
- ✓"¿Qué vence hoy?" → búsqueda automática
- ✓Resumen de correos → MCP o script
- ✓Próxima reunión + agenda → Calendario API
- ✓Ingresos del mes → Financeiro API
✗ Falso Connections
- ✗Copiar la reunión de Google Cal y pegarla en el chat
- ✗Exportar el CSV manualmente y cargarlo en el contexto
- ✗Escribir en el prompt las tareas que vencen
- ✗Hacer que AIOS pregunte "envíame los datos"
🗺️ Los 7 Dominios Tier-1 Universales
Todo trabajo de conocimiento pasa por 7 dominios. Se llaman Universales de nivel 1 porque aparecen independientemente del sector: agencia, SaaS, consultoría, freelance. Cubrirlos es la base de un AIOS funcional.
📋 Mapa de los 7 dominios — qué cubrir antes que cualquier otra cosa
| # | Dominio | Qué incluye | Ejemplos de herramientas |
|---|---|---|---|
| 1 | 💰 Ingresos/Finanzas | Ingresos, gastos, flujo de caja | Stripe, QuickBooks, Notion finance |
| 2 | 🤝 Interacciones con el cliente | Leads, deals, soporte, comentarios | HubSpot, Pipedrive, Intercom, comentarios de Linear |
| 3 | 📅 Calendario | Agenda personal, reuniones, fechas límite | Google Calendar, Calendly, calendario de Notion |
| 4 | 💬 Comunicación | Correo, chat, DMs, notificaciones | Gmail, Slack, Discord, comentarios de Linear |
| 5 | ✅ Proyectos/Tareas | Tareas pendientes, sprints, backlog, entregables | Linear, Notion, Asana, Trello |
| 6 | 🎙️ Inteligencia de reuniones | Transcripciones, tareas pendientes, grabaciones | Fireflies, Otter, reuniones de Notion |
| 7 | 📁 Conocimiento/Archivos | Docs, wikis, SOPs, base de conocimientos | Notion, Drive, Confluence, Obsidian |
💡 Consejo práctico — Empieza por el dominio que más te afecta
No intentes conectar los 7 de una vez. Identifica qué dominio consume más tiempo en búsquedas manuales durante tu día. Ese es el primero que debes conectar. /audit puntúa la cobertura de los 7 dominios: 0 dominios = multiplicador de 4x en la penalización del score.
⚙️ Los 4 mecanismos (agnósticos de la herramienta)
El kit AIS-OS es API-first y agnóstico: sin importar qué herramienta uses, hay 4 maneras de hacer que AIOS acceda a un sistema. Cada mecanismo implica ventajas y desventajas en confiabilidad, configuración y mantenimiento.
| # | Dominio | Herramienta | Mecanismo | Autenticación | Última revisión |
|---|---|---|---|---|---|
| 1 | Calendario | Google Calendar | mcp | OAuth | 2026-06-01 |
| 2 | Comunicación | Gmail | script | OAuth | 2026-05-28 |
| 3 | Proyectos | Linear | key+ref | .env API_KEY | 2026-05-15 |
| 4 | Conocimiento | Notion | exportación | CSV dump | 2026-05-01 |
Una línea por sistema accesible. Manténlo actualizado — /audit lee este archivo.
Los 4 mecanismos — del más al menos integrado
mcp — Servidor MCP
Mayor integración · configuración más compleja · bidireccional
Claude Code se conecta directamente al servidor MCP de la herramienta. Lectura y escritura en tiempo real. Requiere configuración en .claude/settings.json. Es el mecanismo preferido cuando está disponible.
script — Python/Bash que consulta una API
Alta flexibilidad · API-first · tú tienes el control
Scripts Python o Bash que llaman a la API REST de la herramienta. Se almacenan en scripts/. Bueno cuando no existe MCP. Lo versionas, pruebas y adaptas.
key+ref — Clave .env + references/{tool}-api.md
Ligero · rápido de configurar · buena base para futuras skills
API key en el .env + guía de referencia en references/{tool}-api.md. El AIOS lee la guía y arma las llamadas. El patrón de investigado una vez y guardado para siempre.
exportación — volcado CSV/JSON
Más manual · sin integración continua · punto de partida
Exportar manualmente y ponerlo en el contexto. Es válido para el Día 1, cuando la API es compleja. Pero atención: los datos quedan obsoletos rápidamente. Úsalo como punto de partida, no como destino final.
📋 connections.md — el registro central
O connections.md es el manifiesto de integraciones de tu AIOS. Una línea por cada sistema accesible. El /audit lee este archivo directamente para puntuar la cobertura de los 7 dominios y verificar la vigencia de las conexiones.
📌 Campos obligatorios por fila
- # Número — secuencia simple. No tiene otro significado que el orden.
- Dominio Uno de los 7 Tier-1 (o subdominio personalizado tuyo).
- Herramienta Nombre exacto de la herramienta (Gmail, Notion, Linear…).
- Mecanismo mcp / script / export / key+ref — cómo funciona la conexión.
- Autenticación OAuth / API Key / .env / sin autenticación. No pongas claves aquí, solo el tipo.
- Última revisión Fecha de la última vez que se probó/validó la conexión. /audit penaliza una freshness deficiente.
✓ connections.md correcto
- ✓Una línea por herramienta, simple
- ✓Mecanismo completado (mcp/script/export/key+ref)
- ✓Fecha de revisión actual (menos de 30 días)
- ✓7 dominios representados
✗ Errores comunes
- ✗Poner claves de API en el archivo (va a git)
- ✗Dejar «Última revisión» en blanco
- ✗No registres conexiones del tipo export (suman puntos)
- ✗Solo lectura (ver Tema 6)
💾 Investiga una vez, guarda para siempre
Cada vez que investigas cómo funciona una API —endpoints, autenticación, queries—, estás invirtiendo tiempo de investigación. Guarda esta inversión en references/{tool}-api.md es el patrón "investigado-una-vez-guardado-para-siempre": investigas una vez y todos los usos futuros —ya sean tuyos, de una skill o de un agente— son instantáneos.
📊 Por qué esto importa tanto
- Las skills futuras no vuelven a investigar — La skill lee references/{tool}-api.md y ya conoce los endpoints.
- /audit premia eso — La presencia de guías de API en references/ se puntúa directamente en el score de Connections.
- Compounding real — 10 guías de API guardadas = AIOS 10 veces más rápido para cualquier skill nueva que incluya esos sistemas.
- Sin volver a investigar manualmente — Documentaste la API de Linear una vez. Toda skill que usa Linear hereda ese conocimiento.
# Linear API — Guia de Referência ## Base URL https://api.linear.app/graphql ## Auth Header: Authorization: {API_KEY} Var: LINEAR_API_KEY no .env ## Queries mais usadas - Listar issues: query { issues { nodes { id title state } } } - Issues do usuário: query { viewer { assignedIssues { ... } } } ## Mutations - Criar issue: mutation { issueCreate(input: {...}) } - Fechar issue: mutation { issueUpdate(id: "...", input: {stateId: "..."}) } ## Última atualização: 2026-06-01
💡 Consejo — Documenta mientras conectas
Al hacer cualquier conexión nueva (MCP, script o key+ref), abre el archivo references/{tool}-api.md y registra los endpoints que probaste, la autenticación que funcionó y los parámetros más comunes. Te lleva 5 minutos y te ahorra horas en el futuro.
⚖️ Equilibrio entre lectura y escritura
Un AIOS que solo lee es un visualizador sofisticado, no un Operating System. Para ser un OS de verdad, al menos una conexión necesita escribir — enviar un correo, crear una issue, publicar un mensaje, actualizar un registro. La capacidad de actuar en el mundo es lo que diferencia una consulta de una automatización.
🔄 La distinción que importa
- • "¿Qué reunión tengo hoy?"
- • "¿Cuántos issues abiertos hay en Linear?"
- • "¿Cuál fue la receta del mes pasado?"
- • "Resume mis correos no leídos"
Útil, pero todavía tienes que actuar manualmente.
- • Envía el correo de seguimiento
- • Crea el issue en Linear
- • Agenda la reunión
- • Publica la actualización en Slack
AIOS actúa. Tú solo apruebas (o ni siquiera eso).
⚠️ Atención: /audit penaliza que todo sea de solo lectura
Si todas si tus conexiones son de solo lectura, /audit aplica un multiplicador de 2x a la brecha de Connections. Eso por sí solo puede restarle 8-12 puntos a tu score. El requisito es pequeño: 1 conexión con capacidad de escritura ya elimina esa penalización.
💡 Por dónde empezar a escribir
La conexión de escritura más sencilla para la mayoría de las personas: Gmail con permiso para crear borradores. El AIOS crea el borrador: tú lo revisas y lo envías. Cubre el equilibrio de escritura sin riesgo de envío accidental.
A medida que gana confianza: Fase Bike Method = empieza creando borradores, evoluciona al envío con aprobación y luego al envío automático para categorías específicas.
🪜 La escalera de integración
No todas las conexiones son igual de confiables. La Integration Ladder define una jerarquía de confiabilidad: usa el nivel más alto disponible para cada herramienta. Los niveles inferiores se usan cuando los superiores no existen — nunca por preferencia.
🪜 Jerarquía de confiabilidad: API en la cima
Interfaz oficial, versionada y documentada. Responde de forma predecible. Tiene límites de frecuencia claros. No se rompe cuando cambia la interfaz de usuario.
Herramientas como gh (GitHub), gcloud (GCP). Menos granular que la API, pero mucho más estable que el navegador.
Playwright, Puppeteer, Computer Use. Es frágil: cualquier cambio de diseño lo rompe. Requiere más mantenimiento. Úsalo solo cuando no existan API ni CLI.
Análisis de HTML de páginas públicas. Muy inestable: se rompe con cualquier deploy. Los términos de servicio suelen prohibirlo. Nunca como solución a largo plazo.
✓ Aplicar la Ladder
- ✓Verifica si existe una API antes de usar Browser Automation
- ✓Documenta en connections.md el mecanismo utilizado
- ✓Planea migrar al nivel superior cuando esté disponible
✗ Ignorar la Ladder
- ✗Usar scraping cuando existe una API (frágil + innecesario)
- ✗Browser automation para una herramienta con CLI oficial
- ✗Construir la integración en un nivel bajo y nunca revisarla
🔌 Resumen del módulo 2.2
Próximo módulo:
2.3 — Capabilities: Sabe hacer el trabajo 🧩
Una frase activa un artefacto. Skills vs Agents, Autonomy Spectrum y cómo /level-up construye capabilities semana a semana.