Principios técnicos

Modularidad antes que distribución

Un límite modular claro es útil incluso dentro de una sola aplicación. Un servicio independiente solo compensa cuando aporta propiedad, escalado, aislamiento o despliegue realmente autónomos.

Una fuente de verdad

Cada dato, contrato y decisión durable debe tener un propietario. La documentación transversal enlaza a los detalles del repositorio propietario en lugar de duplicarlos.

Flujos completos

Los cambios se evalúan por su efecto de extremo a extremo. Cuando se reemplazan datos base, también deben revisarse los artefactos derivados, cachés y estados persistidos que ya no sean válidos.

IA verificable

Los agentes aceleran exploración, implementación y revisión, pero trabajan mejor con:

• límites de repositorio inequívocos;
• instrucciones locales cortas y concretas;
• comandos de validación reproducibles;
• cambios pequeños y observables;
• contratos y decisiones cerca del código;
• ausencia de secretos en prompts, logs y fixtures.

Producción inmutable

Los entornos productivos deben desplegar versiones o digests inmutables. Las ramas y etiquetas móviles se reservan para desarrollo, previews o entornos temporales.