Compétences architecture-decision-records
📦

architecture-decision-records

Sûr

Créer des enregistrements de décisions d'architecture

Également disponible depuis: wshobson

Cette compétence aide les équipes à documenter des décisions techniques importantes avec des modèles structurés. Elle fournit des formats ADR complets, des conseils de gestion du cycle de vie et des meilleures pratiques pour capturer le contexte, les compromis et la justification.

Prend en charge: Claude Codex Code(CC)
🥉 75 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "architecture-decision-records". Create an ADR for adopting TypeScript for our frontend project

Résultat attendu:

Un document ADR complet avec Statut : Accepté, Contexte sur les défis actuels de la base de code React, Décision d'adopter TypeScript, Conséquences couvrant les aspects positifs (sécurité des types, support IDE) et négatifs (courbe d'apprentissage, complexité de construction), et Atténuations incluant des sessions de formation.

Utilisation de "architecture-decision-records". Document the deprecation of our legacy authentication service

Résultat attendu:

Un ADR de dépréciation avec statut indiquant qu'il remplace l'ADR-0015, Contexte listant les problèmes avec le service actuel, Plan de migration avec approche par phases, et Enseignements tirés sur ce qui n'a pas fonctionné avec la décision originale.

Audit de sécurité

Sûr
v1 • 2/24/2026

Security analysis confirms this is a safe documentation skill. Static findings for external_commands, network, and weak_crypto are false positives. The skill contains markdown templates, example CLI commands (shown as documentation), and reference URLs to external documentation. No executable code, no data exfiltration, no cryptographic operations.

1
Fichiers analysés
444
Lignes analysées
0
résultats
1
Total des audits
Aucun problème de sécurité trouvé

Motifs détectés

False Positive: External Commands DetectionFalse Positive: Network DetectionFalse Positive: Weak Cryptographic Algorithm
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
100
Conformité aux spécifications

Ce que vous pouvez construire

Documenter la sélection d'une technologie de base de données

Lors du choix entre PostgreSQL, MySQL ou MongoDB pour un nouveau projet, utilisez le modèle ADR standard pour capturer les exigences, comparer les options et enregistrer la décision avec une justification complète.

Enregistrer les décisions de migration de framework

Lors de la planification d'une migration d'Angular vers React, créez un ADR de dépréciation pour documenter les raisons du changement, les phases de migration et les enseignements tirés de la décision précédente.

Établir des processus de décision d'équipe

Lors de l'intégration de nouveaux membres de l'équipe, utilisez les modèles ADR pour les aider à comprendre les choix architecturaux passés et le raisonnement derrière l'architecture actuelle.

Essayez ces prompts

Demande d'ADR de base 
Create an Architecture Decision Record for [DECISION_TITLE]. Use the Standard MADR format. Include context about why we need to make this decision, the options we considered, our final decision, and the consequences.
Comparaison de technologies 
Create an ADR comparing [TECHNOLOGY_A], [TECHNOLOGY_B], and [TECHNOLOGY_C] for our [USE_CASE]. Include detailed pros and cons for each option, our requirements, and recommend the best choice with rationale.
Enregistrement de dépréciation 
Create a deprecation ADR for [OLD_TECHNOLOGY] which is being replaced by [NEW_TECHNOLOGY]. Include the context of why the original decision was made, what changed, the migration plan, and lessons learned.
Proposition de style RFC 
Create a detailed RFC-style ADR for [PROPOSAL]. Include motivation, detailed design, drawbacks, alternatives considered, unresolved questions, and implementation plan. Make it suitable for team review and discussion.

Bonnes pratiques

  • Rédiger les ADR avant le début de l'implémentation pour capturer avec précision le contexte de décision
  • Inclure des compromis honnêtes et les inconvénients potentiels dans la section des conséquences
  • Lier les ADR connexes pour construire un graphe de dépendance des décisions pour le projet
  • Mettre à jour le statut des ADR lorsque les décisions sont dépréciées ou remplacées

Éviter

  • Rédiger des décisions vagues sans contexte spécifique ni justification
  • Ignorer la section des alternatives pour éviter de montrer que d'autres options ont été envisagées
  • Modifier les ADR acceptés au lieu d'en créer de nouveaux pour les remplacer
  • Créer des ADR pour des décisions mineures qui ne justifient pas une documentation architecturale

Foire aux questions

Qu'est-ce qu'un enregistrement de décision d'architecture ?
Un enregistrement de décision d'architecture (ADR) est un document qui capture des décisions architecturales importantes prises au cours d'un projet. Il comprend généralement le contexte, la décision elle-même et les conséquences de cette décision.
Quand dois-je créer un ADR ?
Créez un ADR lorsque vous prenez des décisions architecturales importantes telles que l'adoption d'un framework, le choix d'une technologie de base de données, des modèles de conception d'API, l'architecture de sécurité ou des modèles d'intégration. Évitez les ADR pour les corrections mineures ou la maintenance de routine.
Quel format ADR dois-je utiliser ?
Utilisez le format MADR standard pour les décisions complètes, le format léger pour les décisions rapides, Y-Statement pour les choix brefs et le style RFC pour les propositions complexes nécessitant une revue d'équipe.
Comment lier des ADR connexes ?
Incluez une section Décisions connexes dans chaque ADR qui référence d'autres ADR par numéro. Utilisez des indicateurs de statut comme 'Remplace l'ADR-0003' ou 'Complète l'ADR-0002' pour montrer les relations.
Puis-je modifier un ADR accepté ?
Non. Les ADR acceptés ne doivent jamais être modifiés. Créez plutôt un nouvel ADR qui remplace l'ancien et documentez ce qui a changé et pourquoi.
Quels outils peuvent aider à gérer les ADR ?
adr-tools est un outil CLI populaire pour gérer les ADR. Il peut initialiser des répertoires, créer de nouveaux ADR, générer des tables des matières et lier des décisions connexes.

Détails du développeur

Auteur

sickn33

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-records

Réf

main

Structure de fichiers

📄 SKILL.md