Cómo funciona la arquitectura RAG de Kalas Builders: el event bus del portal, la Knowledge Base corporativa, los skills especializados por disciplina, el loop de cosecha y los mecanismos de verificación que hacen que todo sea trazable y auditable.
Todo empieza con un evento en el portal de un proyecto. El evento se estructura, se archiva, se destila en aprendizajes, se promueve a la KB corporativa, y termina alimentando a los skills técnicos que responden en el siguiente proyecto. Con citación obligatoria en cada paso.
Cada capa hace una cosa. La separación de responsabilidades es lo que permite que el sistema sea auditable sin ser rígido.
Toda acción en el portal (del cliente, del equipo, del sistema) se publica como un evento JSON estructurado con tipo, actor, timestamp y payload.
Los eventos de una obra aterrizan en su archivo vivo (mi_casa/, casa_anna/…). Es la fuente cruda, trazable y versionada del proyecto.
Un proceso que revisa el archivo del proyecto y destila candidatos a la KB corporativa: rendimientos reales, precios confirmados, lecciones aprendidas, riesgos materializados.
kb/_staging/ para revisiónLa KB de Kalas: suma versionada y citable de todos los aprendizajes validados de todas las obras. Es lo que responde cuando un skill técnico pregunta "¿cuánto tarda esto?".
Skills especializados por disciplina (arquitecto, estructural, eléctrico, mecánico, presupuestos) que consultan la KB antes de responder. Cada skill llama a kb-kalas como puente obligatorio.
Un conjunto de controles que hacen que el sistema no pueda mentir: citación obligatoria, audit log de cada consulta, honeypots para detectar alucinaciones, y métricas de salud de la KB.
Cada skill es un experto en su área que consulta la KB antes de responder. No reemplazan a los profesionales de Kalas: los aceleran y documentan sus decisiones.
Un sistema que aprende puede inventar. Por eso Kalas tiene mecanismos activos para detectar y prevenir respuestas sin sustento.
Ningún skill puede responder sin citar el item de la KB del que salió el dato. Si no hay fuente, no hay respuesta.
Cada consulta queda registrada: quién preguntó, qué skill respondió, qué item citó, con qué versión de la KB. Reproducible en el tiempo.
Preguntas trampa con respuesta conocida que se ejecutan periódicamente. Si un skill responde inventando, cae en el honeypot y queda marcado.
En decisiones de alto impacto (cotización, cambio de alcance, estructura) los skills operan en modo estricto: cero respuestas sin fuente validada.
Cobertura (% actividades con dato validado), frescura (% precios < 90 días), uso (queries/semana), precisión (cotización vs costo real).
Nada entra automáticamente a la KB. Todo candidato pasa por revisión humana antes de promoverse de _staging/ a KB oficial.
panel.html — single-file, sin build step. Datos desde /api.data/. JWT para auth, invite tokens para onboarding del cliente.kb-kalas.deploy.sh con rsync + health checks. SSL por Let's Encrypt./admin con métricas de salud de KB, skills, cosechas, conexiones externas, clientes, biblioteca de docs, config global, logs.Te podemos mostrar el sistema en vivo: el portal del cliente, el admin corporativo, el flujo de eventos, los skills respondiendo con citación.