AI CodeOps

Agente ADR Writer

El agente ADR Writer convierte un modelo de amenazas en un registro de decisión de arquitectura con contexto, decisión, consecuencias y alternativas, guardado como ADR propuesto.

El agente ADR Writer registra decisiones. Escribe un registro de decisión de arquitectura (ADR) estructurado en cuatro partes: Context, Decision, Consequences y Alternatives.

Dónde se ejecuta

Flujo de trabajoPaso
Threat ModelRecord ADR

Threat Model tiene tres pasos. El Architect describe el alcance y cómo fluyen los datos por el sistema. El Security Auditor hace sobre eso un análisis STRIDE: suplantación de identidad, manipulación, repudio, divulgación de información, denegación de servicio y elevación de privilegios. Después, el ADR Writer registra el resultado como una decisión.

Entradas

  • La tarea de la sesión, por ejemplo «Haz el modelo de amenazas de la nueva API pública de webhooks».
  • Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto.
  • El alcance y el análisis STRIDE de los dos pasos anteriores.

Salidas

Un ADR en texto, con Context, Decision, Consequences y Alternatives.

La plataforma lo guarda en el registro de ADR del espacio de trabajo como una decisión proposed (propuesta), vinculada a la sesión y al paso del agente, y también al proyecto cuando la sesión tiene uno. Su título se toma de la primera línea con contenido del ADR. Una respuesta muy corta no se guarda, porque no decide nada.

Guardarlo como propuesto es deliberado. Una decisión escrita por la IA entra en el mismo flujo de revisión que una escrita por una persona, así que el registro nunca ratifica una decisión que nadie ha mirado.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. Matt ejecuta Threat Model sobre una nueva funcionalidad de webhooks. El Architect traza el flujo: el cliente configura una URL, la plataforma firma y envía los eventos, y el servidor del cliente los verifica. El Security Auditor señala la falsificación de peticiones hacia direcciones internas, la repetición de eventos y la filtración de secretos en los logs. El ADR Writer registra la decisión: bloquear los rangos de direcciones privadas como destino de los webhooks, firmar cada evento con una marca de tiempo y rechazar los antiguos, y no escribir nunca el secreto de firma en los logs. Enumera las consecuencias, como que los clientes en redes privadas necesitarán un relé, y la alternativa descartada de usar una lista de IP permitidas. El ADR aparece en el registro como proposed.

Límites

  • Su decisión es tan buena como el análisis que la precede. No añade investigación de seguridad propia.
  • Solo se ejecuta en Threat Model. Architecture Debate y Discovery & Spec también guardan ADR propuestos, pero a partir de la síntesis final del Architect y de los requisitos del Product Analyst, no a partir de este agente.
  • No comprueba que la decisión se haya implementado.

Preguntas frecuentes

¿Un ADR escrito por el agente se acepta automáticamente?

No. Se guarda con el estado proposed. Una persona del espacio de trabajo lo acepta o lo rechaza, igual que un ADR escrito a mano.

¿Qué pasa si vuelvo a ejecutar la misma sesión de Threat Model?

El id del ADR viene de la sesión, así que volver a ejecutar esa sesión actualiza su ADR en lugar de añadir un duplicado.