software-architecture-guidelines

SKILL.md

---
name: software-architecture-guidelines
description: Wenden Sie kontextbezogene Leitlinien zur Softwarearchitektur an, wenn Sie Systemgrenzen, Qualitätsanforderungen, Kommunikation, Stile, Entscheidungen, Risiken oder Weiterentwicklungen analysieren.
---

# Richtlinien für Softwarearchitektur

Verwenden Sie diesen portablen Entwurf, um Architekturarbeiten über Softwaredomänen hinweg zu unterstützen. Er ist nicht global installiert. Das Buch liefert Konzepte und Abwägungen; dieser Leitfaden operationalisiert sie als bedingte Prüfungen. Sie sind keine Projektbefehle oder Ersatz für Benutzerabsicht, lokale Governance oder bekannte Systembelege.

## Arbeitsablauf

1. **Kontext und Autorität festlegen.** Identifizieren Sie die Domäne, Systemgrenze, Geschäftsergebnisse, Bereitstellungs- und Datenbeschränkungen, Teamfähigkeiten, bekannte Belege, Unbekanntes und Entscheidungsbefugnis. Respektieren Sie bereits delegierte Autorität. Fragen Sie nur nach fehlenden Fakten, die das Ergebnis ändern können; geben Sie sonst eine bedingte Empfehlung.
2. **Treiber bewerten.** Übersetzen Sie Stakeholder-Ergebnisse in architektonische Merkmale. Testen Sie jeden Kandidaten anhand der dreiteiligen Definition, zerlegen Sie zusammengesetzte Qualitäten und priorisieren Sie eine kleine Auswahl.
3. **Grenzen und Daten abbilden.** Identifizieren Sie funktionale Verantwortlichkeiten, Abhängigkeiten, Transaktionen, Datenbesitz, statische Kopplung, Laufzeitaufrufe und Merkmale an jeder relevanten Grenze.
4. **Proportional vergleichen.** Vergleichen Sie bei einer folgenschweren Wahl mindestens zwei praktikable Optionen anhand der festgelegten Prioritäten, Kosten, Risiken und Belege. Erzwingen Sie keinen formalen Vergleich bei einer kleinen, reversiblen Änderung.
5. **Mit Begründung entscheiden.** Geben Sie die Empfehlung oder den Status an, warum sie passt, akzeptierte Kosten, Annahmen und welche Belege eine Neubewertung auslösen würden. Folgen Sie delegierter Autorität; erfinden Sie keine Genehmigungstore.
6. **Prüfungen spezifizieren.** Wählen Sie Maßnahmen oder Fitnessfunktionen proportional zum Risiko. Benennen Sie deren Umfang, Signal, Einschränkungen und Reaktion.

## Kernregeln

- Begründen Sie Empfehlungen im Kontext ([Kontext- und Prioritätsregeln](references/rulebook.md#context-priorities): F01) und respektieren Sie delegierte Autorität ([Entscheidungs-, Risiko- und Evolutionsregeln](references/rulebook.md#decisions-risk-evolution): D03).
- Leiten Sie Merkmale aus messbaren Stakeholder-Ergebnissen ab und bewerten Sie sie ([Kontext- und Prioritätsregeln](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Halten Sie Verantwortlichkeiten kohäsiv und Grenzen ehrlich bezüglich Abhängigkeiten und Kopplung ([Grenzregeln](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [Glossar](references/glossary.md)).
- Wählen Sie Kommunikation passend zur Arbeit; unterscheiden Sie Anfrage, Befehl und Ereignis und entwerfen Sie für Fehlerfälle ([Kommunikationsregeln](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Behandeln Sie Architekturstile als bedingte Optionen und vergleichen Sie deren Kosten ([Stilregeln](references/rulebook.md#style-choice): S01, S16, D06; [Stil-Leitfaden](references/style-selection.md)).
- Dokumentieren Sie, warum folgenschwere Entscheidungen existieren und was sie ändern würde ([Abwägungen](references/rulebook.md#context-priorities): F02; [Entscheidungsaufzeichnungen](references/rulebook.md#decisions-risk-evolution): F03).
- Machen Sie Risiko, Unsicherheit und Implementierungsabgleich sichtbar ([Risiko- und Evolutionsregeln](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- Steuern Sie wichtige Beschränkungen mit Prüfungen, die Menschen verstehen ([Governance-Regeln](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Bewahren Sie Teamwahl innerhalb der tatsächlichen Autorität und Beschränkungen ([Team- und Kommunikationsregeln](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Wenden Sie anbieter-spezifische Anleitungen nur an, wenn das Projekt einen Modellanbieter einschließt ([D15 in rules.json](references/rules.json)).

## Ausgabe-Vertrag

Geben Sie zurück: Kontext und Unbekanntes; Empfehlung und Status; Alternativen und Kosten; Auswirkungen auf Grenzen, Daten und Kommunikation; Belege und Prüfungen; sowie einen Auslöser für Neubewertung. Skalieren Sie Details entsprechend der Konsequenz der Wahl.

## Referenzen

Für eine Aufgabe laden Sie nur die relevante Kategorie in [rules.json](references/rules.json) oder lesen Sie deren Abschnitt in [rulebook.md](references/rulebook.md), nicht beides oder das gesamte Paket. Laden Sie [style-selection.md](references/style-selection.md) für die neun Stile, [glossary.md](references/glossary.md) für quellenbasierte Begriffe und [source-map.json](references/source-map.json), um zitierte Kapitel zu finden. Synthetische Evaluations-Prompts sind in [evaluation-cases.json](references/evaluation-cases.json); sie wurden nicht ausgeführt. Methode und Einschränkungen sind in [method-and-validation.md](references/method-and-validation.md).