Saltar al contenido
focoit.com
02Mi propia práctica, desde 2026

Gobierno de IA, aplicado en código.

Hago trabajar a los agentes de IA que programan bajo un mismo estándar en mis propios repositorios de entrega: las políticas, las specs y las compuertas que deciden cómo un agente planifica, escribe y revisa código. Una política que ninguna compuerta hace cumplir es una sugerencia, así que las reglas que importan son chequeos que corren en cada commit.

áreas de política
5
repositorios bajo el estándar
10
modelos en la compuerta final
0
en uso desde
Jul 2026

Las reglas

Lo que corre en cada commit.

  1. 01En los proyectos de código, cada cambio no trivial empieza con un ítem de backlog y una spec, aprobados antes de escribir código, y una spec que no pasa la validación estricta bloquea el commit.
  2. 02El agente que escribe el código y el que lo revisa son de familias de modelos distintas; los revisores informan, no corrigen.
  3. 03La última palabra es de un script determinístico, en el hook de pre-commit y en CI. Nunca es un modelo.
  4. 04Los secretos se bloquean en el commit, y el código de clientes nunca se envía a un servicio gratuito alojado.
  5. 05Lo que un agente lee son datos, no instrucciones; sus herramientas se otorgan con una lista de permitidos.
  6. 06Un cambio de política se propaga a los repositorios que adoptaron el estándar sin pisar lo que cada uno adaptó.
  7. 07Diez repositorios trabajan bajo el estándar a noviembre de 2026, dos de ellos en pausa.
Para evaluadores técnicos: ver el stack

Plataforma

Políticas en Markdown · una compuerta en PowerShell · OpenSpec · hooks de git · GitHub Actions · gitleaks · Claude Code y agentes de otros proveedores.

Cinco áreas de política

Cinco áreas de política
ÁreaQué haceQué evitaDónde se aplica
Ejecución y enrutamiento de modelosPlanificar, ejecutar y revisar son roles separados; quien revisa nunca es de la familia de modelos de quien ejecutaQue un modelo apruebe su propio trabajo; que código de clientes llegue a un servicio gratuito alojadoEl ciclo de tareas y su política
Escaneo de secretosRevisa cada cambio preparado en busca de claves y tokensQue una credencial llegue al repositorioHook de pre-commit y CI: bloquea
Agente revisor acotadoUn primer revisor de IA con un mandato estrechoQue un agente escriba código de negocio o cambie la compuertaPull request
Spec primero (proyectos de código)Un ítem de backlog y una spec aprobada van antes que el código; las specs se validan en modo estrictoQue entre al ciclo trabajo sin especificar o mal formadoHook de pre-commit: una spec que falla bloquea; el recordatorio de "sin spec" solo avisa
Propagación de políticasUn registro de los repositorios que adoptaron el estándar; los documentos espejo se actualizan, los propios de cada proyecto noLa deriva entre repositorios; que una actualización central pise decisiones localesUn paso de propagación en cada cambio de política

Los diagramas

