Glosario

El marco SHAPE. Un modelo operativo de ingeniería de productos guiado por especificaciones, liderado por personas y realizado con agentes para el desarrollo empresarial de software. Combina organización, un marco técnico empresarial y un proceso de desarrollo guiado por especificaciones hasta las UAT.

Guiado por especificaciones. Un enfoque en el que el comportamiento previsto del producto se recoge en especificaciones mantenidas y versionadas que orientan la implementación y la verificación independiente.

Liderado por personas. Los roles humanos siguen siendo responsables de la intención empresarial, las decisiones arquitectónicas, la evaluación de calidad y la aceptación, incluso cuando los agentes de programación realizan una parte sustancial de la implementación.

Con agentes. Una forma de trabajo en la que agentes de IA realizan tareas de desarrollo o verificación de varios pasos utilizando herramientas y contexto autorizados, bajo dirección humana y restricciones empresariales.

Product Engineer (PE). El rol humano central que conecta el descubrimiento, las especificaciones, la implementación asistida por IA, la validación y la responsabilidad continua de una cartera limitada de productos.

Equipo o pod. Una unidad pequeña de trabajo centrada en el producto, liderada por un Product Engineer y apoyada por conocimientos compartidos de arquitectura y UX.

Arquitecto / Ingeniero sénior. El especialista técnico compartido que participa en los fundamentos técnicos de la etapa 2, define y revisa límites arquitectónicos, apoya decisiones y excepciones importantes durante el ciclo de vida y supervisa recursos empresariales de una cartera limitada. El Product Engineer se responsabiliza de la implementación y el mantenimiento dentro de esos límites.

Diseñador de UX. El especialista compartido que define la orientación de interacción y experiencia y evalúa el software funcional a medida que evoluciona.

Parte interesada del negocio / cliente. Una persona que representa las necesidades, las reglas empresariales o la aceptación del producto. «Cliente» no implica necesariamente un cliente comercial externo.

Agente de programación. Un sistema de IA autorizado para producir o modificar software y artefactos relacionados dentro de un entorno de trabajo aprobado.

Agente de verificación / contexto de verificación independiente. Un proceso de comprobación asistido por IA separado del contexto de implementación y dirigido a derivar pruebas de especificaciones registradas en el repositorio, en lugar de reproducir simplemente las suposiciones del implementador.

Conjunto de especificaciones. El conjunto actual de especificaciones de funcionalidades mantenidas que definen el comportamiento previsto del producto.

Especificación de funcionalidad. Una descripción acotada y duradera del comportamiento esperado, los actores, las reglas, las excepciones y las condiciones verificables de aceptación.

Condición de aceptación. Una declaración observable que ayuda a determinar si se ha entregado el comportamiento especificado.

Instrucciones permanentes. Reglas y contexto persistentes que indican a un agente cómo trabajar y qué restricciones de proyecto o empresa se aplican; son distintas de los requisitos de funcionalidades individuales.

AGENTS.md. El punto de entrada raíz de instrucciones, fácil de descubrir, utilizado en la convención de repositorio SHAPE para dirigir a los agentes a todos los archivos Markdown de agent_instructions/.

agent_instructions/. Un directorio extensible para documentos Markdown de instrucciones y contexto pertinentes para el proyecto que explican su propio propósito. El marco no exige nombres de archivo específicos en su interior.

specs/. Un área separada que contiene especificaciones de funcionalidades del producto y no instrucciones permanentes para agentes.

Recursos empresariales. Capacidades organizativas aprobadas y reutilizables, como plataformas, bibliotecas, convenciones arquitectónicas, componentes comunes, mecanismos de seguridad e instrucciones documentadas.

Entorno de ejecución aprobado. El entorno técnico en el que un agente trabaja con límites de acceso, herramientas, datos y permisos aplicados conforme a la política empresarial.

Trabajo de fundamentos técnicos. Preparación proporcional dentro de la etapa 2 del Ciclo 1: elección de tecnologías y reutilización aprobadas, límites arquitectónicos, instrucciones coherentes y permisos aplicados técnicamente. Avanza en paralelo con la orientación de UX y la generación de especificaciones. SHAPE no añade una aprobación obligatoria separada de preparación; las dos revisiones planificadas de implementación ocurren en las etapas 4 y 7.

Ciclo 1. El proceso de desarrollo inicial de ocho etapas: descubrimiento; orientación de UX, fundamentos técnicos y generación de especificaciones en paralelo; implementación; revisión inicial del arquitecto; iteración con las partes interesadas; verificación independiente; revisión final del arquitecto; UAT.

Ciclo 2. El proceso de mejora de cuatro etapas: cambio de especificaciones e implementación; verificación independiente; revisión del arquitecto según política y riesgo; UAT.

Pruebas basadas en especificaciones. Verificación independiente que deriva comprobaciones del conjunto de especificaciones registradas en el repositorio, ejercita la implementación cuando es práctico y registra las evidencias resultantes y las limitaciones sin resolver.

Aprobación del arquitecto. Un resultado de revisión técnica bajo la política empresarial; no equivale a la aceptación empresarial de las partes interesadas.

UAT (pruebas de aceptación de usuarios). El proceso empresarial autorizado de la organización para determinar si un producto o cambio satisface las necesidades previstas.

Cartera limitada de productos. El conjunto de aplicaciones del que un Product Engineer puede responsabilizarse de forma sostenible, dejando tiempo para cambios continuos, mantenimiento y proyectos actuales.

Incorporación de un recurso compartido. El proceso revisado de adoptar un patrón o componente local útil dentro de los materiales reutilizables de toda la organización.

Los términos se definen aquí para mantener la coherencia. Sus páginas conceptuales específicas explican la justificación, y las Guías para profesionales describen las acciones. Cuando corresponda, siga la página enlazada del rol, proceso o artefacto para obtener más información.