Decisiones y revisión
Cómo se proponen, revisan, sustituyen y mantienen al día las decisiones.
Una decisión en Mios representa una elección técnica acordada, una regla de arquitectura o un requisito del proyecto. Mios conserva el historial de cada decisión: quién la redactó y qué decisiones anteriores sustituyó.
Cómo se proponen las decisiones
Las decisiones entran en Mios por dos vías principales:
- Extracción desde las fuentes conectadas: cuando Mios indexa discusiones de pull requests, documentos de diseño de arquitectura o hilos técnicos de chat, su motor de análisis detecta cuándo el equipo se pone de acuerdo sobre un camino.
- Propuestas de los agentes de código: cuando un agente termina una tarea en Claude Code o Codex, el hook de parada analiza los cambios hechos durante la sesión y propone a Mios los patrones nuevos que se han establecido.
Todas las decisiones recién propuestas empiezan en estado pendiente, a la espera de la confirmación de una persona.
La cola de revisión («Pendiente de ti»)
Para revisar las decisiones propuestas, ve a Review (/pages/review) en https://app.mios-ai.com.
Cada tarjeta muestra el enunciado de la decisión propuesta, la justificación extraída de la discusión y enlaces directos a los documentos de origen. Tienes cuatro acciones disponibles:
- Adopt: valida la decisión. Pasa a formar parte de la memoria oficial del proyecto y se sirve de inmediato a los agentes de código.
- Reject: descarta la decisión. Sale de la cola activa y no se sugerirá a los agentes.
- Edit: ajusta el título o la redacción de la decisión antes de adoptarla.
- Undo: revierte una acción de revisión reciente si adoptaste o rechazaste una decisión por error.
Decisiones adoptadas automáticamente
Cuando varios documentos distintos y fiables enuncian explícitamente la misma decisión, Mios puede marcarla automáticamente como auto-adopted.
Las decisiones adoptadas automáticamente están activas de inmediato, pero siguen visibles en la cola de revisión para que los miembros del equipo puedan inspeccionarlas o ajustarlas en cualquier momento.
Sustituir y reemplazar decisiones
Los requisitos de ingeniería evolucionan con el tiempo. Cuando una decisión recién propuesta contradice o sustituye a una anterior, Mios señala la relación.
En la tarjeta de revisión, Mios destaca la decisión anterior en conflicto dentro de su lista de entradas en disputa. Al adoptar la nueva decisión:
- La nueva decisión pasa a ser la pauta activa del proyecto.
- La decisión anterior se marca como superseded, de modo que se conserva el contexto histórico sin confundir a los agentes.
- Los agentes de código que trabajen en tareas futuras ven la decisión actualizada junto con una referencia a la decisión sustituida.