¿Quién puede crear un ADR?

Considere aspectos como personas específicas, roles específicos, equipos específicos o departamentos específicos; considere también si hay personas, roles, equipos o departamentos que puedan encargar un ADR, es decir, solicitar uno que otra persona redactará.

Respuesta de ejemplo: cualquier persona de nuestra organización que haya leído la página README del registro de decisión de arquitectura puede proponer un ADR, es decir, puede empezar a redactarlo y compartirlo con el equipo.

¿Qué justifica elaborar un ADR?

Considere aspectos como las formas de trabajo de los equipos de su organización, la estructura de su sistema de software, la coordinación entre equipos, la mantenibilidad a largo plazo, las interfaces externas, a quién quiere beneficiar y similares.

Respuesta de ejemplo: queremos crear un ADR cuando queremos que los futuros desarrolladores comprendan el «porqué» de lo que hacemos.

¿Qué justifica no elaborar un ADR?

Considere aspectos como las decisiones que no son de arquitectura, o que son pequeñas, por ejemplo de riesgo mínimo, autocontenidas o de un solo desarrollador, o que ya están totalmente cubiertas en otro lugar, como en estándares, políticas o documentación, o que son temporales, como soluciones provisionales, pruebas de concepto o experimentos.

Respuesta de ejemplo: queremos omitir un ADR cuando una decisión tiene alcance, tiempo, riesgo y costo limitados, o ya está cubierta en otro lugar.

¿Cuál es el ciclo de vida de un ADR?

Considere aspectos como el proceso de creación, el proceso de investigación, el proceso de decisión, el proceso de implementación y el proceso de retiro. Considere cómo hacer el seguimiento del ciclo de vida del ADR a lo largo del tiempo, por ejemplo, cómo pasar el ADR de un estado al siguiente, y también cómo comunicarlo a las partes interesadas.

Respuesta de ejemplo: queremos que un ADR tenga cinco etapas de ciclo de vida: Inicio → Investigación → Evaluación → Implementación → Mantenimiento → Retiro.

¿Cuáles son los criterios para las etapas del ciclo de vida de un ADR?

Considere aspectos como los criterios de aceptación de un ADR, es decir, ¿cómo sabe que es lo bastante bueno para pasar de una etapa del ciclo de vida a la siguiente? ¿Se ha expresado el problema con claridad? ¿Se han considerado las alternativas? ¿Se comprenden y documentan lo bastante bien las compensaciones (trade-offs)? ¿Está presente todo el contexto relevante? ¿Participan todas las partes interesadas relevantes? ¿Se ha incorporado todo el feedback?

Respuesta de ejemplo: queremos que las partes interesadas voten un ADR cuando el equipo activo haya 1) completado su investigación, 2) completado su evaluación, 3) publicado la propuesta de ADR para las partes interesadas con una solicitud de comentarios y un plazo de una semana, 4) incorporado y atendido todos los comentarios de las partes interesadas.

¿Qué roles y responsabilidades interactúan con un ADR?

Considere roles como proponente, investigador, evaluador, revisor, aprobador, mantenedor y similares. Considere responsabilidades como la comunicación con las partes interesadas, asegurar que se cumplan las expectativas, compartir en el sitio web o la intranet, y revisar el trabajo periódicamente y, en especial, cuando ocurran cambios relevantes.

Respuesta de ejemplo: queremos que cada ADR tenga siempre una persona de contacto principal, una persona de contacto secundaria y un equipo responsable; estos se encargan de las comunicaciones, las publicaciones, el mantenimiento, la revisión periódica al menos una vez al año y, llegado el caso, el retiro final.

¿Cómo interactúa la gobernanza con un ADR?

Considere aspectos como las formas de trabajo de su organización, cualquier necesidad especial de cumplimiento, por ejemplo en aspectos legales o de recursos humanos, y cómo quiere manejar el consenso frente al conflicto frente a la escalación. ¿Hay áreas, personas o equipos que puedan tener más influencia que otros respecto de un ADR, por ejemplo, poder aprobarlo, votarlo o vetarlo?

Respuesta de ejemplo: la gobernanza de un ADR sigue este orden de prioridad: el CEO, el CTO, el CLO, el equipo que implementa un ADR, los expertos del equipo que más conocen el ADD. Nadie más tiene gobernanza, a menos que se describa en el ADR.

¿Qué principios interactúan con un ADR?

Considere aspectos como las formas de trabajo de su organización que incluyen avanzar rápido frente a avanzar despacio, consenso en las decisiones frente a conflicto en las decisiones, preferencias de riesgo frente a preferencias de seguridad, discusión pública frente a discusión privada y similares.

Respuesta de ejemplo: usamos los principios de liderazgo de sesgo hacia la acción, disentir y comprometerse (disagree-and-commit), estimaciones del 70 % suficientes para decisiones fáciles de revertir y de aislar, y formas de trabajo públicas, con excepción de la información confidencial según se describe en el acuerdo de confidencialidad de nuestra organización.