El recorrido de un cambio bajo el estándar Un cambio empieza con un ítem de backlog y una spec aprobada. Un agente ejecutor lo escribe y un agente revisor de otra familia de modelos informa. Una compuerta determinística, un script que corre en el hook de pre-commit y en CI, bloquea ante un secreto, una regla del repositorio rota y, en los proyectos de código, una spec que no pasa la validación. En el pull request lo revisan un agente revisor acotado y después una persona, antes del merge. Un recordatorio aparte de que un cambio no tiene spec solo avisa. SEPARACIÓN DE FUNCIONES PROYECTOS DE CÓDIGO Backlog + spec aprobados antes del código Ejecutar agente ejecutor familia de modelos A Revisar agente revisor familia de modelos B informa, no corrige HOOK DE PRE-COMMIT + CI Compuerta determinística un script, nunca un modelo escaneo de secretos: bloquea specs (proyectos de código): bloquea reglas del repositorio PULL REQUEST Revisor acotado un primer revisor de IA no escribe código de negocio después, una persona Merge Recordatorio de «sin spec» avisa, nunca bloquea REFERENCIAS Bloquea Revisa Avisa El cambio avanza
El recorrido de un cambio: qué avisa, qué revisa y qué bloquea.
Cómo llega un cambio de política a los repositorios que adoptaron el estándar El playbook guarda las políticas y un registro de los repositorios que lo adoptaron. En cada cambio de política, un paso de propagación lee el registro y actualiza los documentos espejo de cada repositorio. Los documentos propios de cada proyecto no se tocan. Se dibujan tres repositorios de diez. El playbook políticas · specs · la compuerta el estándar, en su propio repositorio Registro los repositorios que lo adoptaron, y qué documentos lo reflejan Paso de propagación corre en cada cambio de política CAMBIO LEE REPOSITORIO QUE LO ADOPTÓ Documentos espejo se actualizan Documentos del proyecto no se tocan REPOSITORIO QUE LO ADOPTÓ Documentos espejo se actualizan Documentos del proyecto no se tocan REPOSITORIO QUE LO ADOPTÓ Documentos espejo se actualizan Documentos del proyecto no se tocan ACTUALIZA Diez repositorios a noviembre de 2026; se dibujan tres. REFERENCIAS Se envía con cada cambio Lee Nunca se pisa
Cómo llega un cambio de política a los repositorios que adoptaron el estándar.

Como se presentó

Dos diapositivas de una presentación de este trabajo, tal como se mostraron. Son la versión conceptual; los diagramas y la tabla de arriba son la versión precisa. Donde difieren, vale la página: spec primero se aplica a los proyectos de código, y la revisión viene después de la ejecución. Las diapositivas están en inglés.

Una diapositiva titulada Policy-driven defensive mesh flow. Un commit pasa por una compuerta de spec primero y un escaneo de secretos, después por un agente de IA acotado que revisa sin escribir código, después por un modelo ejecutor y un modelo revisor separados, y por una compuerta determinística, antes de llegar a tres repositorios sincronizados. Una línea arriba muestra cómo la política se propaga a cada etapa.
Todo el flujo en una imagen: compuertas, un agente revisor acotado, el ejecutor y el revisor separados, y la propagación a los repositorios que adoptaron el estándar. El comando bajo la última compuerta es ilustrativo, y la diapositiva dibuja al agente revisor antes del ejecutor.
Una diapositiva titulada Gathering requirements: executable specs and fail-closed defaults. A la izquierda, la transcripción de una entrevista se convierte en una especificación con escenarios de aceptación, validada por una compuerta estricta. A la derecha, la recuperación top-k sin filtrar llega a los generadores solo a través de una compuerta de rechazo por falta de fundamento; el camino sin compuerta está tachado.
De Jobflow, uno de los proyectos de código bajo el estándar: requisitos escritos como specs ejecutables, y una compuerta de recuperación que falla cerrada. Las etiquetas de confianza del recuadro inferior izquierdo están diseñadas, no implementadas.

Dos son trabajos para clientes, que no se nombran. Uno es mi propia práctica. El trabajo y las mediciones son reales.

Nivel 03, entregado

Una plataforma estadounidense de valuación de empresas, migrada y modernizada.

Ocho aplicaciones web y sus bases de datos SQL fuera del hosting heredado, hacia Azure, con failover, backup, monitoreo y acceso Zero Trust sumados en el camino. Después, el pipeline de entrega, para que publicar dejara de ser un evento.

menos costo operativo
~50%
minutos de caída
0
del inicio a la puesta en producción
5 sem
para publicar, antes dos semanas
2 días

La migración

Una migración y una modernización, en una sola pasada.

  1. 01Ocho aplicaciones web y sus bases de datos SQL salieron del hosting heredado.
  2. 02Failover, backup, monitoreo y acceso Zero Trust sumados en el camino.
  3. 03Un pipeline de entrega construido para que publicar dejara de ser un evento.
  4. 04Tiempo de release de dos semanas a dos días.
  5. 05Cutover en cinco semanas sin caída.
