📋 ADR (Architecture Decision Records)

Formalisieren Sie in 30-60 Minuten einen rigorosen ADR für jede strukturierende Entscheidung, der von Grund auf 2-3 Stunden dauern würde.

ADRs (Architecture Decision Records) dokumentieren strukturierende Entscheidungen: warum PostgreSQL statt MongoDB, warum Kafka statt RabbitMQ, warum dieses Authentifizierungsmuster. Gut geschrieben, sparen sie Jahre "warum haben wir das doch gleich gewählt?" und erleichtern Onboarding. KI ermöglicht schnelle Produktion mit Rigorosität. Diese Anleitung präsentiert den Workflow.

Schritt-für-Schritt-Workflow
1
Entscheidungskontext beschreiben

Welches Problem lösen wir, welche Einschränkungen (Perf, Team, Budget, Time-to-Market), welche Optionen wurden erwogen, wer entscheidet und wer ist betroffen.

2
Erwogene Optionen auflisten

Mindestens 3 ernsthafte Optionen mit ihren Eigenschaften. KI hilft zu strukturieren (nichts vergessen und keine Unrealisten erfinden).

3
Nach relevanten Kriterien vergleichen

Kriterien je nach Kontext: Performance, Skalierbarkeit, Lernkurve, Ökosystem, Kosten, Reife, Lock-in. Jede Option bewerten.

4
Entscheiden und Gründe dokumentieren

Gewählte Entscheidung + klare Gründe. Besonders: positive UND negative Konsequenzen, Erfolgsbedingungen, Signale für Neubewertung.

5
Im Repo versionieren

Markdown-Format in /docs/adr/. Nummeriert und datiert. Bleibt lange einsehbar, nachdem die Protagonisten das Team verlassen haben.

Kopierbare Prompts
Vollständiger ADR zu technischer Entscheidung
Du bist Senior-Softwarearchitekt. Formalisiere einen ADR für diese Entscheidung:nn**Kontext** : [PROBLEM ZU LÖSEN]n**Einschränkungen** : [PERF, TEAM, BUDGET, TIMING]n**Erwogene Optionen** : [LISTE 3-5 OPTIONEN]n**Gewählte Entscheidung** : [GEWÄHLTE OPTION]n**Aktueller Stack** : [TECH-KONTEXT]nnProduziere einen ADR nach Michael Nygard Format:nn## Statusn[Proposed / Accepted / Deprecated / Superseded by X]nn## Kontextn[3-5 Absätze: Problem, Einschränkungen, was hat Reflexion ausgelöst]nn## Erwogene Optionenn### Option 1 : [NAME]n- Vorteilen- Nachteilen- Kosten (Lernen, Schuld, Infrastruktur)nn### Option 2 : [NAME]n[gleich]nn## Entscheidungn[Gewählte Option + klare Gründe]nn## Konsequenzenn### Positivn[3-5 erwartete positive Konsequenzen]nn### Negativn[2-4 negative Konsequenzen oder eingegangene Kompromisse]nn## Bedingungen zur Neubewertungn[Signale, die diese Entscheidung in 12-24 Monaten in Frage stellen würden]nnMarkiere [ZU PRÜFEN] jede unsichere Zahl (Perf, Kosten).
Multi-Kriterien-Technologie-Vergleich
Für diese Entscheidung: [TYP TECH — z.B. Message Broker, Datenbank, Frontend-Framework]nn**Kontext** : [DETAILS]n**Einschränkungen** : [LISTE]nnVergleiche diese Optionen nach strukturierenden Kriterien:nn[OPTION 1] vs [OPTION 2] vs [OPTION 3]nnKriterien:n1. **Performance** (Latenz, Durchsatz, Ressourcen)n2. **Skalierbarkeit** (horizontal, vertikal, Grenzen)n3. **Reife und Ökosystem** (stabile Versionen, Community, Dokumentation)n4. **Lernkurve** (aktuelles Team, Rekrutierung)n5. **Lock-in und Portierbarkeit**n6. **Gesamtkosten** (Lizenz, Infrastruktur, Betrieb)n7. **Sicherheit und Compliance**nnFormat: Vergleichstabelle mit Bewertung /10 pro Kriterium, dann argumentierte Empfehlung.
Audit eines existierenden ADR
Audite diesen ADR:nn[ADR]nnProduciere:n1. **Stärken**: Was gut gemacht ist (Rigorosität, Klarheit, Vollständigkeit)n2. **Schwächen**: Was fehlt (fehlende Optionen, unterschätzte negative Konsequenzen, kein Plan B)n3. **Notwendige Updates**: Gegeben die Entwicklung seit Schrift, was im technischen Landschaftsbild hat sich geändertn4. **Empfehlung**: ADR noch gültig / aktualisierungsbedürftig / neuzubewertennnBleibe konstruktiv und sachlich.
Empfohlene Tools
Claude Opus 4.5
Claude Opus 4.5
★ 4.9 (92) · 20 USD/mois

Claude Opus 4.5 : modèle premium d’Anthropic pour code, agents et tâches complexes en entreprise.

Warum : Le meilleur reasoning sur les choix techniques complexes nécessitant la pesée multi-critères et l'anticipation des conséquences.

Claude AI
Claude AI
★ 4.9 (55) · Gratuit

Assistant conversationnel d’Anthropic axé sécurité et contexte long. Excellent pour rédaction, analyse, résumés, code et agents. Interface claire, bons résultats en français.

Warum : Excellence sur la rédaction structurée et rigoureuse des ADR. Format Michael Nygard ou variante au choix.

Perplexity AI
Perplexity AI
★ 4.9 (211) · 20 USD/mois

Assistant de recherche IA qui fournit des réponses sourcées et vérifiables en temps réel.

Warum : Pour benchmarker en temps réel avec sources fraîches (versions actuelles, retours d'expérience, comparaisons à jour).

Geschätzter ROI
Gesparte Zeit
70% bei Schrift (30-60 Min vs 2-3h)
Qualitätsgewinn
Systematisch rigorose ADRs, negative Konsequenzen expliziert
Kosten
20-30€/Monat
← Zurück zum Leitfaden Architecte logiciel
Diese Site ist auf wpml.org als Entwicklungs-Site registriert. Wechseln Sie zu einer Produktionssite mit dem Schlüssel remove this banner.