Conocimiento duradero para la ingeniería de productos con agentes
Un proceso eficaz de desarrollo con agentes no puede depender únicamente de que un Product Engineer recuerde conversaciones anteriores o explique repetidamente las mismas reglas organizativas. El marco SHAPE distingue entre instrucciones permanentes, especificaciones del producto y recursos empresariales compartidos, para que los agentes de programación reciban el contexto adecuado y las personas puedan revisar los cambios a lo largo del tiempo.
Tres tipos de información
Las instrucciones para agentes y el contexto del proyecto establecen cómo debe trabajar un agente, qué restricciones debe respetar, a qué objetivos sirve el producto y qué decisiones arquitectónicas ya están resueltas. Estas instrucciones pueden organizarse en documentos Markdown separados que expliquen su propio propósito.
Las especificaciones de funcionalidades describen el comportamiento previsto del producto. Se mantienen como artefactos con control de versiones y evolucionan cuando cambia el comportamiento acordado. Las especificaciones responden a preguntas sobre lo que debe ocurrir, incluidas las reglas empresariales, las excepciones y las condiciones de aceptación.
Los recursos empresariales proporcionan capacidades de implementación aprobadas y reutilizables. Pueden incluir tecnologías seleccionadas, servicios, bibliotecas comunes, mecanismos de identidad y seguridad, sistemas de diseño, componentes, convenciones de ingeniería y patrones reutilizables. La responsabilidad y los cambios de estos materiales compartidos se gobiernan más allá de cada proyecto individual.
Convenciones estándar de proyecto
El marco SHAPE recomienda un modelo simple y extensible para descubrir las instrucciones del proyecto. Un archivo AGENTS.md en la raíz indica a los agentes de programación que lean y respeten todos los archivos Markdown de agent_instructions/. Cada archivo de ese directorio declara su propósito en la línea o el encabezado inicial. Los proyectos pueden añadir sus propios archivos en lugar de depender de un registro centralizado de nombres de archivo obligatorios.
Las especificaciones de funcionalidades permanecen en un área specs/ separada. No son instrucciones permanentes: cada una describe el comportamiento del producto que debe entregar la implementación y que debe evaluar la verificación.
Responsabilidades de la organización y del proyecto
La organización mantiene los estándares y los recursos reutilizables aprobados. Un proyecto proporciona sus propios objetivos, instrucciones aplicables, arquitectura aceptada y especificaciones de funcionalidades. La combinación exacta de documentos puede diferir entre una pequeña aplicación de flujo de trabajo y un producto de integración complejo, pero las categorías fundamentales deben permanecer claras.
La documentación y la implementación deben coincidir
Cuando cambia el comportamiento aceptado de un producto, deben cambiar las especificaciones. Cuando cambia una decisión arquitectónica formalmente aprobada, debe cambiar su documentación. Cuando cambia un componente empresarial reutilizable, sus instrucciones deben seguir siendo precisas. La documentación contradictoria crea incertidumbre tanto para las personas como para los agentes.
Dónde los controles pasan a ser exigibles
Una instrucción escrita de no acceder a una base de datos no impide por sí misma el acceso. La capacidad real de leer datos, ejecutar comandos, instalar software o conectarse a servicios debe estar limitada por el entorno de ejecución aprobado. El marco trata las instrucciones fáciles de encontrar y los permisos técnicos como elementos complementarios, no intercambiables.
Explorar los artefactos
Consulte Especificaciones para el comportamiento del producto, Instrucciones para agentes para el modelo de instrucciones permanentes, Recursos empresariales y reutilización para las capacidades de la organización y Límites de ejecución de los agentes para los permisos aplicados técnicamente.