菜单
Schreibt arc42 Sektion 3 (Kontextabgrenzung): Fachlicher Kontext, technischer Kontext, externe Schnittstellen und Systemgrenzen. Use when: Sektion 3 schreiben, Kontext, Kontextabgrenzung, Scope, Business Context, Technical Context, externe Schnittstellen dokumentieren.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Struktur-Erkennung und Delegations-Protokoll für arc42-Dokumentationen in verschiedenen Layouts. Use when: arc42 Doku-Layout erkennen, Multi-Folder, Flat-Files, Single-File, Dokumentationspfad auflösen, Section-Dateien finden, Delegation mit Pfaden oder Inline-Content.
Verzeichnisstruktur und Dateikonventionen für arc42-Dokumentationen beim Schreiben. Definiert Standard-Ordnerstruktur, Dateinamen-Konventionen und Erkennung bestehender Strukturen. Use when: arc42 Ordnerstruktur anlegen, Dateien benennen, bestehende Struktur erkennen, Verzeichnisse erstellen.
Gemeinsames Ausgabeformat für arc42-Orchestrator-Agenten (Vollständiges Review, Branch-Review, Konfliktanalyse). Definiert Ampellogik, Übersichtstabellen, Zusammenfassungsblock und Templates für konsolidierte Berichte. Use when: arc42 Orchestrator-Ausgabe, Review-Bericht, Konsolidierung, Ampelfarben, Zusammenfassung, Gesamtübersicht.
Schreibt arc42 Sektion 1 (Einführung und Ziele): Aufgabenstellung, Qualitätsziele, Stakeholder. Use when: Sektion 1 schreiben, Einführung, Ziele, Requirements Overview, Quality Goals, Stakeholder erstellen, Anforderungsüberblick dokumentieren.
Schreibt arc42 Sektion 2 (Randbedingungen): Technische, organisatorische und politische Constraints sowie Konventionen. Use when: Sektion 2 schreiben, Randbedingungen, Constraints, Konventionen dokumentieren, Einschränkungen erfassen.
Schreibt arc42 Sektion 4 (Lösungsstrategie): Fundamentale Entwurfsentscheidungen, Technologieentscheidungen, Top-Level-Zerlegung, Ansätze zur Erreichung von Qualitätszielen. Use when: Sektion 4 schreiben, Lösungsstrategie, Solution Strategy, Technologieentscheidungen, Architekturansätze dokumentieren.
| name | arc42-write-s03-context |
| description | Schreibt arc42 Sektion 3 (Kontextabgrenzung): Fachlicher Kontext, technischer Kontext, externe Schnittstellen und Systemgrenzen. Use when: Sektion 3 schreiben, Kontext, Kontextabgrenzung, Scope, Business Context, Technical Context, externe Schnittstellen dokumentieren. |
Die Kontextabgrenzung grenzt das System von allen Kommunikationspartnern (Nachbarsystemen und Benutzern) ab. Sie spezifiziert die externen Schnittstellen aus fachlicher Sicht (immer) und aus technischer Sicht (optional).
Dies ist eine der Kernsektionen der arc42-Dokumentation.
03-Kontextabgrenzung/
├── 03-01-Fachlicher-Kontext.md
└── 03-02-Technischer-Kontext.md
# Fachlicher Kontext
## Kontextdiagramm
<!-- Beschreibe das System als Blackbox mit allen externen Kommunikationspartnern -->
<!-- Optional: Mermaid-Diagramm, PlantUML oder ASCII-Art -->
```mermaid
graph LR
A[Benutzer] -->|<Interaktion>| S[System]
S -->|<Daten>| B[Externes System 1]
C[Externes System 2] -->|<Daten>| S
| Partner | Eingabe (an System) | Ausgabe (vom System) | Beschreibung |
|---|---|---|---|
| <Benutzer/Rolle> | <Was sendet der Partner?> | <Was erhält der Partner?> | |
| <Externes System 1> |
### 03-02-Technischer-Kontext.md
```markdown
# Technischer Kontext
## Technisches Kontextdiagramm
<!-- Zeigt die Kanäle und Protokolle zu den Kommunikationspartnern -->
```mermaid
graph LR
A[Benutzer] -->|HTTPS| S[System]
S -->|JDBC/TLS| DB[(Datenbank)]
S -->|REST/HTTPS| E[Externes System]
MQ[Message Broker] -->|AMQP| S
| Partner | Kanal/Protokoll | Datenformat | Authentifizierung | Bemerkung |
|---|---|---|---|---|
| <Partner 1> | <z.B. REST/HTTPS> | <z.B. JSON> | <z.B. OAuth2> | |
| <Partner 2> | <z.B. AMQP> | <z.B. Protobuf> | <z.B. mTLS> |
| Fachliche Schnittstelle | Technische Realisierung |
|---|---|
| <z.B. Bestelleingang> | <z.B. POST /api/orders, JSON über HTTPS> |
## Best Practices (aus arc42-Tipps)
- **Kontextdiagramm ist Pflicht**: Zeige das System als Blackbox mit allen externen Partnern
- **Tabelle kombinieren**: Diagramm plus Tabelle ist die effektivste Darstellung
- **Alle Schnittstellen zeigen**: Keine externe Schnittstelle weglassen
- **Überblick statt Details**: Kontext soll Überblick geben, nicht zu viele Details
- **Datenflüsse zeigen**: Im fachlichen Kontext Datenflüsse statt nur Abhängigkeiten
- **Fachlich und technisch trennen**: Fachlicher Kontext zeigt WAS fließt, technischer Kontext zeigt WIE
- **Risiken an Schnittstellen markieren**: Besonders risikobehaftete externe Schnittstellen kennzeichnen
- **Kategorisieren bei vielen Partnern**: Bei >10 externen Systemen gruppieren/clustern
## Querverweise
- → **Sektion 5** (Bausteinsicht): Externe Schnittstellen aus dem Kontext müssen in der Bausteinsicht Level 1 wieder auftauchen
- → **Sektion 7** (Verteilungssicht): Technischer Kontext und Verteilungssicht haben Überschneidungen
- → **Sektion 10** (Qualitätsanforderungen): Quality-of-Service an externen Schnittstellen