Para evaluadores técnicos: ver el stack

Plataforma

Azure App Services · Azure SQL con TDE · Blob Storage · Entra ID · diseño de red Zero Trust · pipelines CI/CD · observabilidad y gobernanza de costos

IA

Azure AI Foundry · Semantic Kernel · RAG agéntico · orquestación multiagente con guardrails y evaluación. Arquitecto líder de IA y agentes en la plataforma anterior.

Nivel 03, en producción desde 2012

Un solo sistema corre todo el negocio de un comercio desde 2012.

Una empresa familiar de herramientas y maquinaria en Argentina corre catálogo y precios, stock, presupuestos, facturas, órdenes de compra y alquileres en un solo sistema. El correo y el sitio web forman parte del mismo trabajo. Creció con el negocio en vez de quedarse atrás.

en producción
14 años
cuentas de clientes
~7.300
ventas en dólares, 2025 contra 2013
~5×
ítems de catálogo
~25.000

El sistema

Un solo sistema para todo el negocio.

  1. 01Un solo sistema corre todo el negocio desde 2012.
  2. 02Catálogo por proveedor, con costo, precio de lista y precio de contado, y actualizaciones masivas de precios.
  3. 03Stock con mínimos; presupuestos; facturas que descuentan stock; órdenes de compra que suman stock; contratos de alquiler; reportes de ventas y de stock.
  4. 04El correo y el sitio web forman parte del mismo trabajo.
  5. 05En 2026 se cargaron cerca de 15.500 ítems de lista de precios en una sola importación.
Para evaluadores técnicos: ver el stack

Plataforma

Un CRM .NET sobre SQL Server, mantenido desde 2012 · importaciones masivas de listas de precios · sitio web estático en Azure · correo corporativo alojado

El crecimiento

Todos los años desde 2012, contados.

Totales acumulados y el crecimiento de las ventas a partir del sistema en vivo del cliente, a noviembre de 2026. Los totales cuentan los registros que todavía existen.

  • Ítems de catálogo, cuentas de clientes y presupuestos son totales acumulados: registros que todavía existen, no registros creados ese año.
  • Las ventas se muestran como múltiplo de 2013, en dólares. La facturación del cliente queda en privado.
  • 2026 llega hasta el 12 de noviembre, así que sus valores cubren parte del año y se marcan como parciales.
  • 2026 incluye una importación de 15.500 ítems de lista de precios, y por eso la línea de catálogo salta.

Ítems de catálogo

0 – 25.000

Cuentas de clientes

0 – 8.000

Presupuestos

0 – 8.000

Ventas en dólares, múltiplo de 2013

0 – 6,0×

Todos los años y todos los valores
AñoÍtems de catálogoCuentas de clientesPresupuestosVentas en dólares, múltiplo de 2013
201254577410sin dato
20131.1751.219121,0×
20141.5431.595121,9×
20151.8472.025123,0×
20162.3442.3202253,5×
20172.7802.6436003,8×
20183.1192.9211.1282,6×
20193.4563.1431.4521,6×
20203.7643.4241.9771,9×
20214.2863.6692.6901,9×
20225.0153.9473.3752,0×
20236.0444.4384.4581,6×
20246.8665.1845.4353,2×
20258.3396.1696.3204,9×
202624.968 (año parcial)7.319 (año parcial)7.300 (año parcial)5,0× (año parcial)
PendienteMás casos

El próximo está reservado.

Sin clientes inventados, sin pared de logos, sin métricas de relleno. Cuando exista un cuarto caso que valga la pena publicar, va acá.

04Pendiente

Caso 04

Reservado. Sin métricas de relleno, sin cliente inventado, sin pared de logos.

Empezá acá

El primer nivel está a cuarenta minutos.

De pago, a precio fijo, y te lo digo claro si no me necesitás. Disponible para trabajos remotos con clientes de EE. UU. y la UE.

Córdoba, Argentina — husos horarios de EE. UU.