Communitygithub.com

andresnator/agents-orchestrator

Créez des Architecture Decision Records (ADR) concis qui expliquent une décision, le contexte qui l'a imposée, les options envisagées et les conséquences acceptées.

Qu'est-ce que agents-orchestrator ?

Cette compétence aide à créer des Architecture Decision Records (ADR), des documents formels qui enregistrent pourquoi une décision technique ou architecturale a été prise. Elle est utile pour tout développeur ou équipe souhaitant documenter les choix d'architecture de manière structurée et claire, en particulier dans des environnements de développement logiciel ou de conception de systèmes. La compétence fonctionne en mode entretien, posant des questions ciblées (une à la fois) dans la langue de l'utilisateur pour recueillir les informations nécessaires : titre, contexte, option choisie, alternatives, et conséquences. Elle respecte des règles strictes : ne pas inventer d'alternatives, ne pas créer de fichiers sans demande explicite, et formater les sorties en Markdown. L'ADR final peut être retourné comme un bloc de code ou sauvegardé dans un fichier spécifié. La compétence utilise un modèle de document situé dans `assets/template-markdown.md`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add andresnator/agents-orchestrator

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Créateur d'ADR

Créez des Architecture Decision Records (ADR) concis qui expliquent une décision, le contexte qui l'a imposée, les options envisagées et les conséquences acceptées.

Contrat d'activation

Utilisez cette compétence lorsque l'utilisateur demande un ADR, un enregistrement de décision d'architecture, un enregistrement de décision technique, ou tout enregistrement formel expliquant pourquoi un choix technique ou architectural a été fait.

Par défaut, passez en mode entretien sauf si l'utilisateur a déjà fourni suffisamment d'informations pour rédiger un ADR complet. Posez les questions d'entretien dans la langue de l'utilisateur. L'artefact ADR est en anglais sauf si l'utilisateur demande explicitement une autre langue.

Règles strictes

  • Posez une question à la fois en mode entretien.
  • Indiquez une fois au début de l'entretien que l'utilisateur peut sauter des questions ou arrêter l'entretien à tout moment.
  • Maintenez un compteur dynamique de questions restantes estimées ; mettez-le à jour lorsque des dépendances apparaissent ou disparaissent.
  • Recommandez des exemples de réponse courts lorsqu'ils aident l'utilisateur à répondre.
  • Formatez les questions d'entretien en Markdown lisible, pas en texte brut.
  • Remettez en question de manière constructive les réponses vagues, contradictoires ou sans justification avant de rédiger ; poursuivez si l'utilisateur dit explicitement de continuer quand même.
  • N'inventez pas d'alternatives, d'avantages, d'inconvénients ou de justifications. Demandez lorsque des alternatives manquent.
  • Utilisez Accepted lorsque la décision est déjà prise ; utilisez Proposed pour les propositions, évaluations ou statuts incertains.
  • Écrivez ou modifiez des fichiers uniquement lorsque l'utilisateur demande explicitement un fichier/chemin.

Déroulement de l'entretien

Recueillez uniquement ce qui est nécessaire, en priorisant les dépendances :

  1. Titre et statut de la décision.
  2. Contexte : problème, contraintes, forces et pourquoi la décision est importante maintenant.
  3. Option ou proposition choisie.
  4. Options envisagées, avec avantages et inconvénients pour chacune.
  5. Conséquences : bénéfices, inconvénients, risques et compromis.
  6. Suivi uniquement lorsqu'il y a des actions ouvertes ou des questions non résolues utiles.

Format des questions :

### Question N — [question ciblée]

**Réponse recommandée :** [exemple court quand c'est utile]

**Pourquoi c'est important :** [brève raison]

**Questions restantes estimées :** ~M

Mini exemple :

### Question 1 — Cette décision est-elle déjà prise ou encore en cours de proposition ?

**Réponse recommandée :** "Acceptée — nous avons déjà choisi PostgreSQL pour les données de facturation."

**Pourquoi c'est important :** Le statut change si l'ADR enregistre un choix final ou une proposition en cours d'examen.

**Questions restantes estimées :** ~5

Contrat de sortie

Lisez assets/template-markdown.md avant de rédiger et remplissez cette structure.

Par défaut, retournez l'ADR final exactement comme un bloc de code Markdown et ne créez pas de fichiers. Si l'utilisateur a explicitement demandé un fichier/chemin, sauvegardez l'ADR à cet emplacement et résumez le chemin sauvegardé dans le chat.

Ne laissez jamais d'instructions génériques dans l'ADR final. Si l'utilisateur saute intentionnellement un détail obligatoire, utilisez TBD avec parcimonie et uniquement pour ce détail sauté.

Référence

  • Modèle : assets/template-markdown.md

Skills associés