KODEIN
Agentes de código. Decisiones humanas.
Cómo trabaja el equipo
SDD
Spec-Driven Development con agentes
- 01
Especificación
La tarea empieza con una especificación aprobada. Su hash viaja en cada llamada del agente.
spec · versión · sha256 - 02
Ejecución
Los agentes trabajan sobre una reserva de archivos, en una rama y una copia de trabajo aisladas.
reserva · rama · sesión - 03
Evidencia
Pruebas, diff, coste y merge request quedan enlazados a la tarea. El merge lo decide una persona.
CI · ledger · merge request
Arquitectura propia de Lobera
Una sola salida
Studio, Agent y Crew no hablan con los modelos. Hablan con Router, que tiene 38 motivos escritos para no dejar salir una llamada.
Donde se trabaja
- StudioEl editor del equipo, con los agentes dentro
- AgentAgente de código en la terminal
- CrewAuditoría y corrección en paralelo
Por donde pasa todo
Router
La pasarela de modelos de Kodein. Identifica, comprueba, reserva y registra cada llamada antes de enviarla.
- Identidadcredencial, operador, sesión y directorio9
- Proyecto y tarearepositorio, proyecto y ruta de modelo7
- Ejecución y presupuestoenvolvente, plazo, llamadas, tokens e importe20
- Trazasin traza local, la llamada no sale2
Hacia los modelos
- Modelos localesEn tus GPU, dentro del perímetro
- Modelos externosSolo si la política del proyecto lo permite
En cada llamada externa Router fija la política del proveedor: sin retención de datos, sin fallbacks y con precio máximo por ruta.
Simulador · respuestas reales de Router
Elige un caso y sigue la llamada.
- 01IdentidadCredencial vigente
401Credencial de Router no válida o revocada
- 02IdentidadSesión del mismo operador
403La sesión pertenece a otro operador
- 03Proyecto y tareaAcceso al repositorio
403El solicitante no tiene acceso a este repositorio
- 04Proyecto y tareaProyecto activo
403Proyecto pausado por el master
- 05Proyecto y tareaRuta de la tarea
403La ruta de modelo no coincide con el perfil y fase de esta tarea
- 06EjecuciónProveedor fijado por Router
400No se admiten cambios de proveedor, herramientas remotas ni múltiples respuestas
- 07EjecuciónContexto dentro de la envolvente
400El contexto excede la envolvente de texto de esta ruta; reduce o compacta la sesión
- 08EjecuciónPresupuesto del proyecto
403Presupuesto mensual insuficiente para reservar esta llamada
Resultado
Elige un caso
Ocho comprobaciones de Router, en el orden en que se ejecutan. Los códigos y los mensajes son los del código; los rechazos son simulaciones.
Resultado · llamada real
Admitida
Router añade la política del proyecto y el contexto versionado, reserva el coste máximo y envía la llamada.
- Ruta
- kodein-plan · externa, permitida por la política
- Tokens
- 31.937 → 877
- Duración
- 8,1 s
- Coste
- 0,0649 €
- Inyectado
- política 935 car. · contexto 2.887 car.
- Proveedor
- sin retención de datos · sin fallbacks · precio máximo
- Traza
- 137c70614dfc · kodein-fix · 15 oct 2026 00:57 UTC
Llamada real de Crew, registrada por Router.
CÓMO FUNCIONA
Capacidades
Seis capacidades. Todas funcionan hoy en el prototipo local.
Agentes dentro del flujo de merge requests.
On-premise. Cada llamada registrada con identidad y coste. Modelos externos solo cuando la política del proyecto lo permite.
Spec-Driven Development
Especificación aprobada, tarea, rama y merge request. La sesión del agente se vincula a la tarea y Router rechaza cualquier llamada sin sesión y repositorio registrados.
Construidos sobre código abierto
Studio y Agent parten de un editor y de un agente de código abiertos y consolidados, con cambios pequeños. Siguen a sus proyectos de origen: no son un editor ni un ejecutor nuevos.
Router con política de proyecto
Tres rutas de modelo (kodein-fast, kodein-code, kodein-plan) por perfil y fase de la tarea. Política y contexto versionado inyectados en cada llamada. Modelos externos solo cuando la política lo permite.
Identidad y atribución verificadas
Credenciales por operador y por servicio. Cada sesión pertenece a un operador, un repositorio y un directorio; los subagentes heredan el vínculo en solo lectura. Cada llamada lleva su atribución verificada por Router.
Ledger de tokens y coste
Por llamada: ruta, tokens de entrada y salida, duración y coste comunicado por el proveedor, en la moneda del proyecto. Consultable en Control por sesión, tarea y repositorio, y exportable para imputarlo al proyecto.
Crew: tareas en paralelo con revisión
Auditorías y correcciones en copias de trabajo aisladas, issues con evidencia y merge requests en GitLab. Límites de turnos y de tiempo por tarea. El merge lo hace una persona.
El agente pregunta.
Decide una persona.
Cuando una tarea necesita criterio, el agente llama a la herramienta kodein_review con el archivo, la línea y la pregunta. Studio detiene la tarea hasta que alguien responde.
- 01El agente espera
No edita ni ejecuta nada mientras la pregunta está abierta.
- 02La persona decide
Aprueba el archivo guardado, pide cambios o lo edita en el propio Studio.
- 03Queda en la sesión
La respuesta, la hora y la huella SHA-256 del archivo se registran, y el agente continúa con ellas como contexto.
Cada llamada deja rastro
Cifras del ledger local del prototipo. El coste es el que comunica el proveedor en cada llamada, en euros.
Catorce horas de prototipo, llamada a llamada
Cada punto es una llamada real a Router; cuanto más grande, más contexto. Los rombos son decisiones tomadas en Control.
kodein-plankodein-codekodein-fasterror o rechazo, sin costeacción en ControlDesliza para ver toda la línea →
Ledger por ruta
Llamadas, tokens y coste por ruta de modelo. La ruta kodein-plan concentra el 96 % del coste.
Anatomía de una llamada
Lo que Router envió al proveedor en una llamada real de Crew: 31.937 tokens de entrada. Los tramos rayados, el 4,7 %, son la política del proyecto y el contexto versionado que añade Router.
Qué registra Router
Identidad del operador y de la credencial, sesión, tarea, versión de la política, huella del contexto versionado, modelo resuelto, tokens de entrada y salida, duración, estado y coste comunicado por el proveedor. Las trazas completas se guardan dentro del perímetro.
Qué no hace con esos datos
No convierte tokens, líneas de código ni actividad del editor en una puntuación de productividad de las personas. Mide el sistema, no al desarrollador. El ledger sirve para imputar coste, auditar decisiones y ajustar la política.
SOBERANÍA
Tu código se queda dentro.
Tu nube, tus modelos y tus datos. Nada sale sin una ruta que la política del proyecto permita.
- 04Equipo
Studio y Agent en los puestos del equipo. El código sigue en tu GitLab.
- 03Plataforma
Router, Control y Crew: política, identidad, tareas y ledger.
- 02Modelos
Modelos abiertos en tus GPU, desplegados y mantenidos por Lobera.
- 01Infraestructura
Nube privada, servidores propios o red aislada. Kubernetes o Docker Compose.
- ↗Proveedor externo
Solo si la política del proyecto lo permite, sin retención de datos, sin fallbacks y con precio máximo por ruta.
- 01
Tu nube
Kodein se instala en tu nube privada o en tus servidores, también en redes sin salida a internet.
- 02
Tus modelos
Desplegamos modelos abiertos en tus GPU. Las rutas de código no necesitan salir del perímetro.
- 03
Sin retención
Código, prompts y trazas se quedan dentro. Si la política permite una ruta externa, Router solo admite proveedores que no almacenan datos.
IMPLANTACIÓN
Del primer repositorio al primer merge
El equipo de ingeniería de Lobera despliega Kodein sobre los repositorios, la forja y los modelos del cliente, y acompaña a un primer equipo hasta que trabaja con especificaciones y merge requests revisados.
Solicita una sesión técnica
Cada implantación parte de una evaluación de los repositorios, la política y los modelos del cliente. Nuestro equipo de ingeniería está disponible para una primera sesión.
De la auditoría a la revisión
Crew encontró un defecto en el servicio de identidad de Operantia, preparó la corrección en una rama aislada y la dejó lista para revisar. Cada paso deja un identificador que enlaza con el siguiente.
- 00:40–00:56Auditoría22 llamadas · 1,82 €abre el issue #2
- 00:57:36Especificacióndoc_33f1ad1d · v1sha256 dc34ac5f…aprobada por la política
- 00:57:36Reserva de archivosclm_525ded942 archivos en el alcance
- 00:57:36Sesiónses_ec2ef7582f…ruta kodein-plan · crew
- 00:57Router4 llamadas · 0,21 €103.523 → 3.194 tokens
- 01:12:42Pruebas567 pruebas · exit 0la regresión falla antes y pasa después
- 01:12:42Merge request!1 · servicio de identidadcommit cb4e4f77
- pendienteRevisión humanael merge lo hace una persona
Coste del caso: 2,03 € en 26 llamadas, del 15 oct 2026 entre las 00:40 y las 01:12 UTC. Memoria del proyecto: doc_e62bdd75, en borrador.
Ver el ledger