arc42-review-format

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:

### [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:

### [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.