AI CodeOps

Agent ADR Writer

L'agent ADR Writer fait d'un modèle de menaces un enregistrement de décision d'architecture avec contexte, décision, conséquences et alternatives, consigné comme ADR proposed.

L'agent ADR Writer consigne les décisions. Il rédige un enregistrement de décision d'architecture (ADR) structuré en quatre parties : Context, Decision, Consequences et Alternatives.

Où il intervient

WorkflowÉtape
Threat ModelRecord ADR

Threat Model comporte trois étapes. L'Architect décrit le périmètre et la façon dont les données circulent dans le système. Le Security Auditor en fait une analyse STRIDE : usurpation d'identité, falsification, répudiation, divulgation d'informations, déni de service et élévation de privilèges. L'ADR Writer consigne ensuite le résultat sous forme de décision.

Entrées

  • La tâche de la session, par exemple « modéliser les menaces de la nouvelle API publique de webhooks ».
  • Un instantané en lecture seule des fichiers pertinents du dépôt du projet.
  • Le périmètre et l'analyse STRIDE des deux étapes précédentes.

Sorties

Un ADR sous forme de texte, avec Context, Decision, Consequences et Alternatives.

La plateforme l'enregistre dans le journal des ADR de l'espace de travail comme décision proposed (proposée), liée à la session et à l'étape de l'agent, ainsi qu'au projet lorsque la session en a un. Son titre est tiré de la première ligne significative de l'enregistrement. Une réponse très courte n'est pas enregistrée, car elle ne tranche rien.

L'enregistrement à l'état proposed est délibéré. Une décision rédigée par l'IA suit le même circuit de revue qu'une décision rédigée par une personne : le journal n'entérine donc jamais une décision que personne n'a examinée.

Exemple d'exécution

Exemple illustratif, pas une session enregistrée. Matt lance Threat Model sur une nouvelle fonctionnalité de webhooks. L'Architect cartographie le flux : le client configure une URL, la plateforme signe et envoie les événements, le serveur du client les vérifie. Le Security Auditor signale la falsification de requêtes vers des adresses internes, le rejeu d'événements et les fuites de secrets dans les journaux. L'ADR Writer consigne la décision : bloquer les plages d'adresses privées comme cibles de webhook, signer chaque événement avec un horodatage et rejeter les anciens, et ne jamais journaliser le secret de signature. Il énumère les conséquences, par exemple le besoin d'un relais pour les clients sur des réseaux privés, ainsi que l'alternative écartée d'une liste d'adresses IP autorisées. L'ADR apparaît dans le journal à l'état proposed.

Limites

  • Sa décision ne vaut que ce que vaut l'analyse qui la précède. Il n'ajoute aucune recherche de sécurité qui lui soit propre.
  • Il ne s'exécute que dans Threat Model. Architecture Debate et Discovery & Spec enregistrent aussi des ADR à l'état proposed, mais à partir de la synthèse finale de l'Architect et des exigences du Product Analyst, et non de cet agent.
  • Il ne vérifie pas que la décision a été mise en œuvre.

Questions fréquentes

Un ADR rédigé par l'agent est-il accepté automatiquement ?

Non. Il est enregistré avec le statut proposed. Une personne de l'espace de travail l'accepte ou le rejette, comme un ADR rédigé à la main.

Que se passe-t-il si je relance la même session Threat Model ?

L'identifiant de l'ADR vient de la session, de sorte qu'une relance de cette session met à jour son ADR au lieu d'en ajouter un doublon.