Ingeniería
Última actualización: 2026-05-03
Esta página es para ingenieros, arquitectos de seguridad y líderes de plataforma del comité de compra. Carga el detalle técnico completo que se encuentra resumido en lenguaje plano en la página principal. El sitio de marketing en myceliumai.co se mantiene en lenguaje plano para el resto del comité; esta página es la superficie de verificación para el ingeniero que va leyendo.
La arquitectura en una sola frase
Mycelium es una implementación productizada del patrón arquitectónico que Andrej Karpathy y Garry Tan nombraron en 2026: portabilidad en texto plano, ruteo determinista sobre un grafo tipado, skills como unidades de trabajo con efectos colaterales reproducibles, disciplina de write-back como ciclo de retroalimentación, y separación de contexto y cómputo.
1. Almacén de memoria · grafo tipado en texto plano
La capa de memoria es un directorio de archivos Markdown con frontmatter YAML, versionado con Git. Cada archivo lleva una categoría tipada de memoria (decisión, excepción, persona, proyecto, política, aprendizaje, flujo de trabajo, manual operativo) y enlaza a otros archivos vía wikilinks. El resultado es un grafo tipado consultable.
- Almacenamiento: nativo en sistema de archivos; corre sobre cualquier capa POSIX, cualquier object store, cualquier proveedor de Git.
- Esquema: definiciones JSON Schema por categoría tipada; validadas en tiempo de ejecución en cada escritura.
- Portabilidad: nada propietario; puedes clonar la capa de memoria a disco y leer cada byte.
- Auditabilidad: el log de Git es la historia canónica de cambios;
git blameresponde quién decidió esto y cuándo.
2. RESOLVER · ruteo bi-temporal
Cada hecho en la capa de memoria lleva dos marcas de tiempo: tiempo de validez (cuándo se volvió cierto en el mundo) y tiempo de transacción (cuándo se registró). Las consultas pueden moverse sobre cualquiera de los dos ejes.
- ¿Qué sabía el equipo el día en que ocurrió la observación de auditoría? Se resuelve sobre el tiempo de transacción.
- ¿Qué decía la política realmente el trimestre pasado? Se resuelve sobre el tiempo de validez.
- ¿Cómo ha cambiado nuestra visión de la política del trimestre pasado desde entonces? Diferencia ambos ejes.
El ruteo es determinista. La misma consulta sobre la misma revisión devuelve la misma respuesta. La deriva es legible porque la capa de memoria está versionada.
3. Skills · unidades de trabajo
Un skill es un directorio que contiene una especificación SKILL.md, un contrato de herramienta y un efecto colateral reproducible. Los skills son componibles: un skill puede llamar a otro. Los skills son testeables: el marco de evaluación corre fixtures de pares dorados contra cada skill en CI.
- Cada skill declara: disparador, contrato de entrada, contrato de salida, y superficie de efecto colateral.
- Los efectos colaterales están confinados: un skill no puede escribir fuera del directorio de memoria tipada ni llamar a sistemas más allá de lo que su conjunto declarado de herramientas permite.
- Se componen en flujos de trabajo a través de la capa de Síntesis (ver Sección 4).
4. Síntesis · generación autónoma de SOPs y memoria
Se entregan dos sintetizadores: PR-fusionado a SOP de flujo de trabajo, e hilo de Slack a entrada de memoria tipada. Cada uno corre sobre una línea base determinista con refinamiento opcional por LLM. La ruta del LLM usa caché de prompts con TTL de una hora sobre el bloque del sistema; la ruta determinista es el respaldo cuando la llave de API está sin configurar, se alcanza el límite de tasa, o el cliente decide no usar LLM en la nube en absoluto.
Verificabilidad:
- Marco de evaluación: 5 fixtures de pares dorados con un promedio de 97.8 / 100 sobre la línea base determinista del sintetizador.
- CI sale con código distinto de cero si algún fixture cae por debajo del umbral.
- Las entradas de evaluación y las salidas esperadas están versionadas en el repositorio.
5. Write-back de bucle cerrado · el ciclo de retroalimentación
Un demonio observa una carpeta Learnings/. Cuando una respuesta refinada o una decisión aprobada aterriza ahí, el demonio la promueve a la ubicación apropiada de memoria procedimental con el tipo correcto, la conexión correcta, y la ventana de validez correcta. Un respaldo basado en cron corre la misma ruta de promoción cada noche como cinturón y tirantes.
6. Motor de ejecución multi-tenant · endpoints de producción
El motor de ejecución productizado es un repositorio privado (licencia comercial). La superficie pública está documentada; el código fuente está disponible para clientes piloto que pagan, bajo carta de compromiso.
- Autenticación: JWT bearer con alcance por tenant. Cada solicitud, cada llamada de herramienta, cada webhook lleva un identificador de tenant. Sin lecturas entre tenants, sin estado compartido.
- Auditoría: log de solo-anexar de cada evento de lectura, escritura y síntesis con actor, tenant, marca de tiempo y origen. Retención por defecto de 12 meses, extendible a 7 años para compradores cercanos a SOX o HIPAA. Las exportaciones de auditoría son archivos JSONL comprimidos firmados con una llave de tenant.
- Tiempo real: flujo de Server-Sent Events por tenant emitiendo eventos de ingesta, síntesis y decisión. Consciente de contrapresión; reconectable con reanudación.
- Webhooks: 6 receptores con validación HMAC. Cola asíncrona de reintento con retroceso exponencial. Carpeta dead-letter por tenant. Endpoint de replay solo para administrador.
- Aislamiento: los datos del tenant nunca salen de la frontera del tenant. Los prompts a proveedores de LLM compartidos no llevan datos de ningún otro tenant. Llaves de cifrado por tenant disponibles en el nivel Enterprise Pilot.
- Confiabilidad: 76 de 76 pruebas pytest pasando en CI; prueba de integración de extremo a extremo de 11 pasos verde en cada push.
7. Conectores · actuales y en hoja de ruta
Siete conectores en producción hoy: Slack, GitHub, Notion, Linear, Gmail, WhatsApp, Salesforce. Cada conector es un skill (Sección 3) que se suscribe a un sistema externo, normaliza eventos al esquema de memoria tipada, los escribe en la capa de memoria de forma idempotente, y crea archivos de decisión-stub al detectar palabras clave disparadoras.
Dos conectores enterprise se entregan después: Microsoft 365 y Confluence. El conector de Microsoft 365 indexa correo, documentos de OneDrive e hilos de Teams. El conector de Confluence indexa páginas, comentarios y el grafo de páginas mismo.
Hoja de ruta: ServiceNow (ITSM), Workday (RRHH + Finanzas), SAP (ERP), Box (archivos), Google Workspace (correo + docs + drive), Snowflake (data warehouse), Databricks (data + ML).
Los desarrollos de conectores a la medida se definen en la Semana 0 de un Enterprise Pilot. El conector se vuelve un skill en tu tenant; el código fuente se comparte como parte del entregable del piloto.
8. Núcleo abierto · qué es MIT y qué es comercial
El núcleo open source (esquemas de memoria tipada, especificación RESOLVER, contrato de skill, marco de evaluación, e implementaciones abiertas de conectores) es open source bajo MIT en github.com/adelaidasofia/ai-brain-starter. Puedes hacer fork, instalarlo, correrlo en un portátil en dos horas.
El motor de ejecución productizado (alcance multi-tenant, log de auditoría, SSE, receptores de webhooks, cola de reintento, ruteo dead-letter, endpoint de replay solo para administrador, los conectores enterprise) se entrega bajo una licencia comercial separada. La misma forma que Vercel y Supabase.
9. Lista técnica de evaluación
Si estás evaluando Mycelium contra tu stack actual, aquí está la hoja de especificación:
- Portabilidad en texto plano. Los datos del tenant son Markdown auditable; te quedas con una copia exportable.
- Consultas bi-temporales. Tiempo de validez + tiempo de transacción por hecho.
- Multi-tenant desde el día uno. JWT por tenant, auditoría por tenant, SSE por tenant.
- Webhooks validados con HMAC con reintento de retroceso exponencial y ruteo dead-letter.
- Separación de cómputo. La capa de memoria es portable entre proveedores de modelo (Claude, GPT, Gemini, Llama, propio del cliente).
- Artefactos públicos de confiabilidad: Manifiesto de Confiabilidad, Hoja de Ruta de Tres Brechas, manual operativo de procedimiento de recuperación.
- Marco de evaluación con fixtures de pares dorados y compuertas de CI.
- Auditoría SOC 2 Type II en el calendario.
10. Contacto directo con el equipo de ingeniería
Revisión de arquitectura con los fundadores: adelaida@diazroa.com. Cuestionarios de seguridad y reportes de vulnerabilidades: adelaida@diazroa.com.
Mycelium · fundado en 2026