Agentes-contract es una herramienta de código abierto que permite a los agentes de IA de programación, como Claude Code, Codex, Cursor y GitHub Copilot, operar con mayor precisión mediante un archivo de configuración unificado. El sistema se basa en un archivo AGENTS.md que define reglas de proyecto, comandos, convenciones y criterios de finalización, eliminando la necesidad de que el agente investigue manualmente el entorno. Incluye un linter escrito en Python 3.9+ que verifica la integridad del contrato sin dependencias externas, y un hook de inicio de sesión que valida la configuración antes de iniciar la sesión.
La implementación es rápida y portable, funcionando en Windows, macOS y Linux. El linter verifica la presencia de cinco secciones obligatorias, la ausencia de marcadores de posición como TODO o FIXME, y la ausencia de credenciales en texto plano. Además, ofrece un sistema de pruebas A/B que demuestra que el uso de este contrato reduce el tiempo de ejecución en un 29% y el número de pasos de la tarea en un 32% para agentes de Claude Code, aunque el impacto varía según la complejidad del repositorio. La herramienta está diseñada para integrarse en flujos de trabajo de desarrollo existentes, mejorando la consistencia del código generado y reduciendo errores comunes en la configuración de entornos.
