Fundamentum

El código que comparten Iterum, Domi y Vocatio

PropiaPythonuvADKGemini · ClaudeTerraform

Problema

A veces me falta orden al implementar: tiendo a abrir caminos distintos.

Fundamentum es mi arnés para eso. Iterum, Domi y Vocatio necesitaban lo mismo (modelos con precio, medición, eventos y guardrails), así que lo saqué a un chasis versionado que cada app instala por etiqueta de git. Si algo falta, se agrega primero al chasis, con pruebas.

Cómo funciona

  1. Iterum · Domi · Vocatioapps
  2. Fundamentumv1.0.0 por etiqueta
  3. Modelos y costoregistro tarea → modelo
  4. Guardrails y evalsalcance · presupuesto · gate
Paquetes de Python instalados desde git por etiqueta
  1. 01Cada tarea pide su modelo a un registro que obliga a declarar el precio.
  2. 02Toda llamada pasa por ADK y queda medida con modelo, tokens y costo.
  3. 03Guardrails de alcance y presupuesto, y un runner de evals con gate de costo y latencia.

Decisiones

DECISIÓN 01

Ninguna llamada a un modelo fuera de ADK.

Una prueba en cada app falla si alguien llama a un modelo por otro camino. Así toda llamada queda medida.

DECISIÓN 02

Cada modelo lleva su precio.

El registro no acepta un modelo sin su precio, y cada app cambia el modelo de una tarea con una variable de entorno, sin tocar código.

Resultado

La versión 1.0 salió en octubre de 2026 y Iterum ya corre sobre ella.

MI ROLProyecto propio.Diseño y código.