Skip to main content
Version: Next

🖼️ Guía para adaptación de ítems existentes

Esta guía describe los pasos para adaptar correctamente los ítems existentes como procesos, estándares, políticas, plantillas u otros documentos del sistemas de gestión, con el fin de asegurar su pertinencia, vigencia y alineación con nuevas necesidades o contextos específicos.

🎯 Objetivo​

  • Establecer un procedimiento claro para adaptar ítems previamente definidos.
  • Facilitar la reutilización eficiente de documentación existente.
  • Asegurar la coherencia y trazabilidad de los cambios realizados.
  • Dirigido a responsables de procesos, líderes de proyecto, equipos de calidad o cualquier miembro autorizado a modificar ítems existentes.

📝 Procedimiento​

Paso 1: Identificar el ítem a adaptar​

  • Revisa la lista de ítems existentes para determinar cuál se ajusta mejor a la necesidad actual.

    Plantillas​

    • Plantilla manual de arquitectura
    • Plantilla para Estándares
    • Plantilla estrategia técnica
    • Plantilla de GitHub Actions
    • Plantilla para Guías
    • Plantilla plan STP
    • Plantilla para Políticas
    • Plantilla para Procesos
    • Plantilla de registro de decisiones arquitectónicas

    Guías​

    1. Guía de documentación en Docusaurus
    2. Guía de uso de Markdown
    3. Guía de formato para documentos
    4. Guía para elaborar un WBS
    5. Guía para identificar recursos y establecer capacitaciones
    6. Guía de uso de Swagger UI
    7. Guía para la especificación de requerimientos de software
    8. Guía para adaptación de ítems existentes
    9. Guía de Jest
    10. Guía para fusiones de ramas
    11. Guía de estrategia de ramas
    12. Guía de pull request
    13. Guía de buenas prácticas para commits
    14. Guía para realizar rollbacks
    15. Guía para la creación de archivos README
    16. Guía para inspección de código
    17. Guía para inspeccionar procesos
    18. Guía para liberar a producción

    Políticas​

    • Política de cambio de requisitos
    • Política de gestión de datos del proyecto
    • Política de gestión de procesos
    • Política de identificación de elementos de configuración
    • Política de estatus de control
    • Política del Comité de Control de Cambios (CCB)
    • Política sobre el Manual de Usuario
    • Política sobre el Manual Técnico de Instalación
    • Política de Evaluación de Conocimiento
    • Política sobre el Manual de Despliegue

    Procesos​

    Procesos para la gestión de personas​

    • 👺 PR5 Juntas Efectivas
    • ⚔️ PR9 Resolución de conflictos

    Inception: Planificación y organización inicial​

    • 🏇 PR24 Proceso para planear y mantener un proyecto

    Construcción y desarrollo​

    • 🚀 PR6 Plan de iteración
    • 🍻 PR3 Dailys
    • PR11 Comprensión y trazabilidad de requisitos
    • 🌻 PR21 Codificación
    • 🐥 PR15 Inspección
    • ⛏️ PR10 Gestión de cambios de requisitos
    • 🦑 PR20 Proceso de cierre de iteración

    Transición: Lanzar la solución a producción​

    • PR32 Proceso de despliegue
    • 👨‍🍼 PR4 Validación de entregables

    Procesos generales​

    • ✅ PR2 Definición de ítems

    Monitoreo de los proyectos​

    • 🦍 PR7 Reporte de Estado
    • 😿 PR16 Llevar a cabo métricas y análisis

    Procesos de mejora, evaluación y adaptación continua​

    • 🩻 PR12 Auditorías internas
    • 🦴 PR13 Acciones correctivas
    • 🤓 PR14 Toma de retroalimentación
    • 🥩 PR17 Proceso de mejora continua
    • 🚨 PR8 Gestión de Riesgos

  • Verifica su versión, fecha de última actualización y responsable.

  • Resultado esperado: ítem seleccionado con su información básica recopilada.

Paso 2: Justificar la adaptación​

  • Define claramente por qué es necesario adaptar el ítem (nuevo proyecto, cambios organizacionales, requerimientos del cliente, auditorías, etc.).
  • Actualizar la bitácora de ítems adaptados
  • Resultado esperado: justificación formal registrada.

Paso 3: Copiar o duplicar el ítem original​

  • Realiza una copia del ítem base para no alterar la versión oficial.
  • Asegúrate de conservar el encabezado, el historial y las referencias originales.
  • Resultado esperado: versión editable sin afectar el ítem original.

Paso 4: Adaptar el contenido​

  • Modifica únicamente las secciones necesarias para adecuar el ítem a su nuevo contexto.
  • Mantén la estructura, formato y estilo definidos por el estándar de documentación.
  • Evita eliminar elementos obligatorios (como objetivos, entradas, salidas o métricas).
  • Para la adaptación puedes:
    • Modificar pasos
    • Eliminar pasos
    • Añadir pasos
    • Fusionar pasos
    • Dividir un paso
  • Resultado esperado: nueva versión adaptada conforme a necesidades.

Paso 5: Validar y revisar la adaptación​

  • Comparte la nueva versión con los responsables del ítem original y/o con el equipo de calidad.
  • Recoge observaciones y realiza los ajustes necesarios.
  • Resultado esperado: ítem adaptado aprobado y listo para publicación.

Paso 6: Actualizar historial y publicar​

  • Registra la versión nueva en el historial de cambios indicando claramente el propósito de la adaptación.
  • Publica el ítem en el repositorio o directorio correspondiente según los flujos de control establecidos.
  • Resultado esperado: ítem adaptado oficialmente disponible.

⚠️ Consideraciones adicionales​

  • Pre-requisitos: Acceso al repositorio de ítems, conocimiento del contexto o requerimientos que motivan la adaptación, y permisos para editar o proponer cambios.
  • Limitaciones: No debe usarse esta guía para crear ítems completamente nuevos (usar guía de creación); los cambios estructurales mayores deben tratarse como rediseños.
  • Advertencias: Toda modificación debe conservar trazabilidad y cumplir con los estándares de calidad definidos.

📎 Recursos relacionados​

📚 Historial de cambios​

Versiones
VersiónDescripciónFechaColaborador
1.0.0Creación inicial de la guía13/05/2025Ethan Luna Cadó
1.0.1Ahora la guía es para adaptar ítems27/05/2025Angel Mauricio Ramírez Herrera
1.1.0Agregar listado de ítems05/06/2025Valeria Zúñiga, Mauricio Anguiano