Fähigkeiten architecture-decision-records
📦

architecture-decision-records

Sicher

Architecture Decision Records erstellen

Auch verfügbar von: wshobson

Diese Skill hilft Teams dabei, bedeutende technische Entscheidungen mit strukturierten Vorlagen zu dokumentieren. Sie bietet umfassende ADR-Formate, Anleitungen zum Lifecycle-Management und Best Practices für die Erfassung von Kontext, Abwägungen und Begründungen.

Unterstützt: Claude Codex Code(CC)
🥉 75 Bronze
1

Die Skill-ZIP herunterladen

2

In Claude hochladen

Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen

3

Einschalten und loslegen

Teste es

Verwendung von "architecture-decision-records". Create an ADR for adopting TypeScript for our frontend project

Erwartetes Ergebnis:

Ein vollständiges ADR-Dokument mit Status: Accepted, Kontext über aktuelle Herausforderungen mit der React-Codebase, Entscheidung zur Adoption von TypeScript, Konsequenzen mit guten (Typsicherheit, IDE-Support) und schlechten Aspekten (Lernkurve, Build-Komplexität) sowie Maßnahmen einschließlich Trainingssitzungen.

Verwendung von "architecture-decision-records". Document the deprecation of our legacy authentication service

Erwartetes Ergebnis:

Ein Deprekations-ADR mit Status, der anzeigt, dass er ADR-0015 ersetzt, Kontext mit Auflistung der Probleme des aktuellen Dienstes, Migrationsplan mit phasenweisem Ansatz und gewonnenen Erkenntnissen darüber, was bei der ursprünglichen Entscheidung schiefgelaufen ist.

Sicherheitsaudit

Sicher
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
Gescannte Dateien
444
Analysierte Zeilen
0
befunde
1
Gesamtzahl Audits
Keine Sicherheitsprobleme gefunden

Erkannte Muster

False Positive: External Commands DetectionFalse Positive: Network DetectionFalse Positive: Weak Cryptographic Algorithm
Auditiert von: claude

Qualitätsbewertung

38
Architektur
100
Wartbarkeit
87
Inhalt
50
Community
100
Sicherheit
100
Spezifikationskonformität

Was du bauen kannst

Dokumentation der Datenbank-Technologieauswahl

Bei der Wahl zwischen PostgreSQL, MySQL oder MongoDB für ein neues Projekt verwenden Sie die Standard-ADR-Vorlage, um Anforderungen zu erfassen, Optionen zu vergleichen und die Entscheidung mit vollständiger Begründung zu dokumentieren.

Dokumentation von Framework-Migrationsentscheidungen

Bei der Planung einer Migration von Angular zu React erstellen Sie ein Deprekations-ADR, um die Gründe für die Änderung, Migrationsphasen und gewonnene Erkenntnisse aus der vorherigen Entscheidung zu dokumentieren.

Etablierung von Team-Entscheidungsprozessen

Beim Onboarding neuer Teammitglieder verwenden Sie die ADR-Vorlagen, um ihnen zu helfen, vergangene architektonische Entscheidungen und die Begründung hinter der aktuellen Architektur zu verstehen.

Probiere diese Prompts

Einfache ADR-Anfrage 
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.
Technologievergleich 
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.
Deprekationsdokument 
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.
RFC-artiger Vorschlag 
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.

Bewährte Verfahren

  • ADRs vor Beginn der Implementierung schreiben, um den Entscheidungskontext präzise festzuhalten
  • Im Konsequenzen-Abschnitt ehrliche Abwägungen und potenzielle Nachteile einbeziehen
  • Verwandte ADRs verknüpfen, um einen Entscheidungsabhängigkeitsgraphen für das Projekt aufzubauen
  • ADR-Status aktualisieren, wenn Entscheidungen deprekiert oder ersetzt werden

Vermeiden

  • Vage Entscheidungen ohne spezifischen Kontext oder Begründung schreiben
  • Den Alternativen-Abschnitt überspringen, um zu vermeiden, dass andere berücksichtigte Optionen sichtbar werden
  • Akzeptierte ADRs ändern, anstatt neue zu erstellen, um sie zu ersetzen
  • ADRs für kleinere Entscheidungen erstellen, die keine architektonische Dokumentation rechtfertigen

Häufig gestellte Fragen

Was ist ein Architecture Decision Record?
Ein Architecture Decision Record (ADR) ist ein Dokument, das wichtige architektonische Entscheidungen festhält, die während eines Projekts getroffen wurden. Es umfasst typischerweise den Kontext, die Entscheidung selbst und die Konsequenzen dieser Entscheidung.
Wann sollte ich ein ADR erstellen?
Erstellen Sie ein ADR bei bedeutenden architektonischen Entscheidungen wie Framework-Adoption, Datenbank-Technologieauswahl, API-Designmustern, Sicherheitsarchitektur oder Integrationsmustern. Überspringen Sie ADRs für kleinere Patches oder routinemäßige Wartung.
Welches ADR-Format sollte ich verwenden?
Verwenden Sie das Standard-MADR-Format für umfassende Entscheidungen, das leichtgewichtige Format für schnelle Entscheidungen, Y-Statement für kurze Auswahlmöglichkeiten und RFC-artig für komplexe Vorschläge, die eine Team-Prüfung erfordern.
Wie verknüpfe ich verwandte ADRs?
Fügen Sie in jedem ADR einen Abschnitt für verwandte Entscheidungen hinzu, der andere ADRs nach Nummer referenziert. Verwenden Sie Statusindikatoren wie 'Ersetzt ADR-0003' oder 'Ergänzt ADR-0002', um Beziehungen anzuzeigen.
Kann ich ein akzeptiertes ADR ändern?
Nein. Akzeptierte ADRs dürfen niemals geändert werden. Erstellen Sie stattdessen ein neues ADR, das das alte ersetzt, und dokumentieren Sie, was sich geändert hat und warum.
Welche Tools können beim ADR-Management helfen?
adr-tools ist ein beliebtes CLI-Tool für das ADR-Management. Es kann Verzeichnisse initialisieren, neue ADRs erstellen, Inhaltsverzeichnisse generieren und verwandte Entscheidungen verknüpfen.

Entwicklerdetails

Autor

sickn33

Lizenz

MIT

Repository

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

Ref

main

Dateistruktur

📄 SKILL.md