Ingeniería

Principios de ingeniería

Cómo construimos sistemas de IA que deben funcionar de verdad

Estos principios guían nuestras decisiones de arquitectura, implementación y operación. No describen una tecnología concreta. Definen cómo reducimos complejidad, riesgo y dependencia mientras construimos sistemas que una organización puede comprender y controlar.

01

Producción primero

Diseñamos pensando en el día dos — no en la demo.

Diseñamos pensando en disponibilidad, mantenimiento, incidentes, costes, cambios y recuperación. Una demo prueba que algo puede funcionar. Un sistema de producción debe demostrar que puede seguir funcionando.

02

La arquitectura adecuada, no la más compleja

No te obligamos a mantener una infraestructura mayor de la que realmente necesitas.

Elegimos tecnologías según volumen, riesgo, latencia, equipo y capacidad operativa. Servicios gestionados, serverless, contenedores o Kubernetes cuando el problema lo justifica — no por moda ni por defecto.

03

Seguridad y mínimo privilegio por diseño

Identidad, permisos y aislamiento forman parte de la arquitectura — no son añadidos posteriores.

Identidad, permisos, secretos, aislamiento y modelado de amenazas forman parte de la arquitectura inicial. Cada usuario, agente y herramienta recibe únicamente el acceso necesario para cumplir su función.

04

Control humano proporcional al riesgo

No todas las acciones requieren aprobación. Tampoco todas deberían ser autónomas.

No todas las acciones requieren aprobación. Tampoco todas deberían ser autónomas. Clasificamos las acciones según su impacto y aplicamos límites, aprobaciones, supervisión o bloqueo cuando el riesgo lo exige.

05

Infraestructura reproducible

Entornos y despliegues deben poder reconstruirse de forma consistente.

Infraestructura, configuración y despliegues deben poder reconstruirse de forma consistente. Usamos infraestructura como código, control de versiones, automatización de entrega y entornos verificables para reducir errores manuales y configuraciones invisibles.

06

Observable y evaluable por defecto

Si no podemos explicarlo, medirlo o investigarlo, no podemos operarlo con confianza.

Un sistema que no puede explicarse, medirse o investigarse no puede operarse con confianza. Incorporamos métricas, logs, trazas, auditoría, evaluaciones de IA y atribución de costes según la criticidad del sistema.

07

Interfaces abiertas y dependencias explícitas

No fingimos que no existe vendor lock-in. Hacemos visibles y controlables las dependencias.

No prometemos cero vendor lock-in. Hacemos visibles y controlables las dependencias. Preferimos APIs documentadas, formatos portables, estándares abiertos y planes de salida razonables para evitar dependencias accidentales.

08

Automatizar lo que entendemos

Primero estabilizamos el proceso. Después automatizamos lo repetible, verificable y seguro.

Primero comprendemos el proceso, sus excepciones y riesgos. Después automatizamos. Cada automatización debe ser verificable, observable, reversible y tener un responsable claro.

09

Documentación como control operativo

Las decisiones importantes y los procedimientos operativos quedan documentados y versionados.

Documentamos las decisiones que condicionan el sistema y la información necesaria para operarlo. Arquitecturas, ADRs, runbooks, ownership, permisos y procedimientos de recuperación permanecen versionados junto al sistema.

10

Simplicidad sobre novedad

Cada componente adicional aumenta el coste de operación, seguridad y mantenimiento.

Cada componente adicional aumenta el coste de operación, seguridad y mantenimiento. Preferimos tecnologías conocidas, límites claros y diseños comprensibles antes que complejidad innecesaria.

Ayudamos a las empresas a usar IA con claridad, control y confianza — desde el primer caso de uso hasta una operación de IA gobernada.

Ingeniería · Principios

Principios

Cómo construimos sistemas de IA que deben funcionar de verdad

Reglas de decisión · Evidencia · Modelo operativo

Producción primero

Regla de decisión

Sin camino a producción sin runbooks, rollback, límites de coste y responsable de guardia definidos antes del go-live.

Evidencia

Checklist de preparación para producción Objetivos SLO Runbooks de incidentes Procedimiento de rollback Límites de coste

La arquitectura adecuada, no la más compleja

Regla de decisión

Preferir ejecución gestionada o serverless hasta que aislamiento, throughput, latencia, cumplimiento o escala organizacional justifiquen un runtime dedicado o plataforma Kubernetes.

Evidencia

ADR de selección de runtime Modelo de capacidad y costes Diagrama de arquitectura Plan de evolución Criterios de migración

Seguridad y mínimo privilegio por diseño

Regla de decisión

Cada conector, herramienta y fuente de datos recibe scopes explícitos, aislamiento de credenciales y un modelado de amenazas antes del acceso a producción.

Evidencia

Modelo de amenazas Matriz de permisos Política de secretos Límites de aislamiento Cadencia de revisión de accesos

Control humano proporcional al riesgo

Regla de decisión

Clasificar acciones por radio de impacto; exigir aprobación, supervisión o bloqueos duros para operaciones de escritura, externas o irreversibles.

Evidencia

Taxonomía de acciones Políticas de aprobación Matriz de riesgo Muestras de auditoría Procedimientos de override

Infraestructura reproducible

Regla de decisión

Sin cambio en producción sin IaC versionado, entrega automatizada y un camino verificable para reconstruir el entorno.

Evidencia

Repositorio IaC Definiciones de pipeline Comprobaciones de paridad de entornos Detección de drift Registros de despliegue

Observable y evaluable por defecto

Regla de decisión

Cada camino de agente en producción incluye trazas, eventos de auditoría, hooks de evaluación y atribución de costes proporcional al impacto de negocio.

Evidencia

Esquema de trazas Suite de evaluación Política de logs de auditoría Paneles de coste Playbooks de guardia

Interfaces abiertas y dependencias explícitas

Regla de decisión

Documentar cada dependencia externa con portabilidad de datos, contratos de API y un plan consciente de salida o migración.

Evidencia

Registro de dependencias Contratos de API Rutas de exportación de datos Criterios de salida ADR de revisión de vendor

Automatizar lo que entendemos

Regla de decisión

Automatizar solo cuando el proceso está comprendido, las excepciones documentadas y el rollback probado.

Evidencia

Mapa de proceso Registro de excepciones Pruebas de automatización Runbook de rollback Responsable designado

Documentación como control operativo

Regla de decisión

Cada decisión arquitectónica y procedimiento operativo que afecta a producción tiene un ADR o runbook versionado vinculado al sistema.

Evidencia

Índice de ADRs Runbooks Mapa de ownership Documentación de permisos Procedimientos de recuperación

Simplicidad sobre novedad

Regla de decisión

Rechazar componentes nuevos salvo que eliminen más complejidad de la que añaden — con evidencia.

Evidencia

Revisión de complejidad Inventario de componentes Estimación de coste operativo Alternativas consideradas Criterios de retirada

Ayudamos a las empresas a usar IA con claridad, control y confianza — desde el primer caso de uso hasta una operación de IA gobernada.