AI CodeOps

Décision d'architecture : deux conceptions, un critique et un ADR

Mis à jour le

Tranchez une question de conception avec Architecture Debate : deux propositions d'Architect, la critique d'un Reviewer et une synthèse finale, enregistrée en ADR proposé à une personne.

Utiliser ce template

Utilisez ce template lorsqu'une équipe rouvre sans cesse la même question de conception. Architecture Debate produit deux propositions concurrentes, une critique des deux et une décision écrite, avant que quiconque ne construise quoi que ce soit.

Quels agents interviennent

ÉtapeAgent
Architect AArchitect
Architect BArchitect
Critic reviewReviewer
Final synthesisArchitect

Les étapes s'exécutent l'une après l'autre, et chacune voit ce qui l'a précédée. Architect B lit la première proposition : formulez donc la tâche comme un vrai choix (« une file d'attente, ou garder cron ») plutôt que comme une seule idée à développer. Le critique lit les deux propositions, et la synthèse finale pèse les trois.

Ce que vous obtenez

Lorsque la session se termine, la synthèse finale est enregistrée comme enregistrement de décision d'architecture à l'état proposed, lié à la session. Rien n'est accepté sur la seule parole de l'IA : une personne l'accepte ou le rejette sous Plan → ADRs.

Architecture Debate ne modifie aucun code. La session se termine avec ses documents et l'enregistrement proposé : il n'y a ni diff, ni exécution de tests, ni approbation pour en appliquer un. Pour conserver aussi la décision dans le dépôt, lancez une session Plan, Build, Review & Test qui la demande sous forme de fichier Markdown dans docs/adr/. Ce changement suit le parcours normal : votre commande de test s'exécute dessus, la revue par IA lit le diff et enregistre des constats, et une personne autre que celle qui a lancé la session l'approuve avant l'ouverture de la pull request.

Plafonner ce qu'un débat peut dépenser

Avec le niveau de modèles Auto, l'Architect compte comme une étape de pilotage et reçoit le meilleur niveau que permet votre quota, et ce workflow l'exécute trois fois. Sous Configure → Billing, définissez un budget pour l'espace de travail, puis choisissez Edit limits et donnez à Architecture Debate son propre plafond :

ChampExemple de valeur
PeriodMonthly
Hard limit (USD)200
Per-workflow caps (USD)Architecture Debate: 15

Le plafond couvre toutes les sessions Architecture Debate de la période. Une fois que leurs dépenses l'atteignent, la suivante est refusée et une session en cours s'arrête avec Blocked by budget. Consultez Maîtrise des coûts.

Conseils

  • Mettez les contraintes dans la tâche : volume de données, qui exploite le service en production, ce qui ne doit pas changer.
  • Posez une seule question par session. Deux questions donnent deux demi-réponses.
  • Si l'issue est serrée, envoyez un suivi avec les points ouverts du critique au lieu de tout recommencer.
  • Une fois la décision acceptée, cadrez le travail avec le template de spécification de fonctionnalité.

Questions fréquentes

Les deux architectes travaillent-ils en même temps ?

Non. Architect B s'exécute après Architect A et lit sa proposition. Debate décrit la façon dont les étapes se répartissent le travail, pas leur déroulement dans le temps.

L'ADR est-il accepté automatiquement ?

Non. Il est enregistré à l'état proposed. Une personne le fait passer à accepted ou rejected sous Plan, ADRs.

La session modifiera-t-elle le code de mon application ?

Non. Architecture Debate écrit uniquement des documents. La session se termine avec l'enregistrement de décision, sans diff ni pull request.