Límites de cambio: paquete de contexto del agente
Proporciona a un agente de codificación de IA los hechos, reglas, límites y ejemplos necesarios para aplicar los límites de cambio de manera consistente. Corrige los límites de adopción y la evidencia observable de fallos mientras mantiene configurables los límites específicos del entorno.
Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.
Decisión
Para los límites de cambio, adopte instrucciones de repositorio controlado por versiones delimitadas por ruta y tarea. Implemente el comportamiento a través de un único camino de escritura autorizado, interfaces tipadas, estado explícito y manejo idempotente de efectos secundarios. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y propietarios operativos a partir de la evidencia en su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de políticas o esquemas y resultados visibles externamente de los límites de cambio descritos por este bloque de implementación.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que pueden ejercer el mismo límite.
- Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.
Fuera de este bloque
- Elegir un proveedor universal, marco, jurisdicción, umbral numérico, período de retención u objetivo de nivel de servicio para cada adoptante.
- Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o accesibilidad.
Contrato
- Declarar la precedencia de instrucciones, rutas aplicables, verificaciones requeridas, cambios prohibidos y la evidencia esperada en la entrega.
- Derivar comandos, versiones, arquitectura y ubicaciones de archivos desde fuentes del repositorio en lugar de la memoria o un proyecto vecino.
- Mantener la verificación ejecutable separada de las afirmaciones en prosa y registrar cuando una verificación no se ejecutó o no pudo completarse.
- Requerir que el agente preserve cambios no relacionados y se detenga cuando falten credenciales, alcance destructivo o autoridad del producto.
- Validar las entradas una vez en el límite y preservar la representación normalizada usada por la lógica descendente.
- Persistir la transición de negocio antes o atómicamente con un registro de buzón de salida; los consumidores deduplican por identidad duradera de operación.
- Declarar rutas y comportamientos permitidos, archivos adyacentes que pueden ser inspeccionados, áreas protegidas, artefactos generados y aprobaciones requeridas para ampliar el alcance.
- Un cambio necesario fuera de límite se convierte en un bloqueo reportado o propuesta explícita; el agente no amplía la tarea silenciosamente.
Guía de implementación
- Entregar primero cambios aditivos en almacenamiento e interfaces, rellenar observablemente, luego retirar rutas antiguas tras evidencia de compatibilidad.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de los límites de cambio antes de seleccionar detalles de marco o proveedor.
- Almacenar la versión aplicable del contrato o política de límites de cambio con el estado material para que migraciones, reproducción y decisiones de soporte sean atribuibles.
- Introducir la ruta detrás de un despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta completar la evidencia de adopción.
Manejo de fallos y salvaguardas
- El contexto conflictivo o desactualizado se presenta como un bloqueo con fuentes exactas; el agente no inventa un desempate que cambie el comportamiento del proyecto.
- El estado inválido o contradictorio de los límites de cambio se rechaza o pone en cuarentena; la implementación nunca adivina un valor que amplíe autoridad o duplique un efecto.
- Los reintentos están limitados y usan identidad duradera; tras agotarlos, el trabajo alcanza un estado terminal inspeccionable con un propietario responsable.
Verificación y operaciones
- Inyectar fallo de dependencia antes y después de la persistencia y demostrar que el reintento converge en un resultado visible externo único.
- Monitorizar éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación de los límites de cambio por versión de contrato sin dimensiones sensibles de carga útil.
- Reejecutar casos positivos y negativos emparejados tras cambios en política, esquema, dependencia, migración o límites y preservar la evidencia resultante.
Suposiciones de adopción
- Los nombres y valores en el ejemplo son un caso concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y propiedad.
- El sistema adoptante puede proporcionar identidad autenticada, versiones duraderas de operación o registro, telemetría limitada y una ruta controlada para el cambio.
Los ejemplos con apariencia ejecutable en este paquete son casos y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio objetivo antes de registrar la evidencia de implementación.