---
name: arc42-review-format
description: "Gemeinsame Ausgabeformate und Review-Modi für arc42-Review-Agenten. Definiert Befund-Templates für Sektions-Reviews und Konfliktanalysen, sowie Vollständig- und Delta-Modi. Use when: arc42 Review formatieren, Befund-Format, Konflikt-Format, Review-Modus, Sektions-Review, Konfliktanalyse."
---

# arc42 Review-Format

Dieses Skill definiert die gemeinsamen Formate und Modi für alle arc42-Review-Agenten. Es gibt zwei Agent-Typen mit jeweils eigenen Varianten: **Sektions-Review-Agenten** und **Konfliktanalyse-Agenten**.

## Review-Modi

### Sektions-Review Modi

Jeder Sektions-Agent unterstützt zwei Modi, abhängig vom Aufrufkontext:

**Vollständig-Modus (Standard)**
Wenn du OHNE spezifischen Änderungskontext aufgerufen wirst → prüfe alle Dateien der Sektion vollständig.

**Delta-Modus (Branch-Review)**
Wenn der Aufrufer **geänderte Dateien und/oder Diffs** mitliefert → prüfe NUR diese Änderungen:
- Lies nur die genannten geänderten Dateien vollständig
- Prüfe nur die Änderungen gegen die untenstehenden Kriterien
- Lies unveränderte Dateien der Sektion nur als Kontext, wenn zum Verständnis der Änderung nötig
- Kennzeichne jeden Befund klar als änderungsbezogen

### Konfliktanalyse Modi

Jeder Konflikt-Agent unterstützt zwei Modi:

**Vollständig-Modus (Standard)**
Wenn du OHNE spezifischen Änderungskontext aufgerufen wirst → prüfe alle Konfliktdimensionen vollständig.

**Delta-Modus (Branch-Review)**
Wenn der Aufrufer **geänderte Dateien und/oder Diffs** mitliefert:
- Lies trotzdem ALLE relevanten Dateien aus den beteiligten Sektionen (beide Seiten der Beziehung werden für Konfliktprüfung benötigt)
- Fokussiere die Analyse darauf, ob die **Änderungen neue Konflikte einführen** oder bestehende verschärfen
- Melde nur Konflikte, die durch die Änderungen verursacht oder beeinflusst wurden
- Kennzeichne jeden Befund als änderungsbezogen

## Ausgabeformate

### Sektions-Review: Befund-Format

Für jede Abweichung in einem Sektions-Review:

~~~markdown
### [Befund-ID] Titel

**Schwere:** 🔴 Kritisch / 🟡 Empfehlung / 🟢 Hinweis
**Datei:** `pfad/zur/datei.md`
**Kriterium:** Welches arc42-Kriterium verletzt ist

**Befund:** Beschreibung des Problems

**Änderungsvorschlag:**
> Konkreter Text, der eingefügt oder geändert werden soll.
> Direkt übernehmbar formuliert.
~~~

### Konfliktanalyse: Befund-Format

Jeder Konflikt-Agent gibt zunächst seine **agenten-spezifische Übersichtsmatrix** aus (z.B. Zuordnungsmatrix, Schnittstellenvergleich, etc.), gefolgt von den einzelnen Konflikten in diesem Format:

~~~markdown
### [PREFIX-nn] Titel

**Konflikttyp:** K1/K2/K3/...
**Schwere:** 🔴 Kritisch / 🟡 Warnung / 🟢 Hinweis
**Betroffene Dateien:**
- `datei1.md` — betroffene Aussage
- `datei2.md` — widersprüchliche Aussage

**Beschreibung:** Worin genau der Konflikt besteht

**Lösungsvorschlag:** Konkreter Vorschlag zur Auflösung des Konflikts
~~~

Das PREFIX wird vom jeweiligen Konflikt-Agenten definiert (z.B. KQS, KKB, KRC, KSE, KSV, KKE, KRQ).

## Gemeinsame Regeln

- Schlage bei jedem Befund eine **KONKRETE, direkt übernehmbare Änderung** vor
- Berücksichtige, dass die Dokumentation auf **Deutsch** verfasst ist
- Befund-IDs müssen eindeutig und fortlaufend nummeriert sein

## Verwandte Skills

- **`arc42-doc-layout`**: Struktur-Erkennung und Delegations-Protokoll für verschiedene Dokumentations-Layouts (Multi-Folder, Flat-Files, Single-File). Muss von Orchestratoren geladen werden, damit Section-Agenten korrekte Dateipfade oder Inline-Content erhalten.