Openup Shared Vision

Criterios de Éxito

Tras usar esta skill, verifica:

• Los objetivos técnicos están claramente documentados
• El alcance DENTRO/FUERA está bien definido
• Las suposiciones y restricciones técnicas están listadas
• Las decisiones técnicas clave tienen justificación
• Las preguntas abiertas están registradas para elaboración
• El documento está enlazado desde la visión principal

Resumen del Proceso

1. Leer el documento de visión existente
2. Extraer el contexto y los objetivos técnicos
3. Definir el alcance DENTRO/FUERA
4. Documentar suposiciones y restricciones técnicas
5. Registrar decisiones técnicas clave
6. Identificar preguntas abiertas

Pasos Detallados

1. Leer la Visión Existente

Leer docs/vision.md para comprender:

• Planteamiento del problema del proyecto
• Necesidades de los interesados
• Objetivos de negocio
• Estado actual del proyecto

2. Extraer Contexto Técnico

De la visión y el estado del proyecto, identificar:

Objetivos Técnicos:

• ¿Qué problemas técnicos necesitan resolverse?
• ¿Cuáles son los atributos de calidad clave (rendimiento, seguridad, escalabilidad)?
• ¿Qué criterios de éxito técnicos existen?

Si se proporciona $ARGUMENTS[technical_objectives]:

• Centrarse en esos objetivos específicos
• Añadir objetivos técnicos relacionados

Ejemplos:

• "Lograr tiempos de respuesta inferiores a un segundo"
• "Soportar 10.000 usuarios concurrentes"
• "Garantizar cifrado de datos en reposo y en tránsito"

3. Definir Alcance DENTRO/FUERA

Crear límites claros de lo que se incluye y lo que se excluye:

DENTRO del Alcance: ¿Qué funcionalidades y capacidades están definitivamente incluidas?

• Usar $ARGUMENTS[scope_focus] como punto de partida si se proporciona
• Listar funcionalidades, capacidades y tecnologías específicas
• Ser específico sobre lo que significa "dentro del alcance"

FUERA del Alcance: ¿Qué se excluye explícitamente para gestionar expectativas?

• Funcionalidades que explícitamente NO se van a construir
• Tecnologías que no se utilizarán
• Capacidades que están fuera del alcance de este proyecto

4. Documentar Suposiciones Técnicas

Registrar suposiciones sobre el entorno técnico:

5. Documentar Restricciones Técnicas

Registrar restricciones conocidas que limitan las opciones:

6. Registrar Decisiones Técnicas Clave

Documentar decisiones técnicas significativas con justificación:

Ejemplos:

• Elección del lenguaje de programación
• Estilo arquitectónico (microservicios vs monolito)
• Selección de base de datos
• Enfoque de despliegue

Para cada decisión:

• Qué se decidió
• Por qué (justificación)
• Alternativas consideradas
• Compromisos aceptados

7. Identificar Preguntas Abiertas

Listar preguntas que necesitan respuesta durante la elaboración:

8. Crear Documento de Visión Compartida

Crear docs/shared-vision.md usando la plantilla de visión compartida con:

• Tabla de objetivos técnicos
• Secciones de alcance DENTRO/FUERA
• Tablas de suposiciones y restricciones
• Decisiones técnicas clave
• Preguntas abiertas

9. Enlazar desde la Visión Principal

Añadir una referencia en docs/vision.md:

## Visión Técnica

Consulta la [Visión Compartida](shared-vision.md) para objetivos técnicos detallados, alcance y decisiones.

Salida

Devuelve un resumen de:

• Documento de visión compartida creado en docs/shared-vision.md
• Objetivos técnicos documentados
• Alcance DENTRO/FUERA definido
• Decisiones clave registradas
• Preguntas abiertas identificadas

Ejemplo de Uso

/openup-shared-vision technical_objectives: "escalabilidad, seguridad" scope_focus: "autenticación de usuarios"

Errores Comunes

Referencias

• Plantilla de Visión Compartida: docs-eng-process/templates/shared-vision.md
• Plantilla de Visión: docs-eng-process/templates/vision.md
• Plantilla de Cuaderno de Arquitectura: docs-eng-process/templates/architecture-notebook.md

Ver También

• openup-create-vision - Crear primero la visión del proyecto
• openup-create-architecture-notebook - Crear documentación de arquitectura detallada
• openup-elaboration - Actividades de la fase de Elaboración