المهارات architecture-decision-record

📋

architecture-decision-record

Name: architecture-decision-record
Author: AI Agent Hub

آمن ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة

Documenter les décisions architecturales avec des ADR

Les équipes ont du mal à se souvenir pourquoi des décisions architecturales ont été prises, ce qui entraîne des débats répétés et des reprises. Cette compétence fournit des modèles et des exemples pour créer des Architecture Decision Records qui capturent le contexte, les alternatives et les compromis afin que les équipes maintiennent une mémoire architecturale pour référence future.

يدعم: Claude Codex Code(CC)

📊 69 كافٍ

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "architecture-decision-record". Create an ADR for choosing PostgreSQL as our primary database

النتيجة المتوقعة:

L'ADR inclura : Statut (Accepted), Contexte avec exigences et contraintes, section Décision avec choix technologiques spécifiques, Conséquences (positives, négatives, neutres), Alternatives envisagées (MySQL, MongoDB, DynamoDB) avec avantages/inconvénients et justification du rejet, Références à la documentation

استخدام "architecture-decision-record". Document our microservices migration decision

النتيجة المتوقعة:

L'ADR couvrira : Contexte du problème (problèmes d'évolutivité, goulots d'étranglement de déploiement), Décision d'adopter les microservices avec une stack technologique spécifique, Conséquences avec des compromis honnêtes, Alternatives évaluées (optimiser le monolithe, serverless) avec raisons du rejet

التدقيق الأمني

آمن

v5 • 1/16/2026

Pure documentation skill containing only markdown templates and guidance. No executable code, scripts, network operations, or file system access. All static scanner findings are false positives caused by the scanner misinterpreting markdown syntax and documentation text as code/security issues. Prior audit correctly identified this as safe with zero risk factors.

الملفات التي تم فحصها

2,022

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

عوامل الخطر

⚙️ الأوامر الخارجية (39)

🌐 الوصول إلى الشبكة (18)

examples/adr-0001-adopt-microservices.md:286 examples/adr-0001-adopt-microservices.md:288 examples/adr-0001-adopt-microservices.md:291 examples/adr-0001-adopt-microservices.md:296 examples/adr-0001-adopt-microservices.md:307 examples/adr-0001-adopt-microservices.md:308 examples/adr-0002-choose-postgresql.md:231 examples/adr-0002-choose-postgresql.md:232 examples/adr-0002-choose-postgresql.md:233 examples/adr-0003-api-versioning-strategy.md:281 examples/adr-0003-api-versioning-strategy.md:282 examples/adr-0003-api-versioning-strategy.md:283 examples/adr-0003-api-versioning-strategy.md:284 skill-report.json:6 templates/adr-frontmatter.yaml:65 templates/adr-frontmatter.yaml:70 templates/adr-frontmatter.yaml:72 templates/adr-frontmatter.yaml:76

تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

100

الأمان

الامتثال للمواصفات

ماذا يمكنك بناءه

Documenter l'architecture du système

Enregistrer les principaux choix architecturaux avec tout le contexte pour référence de l'équipe et alignement des parties prenantes

Établir des standards techniques

Créer des enregistrements des décisions de sélection de technologies incluant les choix de base de données, framework et infrastructure

Capturer la justification des décisions

Documenter pourquoi certaines approches ont été choisies afin que les futurs membres de l'équipe comprennent le raisonnement

جرّب هذه الموجهات

Sélection de base de données

Créez un ADR pour documenter notre décision de sélection de base de données entre PostgreSQL, MongoDB et DynamoDB. Incluez le contexte de notre architecture microservices, les exigences de conformité ACID et la comparaison des compromis.

Versionnement d'API

Documentez notre décision de stratégie de versionnement d'API. Comparez le versionnement par chemin d'URL versus le versionnement basé sur les en-têtes versus le versionnement par paramètres de requête. Expliquez pourquoi nous avons choisi le versionnement par chemin d'URL.

Migration d'architecture

Créez un ADR pour migrer d'un monolithe vers des microservices. Incluez l'approche du pattern strangler fig, un plan de mise en œuvre phase par phase, et une évaluation honnête des conséquences.

Stack technologique

Documentez la sélection de notre stack technologique pour un nouveau service backend. Couvrez les choix de langage de programmation, framework, base de données et infrastructure de déploiement avec une justification claire pour chaque décision.

أفضل الممارسات

Rédigez les ADR au présent comme des enregistrements historiques qui capturent les décisions au moment où elles ont été prises
Documentez au moins deux alternatives avec des avantages et des inconvénients honnêtes pour démontrer une évaluation approfondie
Gardez les ADR immuables après acceptation - créez de nouveaux ADR pour remplacer plutôt que modifier ceux existants

تجنب

Utiliser un langage vague comme "nous pourrions envisager d'utiliser" au lieu de décisions claires comme "nous adopterons"
Lister uniquement des conséquences positives sans reconnaître honnêtement les coûts, les risques et les compromis
Ignorer les alternatives ou présenter uniquement des options manifestement inférieures comme hommes de paille

الأسئلة المتكررة

Quelle est la différence entre ceci et un document de conception ?

Les ADR se concentrent spécifiquement sur le pourquoi des décisions, pas sur les détails d'implémentation. Ils capturent les compromis et les alternatives envisagées.

Combien d'ADR un projet devrait-il avoir ?

Créez des ADR uniquement pour les décisions importantes qui affectent plusieurs composants, nécessitent un alignement de l'équipe ou impliquent des compromis.

Les ADR peuvent-ils être intégrés à ma base de code ?

Stockez les ADR dans /docs/adr/ ou /architecture/decisions/ à côté du code. Utilisez le frontmatter YAML pour l'intégration avec les outils.

Mes données sont-elles en sécurité lorsque j'utilise cette compétence ?

Oui. Cette compétence ne génère que des modèles de documentation. Aucune donnée n'est envoyée où que ce soit ni stockée en externe.

Pourquoi devrais-je documenter les alternatives que j'ai rejetées ?

Documenter les alternatives évite des débats répétés. Les futurs membres de l'équipe peuvent comprendre pourquoi certaines approches ont été envisagées et rejetées.

Comment cela se compare-t-il aux ADR dans d'autres outils ?

Cette compétence fournit les modèles et exemples au format Nygard. L'intégration avec des outils spécifiques dépend de votre workflow.