Entscheidungen aus Design-Reviews als ADRs in Confluence festhalten: Praxisleitfaden für SuperIntern MCP + Confluence

Design-Reviews enden mit einer Entscheidung, aber nur wenige Teams halten in Confluence fest, warum sie sich dafür entschieden haben und woran die Alternativen gescheitert sind. Sechs Monate später sind die Menschen, die die Gründe kannten, in andere Projekte gewechselt, und das Team führt dieselbe Debatte noch einmal von vorn.
Wenn Sie SuperIntern MCP und Confluence mit einem KI-Agenten (Claude, ChatGPT) verbinden, liest der Agent das Transkript des Meetings und entwirft einen Architecture Decision Record (ADR) mit den erwogenen Optionen und der Begründung, jeweils mit einem Zitat als Beleg. Sie prüfen den Entwurf, geben ihn frei, und er wird als Confluence-Seite gespeichert.
Auch ChatGPT bietet eine offizielle Atlassian-App, doch laut Atlassians Dokumentation ist nicht bestätigt, dass sie Confluence-Seiten anlegen oder aktualisieren kann. Was heute in ChatGPT funktioniert, erklärt der Abschnitt zur Einrichtung.
⚠️ Dieser Artikel wurde auf Grundlage öffentlich zugänglicher Informationen und Nutzerfeedbacks mit Stand Oktober 2026 unabhängig zusammengestellt.
Inhaltsverzeichnis
- Was wir bauen: Vorher / Nachher
- So funktioniert es: drei Rollen
- Einrichtung
- Anwendung 1: Den ADR direkt nach dem Design-Review entwerfen
- Anwendung 2: Entscheidungen ohne ADR einmal pro Woche aufspüren
- Anwendung 3: Verwandte frühere Entscheidungen während des Meetings finden
- Tipps für den Alltag
- Über Confluence hinaus: dasselbe Muster mit anderen Tools
- FAQ
Was wir bauen: Vorher / Nachher
Vorher: Ein Design-Review kommt zu einem Ergebnis, und im Protokoll steht „Queue einführen" und sonst nichts. Wer den ADR schreiben sollte, ist mit der Auslieferung beschäftigt, sodass der Vergleich der Optionen und die Gründe für die Absagen nur in den Köpfen existieren. Fragt ein neuer Entwickler, warum das System so aufgebaut ist, kann niemand antworten.
Nachher: Nach dem Meeting bitten Sie den Agenten, aus dem heutigen Design-Review einen ADR zu schreiben. Der Agent liest das Transkript aus SuperIntern und entwirft Kontext, erwogene Optionen, Entscheidung, Begründung und Folgeaufgaben, jeweils mit dem Zitat, das sie stützt. Nach Ihrer Freigabe wird die Seite unter Ihrer ADR-Elternseite angelegt. Einmal pro Woche lassen Sie den Agenten die Meetings der Woche erneut lesen und nach Entscheidungen suchen, die es nicht in einen ADR geschafft haben.
Die Meetings, auf die Sie zugreifen möchten, müssen in SuperIntern aufgezeichnet sein. SuperIntern ist ein Desktop-Meeting-Assistent, der ohne Bot im Call auskommt und Transkript sowie KI-Protokoll erstellt. Für interne Design-Reviews ist deshalb keine Einrichtung im Meeting selbst nötig.

Als Beispiel dient dieses Team:
| Punkt | Details |
|---|---|
| Meeting | „Design-Review Benachrichtigungsversand" (04.11.) |
| Teilnehmende | Lena (Tech Lead), Jonas (Backend), Tobias (SRE), Sarah (PM) |
| Thema | Verzögerungen bei Benachrichtigungen beheben (aktuell bis zu 15 Minuten) |
| Ziel | Confluence-Space „Entwicklung", unter der Elternseite „Architekturentscheidungen (ADR)" |
So funktioniert es: drei Rollen
| Rolle | Wer | Was passiert |
|---|---|---|
| Meeting-Daten | SuperIntern MCP | Stellt Transkripte, Live-Transkripte, KI-Protokolle und Meeting-Notizen schreibgeschützt bereit |
| Einordnung und Entwurf | KI-Agent (Claude, ChatGPT) | Erkennt Optionen und Begründungen im Gespräch und entwirft den ADR |
| Ablage | Confluence (offizieller MCP-Server von Atlassian) | Sucht, legt an und aktualisiert Seiten und ergänzt Kommentare |
MCP (Model Context Protocol) ist ein offener Standard, um KI-Assistenten sicher mit externen Tools zu verbinden. SuperIntern MCP gibt Ihrem Agenten nur Lesezugriff auf Meeting-Daten. Details finden Sie im MCP-Einrichtungsleitfaden.
Auf der Confluence-Seite übernimmt der offizielle MCP-Server von Atlassian (Atlassian Rovo MCP Server). Er kann Confluence-Seiten suchen, lesen, anlegen und aktualisieren sowie Kommentare ergänzen, und dieselbe Verbindung deckt auch Jira ab.
In Confluence schreibt der Agent, nicht SuperIntern. Der Agent kann in SuperIntern nichts verändern und liest nur Meetings, die Sie ohnehin sehen dürfen. In Confluence kann er nur in Spaces schreiben, die Sie bearbeiten dürfen.
Einrichtung
Sie verbinden zwei Dinge: SuperIntern und Confluence. Nehmen Sie den Agenten, den Sie ohnehin nutzen. In Claude kommen beide aus dem Konnektor-Verzeichnis, und alle Prompts in diesem Artikel funktionieren unverändert. In ChatGPT funktionieren das Suchen und Lesen von Seiten (Anwendung 3) direkt; ob sich Seiten anlegen und aktualisieren lassen (Anwendungen 1 und 2), prüfen Sie vorab in Ihrer Umgebung.
1. SuperIntern verbinden
- Claude: Öffnen Sie die Einstellungen (Settings), gehen Sie unter Anpassen (Customize) zu Konnektoren (Connectors), suchen Sie nach „SuperIntern" und wählen Sie den Eintrag aus. Direkt geht es über SuperIntern in der Konnektor-Liste von Claude. Das Hinzufügen von Konnektoren ist in den kostenpflichtigen Claude-Plänen verfügbar.
- ChatGPT: Öffnen Sie Plugins in der Seitenleiste, suchen Sie nach „superintern", öffnen Sie SuperIntern und klicken Sie auf Plugin installieren. Direkt geht es über die Plugin-Seite von SuperIntern. Die Codex-App verbinden Sie auf dieselbe Weise.
In beiden Fällen öffnet sich die SuperIntern-Anmeldeseite; melden Sie sich an und erteilen Sie die Freigabe. Die Voraussetzungen auf SuperIntern-Seite (persönliche Workspaces benötigen mindestens den Plus-Tarif; bei Enterprise muss ein Admin den MCP-Zugriff aktivieren) sowie die Einrichtung in Claude Code, Cursor und anderen Clients finden Sie in unserem MCP-Einrichtungsleitfaden.
2. Confluence verbinden
- Claude: Suchen Sie in den Konnektoren (Connectors) nach „Atlassian", fügen Sie den offiziellen Konnektor „Atlassian MCP" von Atlassian hinzu und melden Sie sich mit Ihrem Atlassian-Konto an. Er kann Jira-Vorgänge und Confluence-Seiten suchen, lesen, anlegen und aktualisieren.
- ChatGPT: Suchen Sie unter Plugins nach „Atlassian", verbinden Sie die offizielle Atlassian-App „Atlassian Rovo" und melden Sie sich mit Ihrem Atlassian-Konto an. Laut Atlassians Ankündigung lassen sich damit Confluence-Seiten zusammenfassen und lesen sowie Jira-Vorgänge anlegen und aktualisieren. Kann Ihr Agent die Confluence-Seite nicht anlegen, lassen Sie sich den Entwurf ausgeben und fügen ihn selbst in Confluence ein.
- Claude Code: Führen Sie
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcpaus und melden Sie sich in Claude Code über/mcpbei Atlassian an.
Bei der Anmeldung wählen Sie, mit welcher Atlassian-Site die Verbindung hergestellt wird. Ihre Atlassian-Berechtigungen gelten unverändert: Zum Anlegen einer Seite brauchen Sie die Berechtigung zum Erstellen in diesem Space. Verbindungen aus Claude und ChatGPT sind standardmäßig erlaubt, doch ein Admin Ihrer Atlassian-Organisation kann den MCP-Server einschränken, dann schlägt die Verbindung fehl. In den Tarifen Claude Team und Enterprise muss ein Organisationsinhaber den Konnektor erst hinzufügen, bevor Mitglieder ihn nutzen können.
Sind beide verbunden, prüfen Sie, ob der Agent beide Seiten sieht:
Liste die SuperIntern-Meetings dieser Woche im Projekt „Entwicklung" auf
und zeige mir die Unterseiten von „Architekturentscheidungen (ADR)" im Confluence-Space „Entwicklung".
Kommen beide Listen zurück, kann es losgehen.
Anwendung 1: Den ADR direkt nach dem Design-Review entwerfen
Am meisten bringt das direkt nach einem Design-Review. Zwei Dinge sind im Prompt wichtig: die ADR-Abschnitte benennen und auch die Gründe für die verworfenen Optionen verlangen.
Lies Transkript und KI-Protokoll des heutigen „Design-Review Benachrichtigungsversand"
und entwirf einen ADR für die Elternseite „Architekturentscheidungen (ADR)"
im Confluence-Space „Entwicklung".
- Verwende die nächste Nummer nach den vorhandenen ADRs
- Abschnitte: Kontext / Erwogene Optionen (Tabelle: Vorteile, Bedenken, eingebracht von) / Entscheidung /
Begründung / Folgeaufgaben / Offene Fragen
- Nenne bei jeder verworfenen Option den Grund der Ablehnung, mit Zitat
- Was im Meeting nicht entschieden wurde, kennzeichnest du als „Offen"
Zeig mir zuerst den Entwurf. Nach meiner Freigabe legst du die Seite an.
Der Agent prüft zuerst die vorhandenen ADR-Nummern und liefert dann den Entwurf:
Hier ist der Entwurf für „ADR-014 Benachrichtigungen über eine Queue versenden":
Kontext: Benachrichtigungen gehen alle 5 Minuten in einem Batch-Job raus, die Zustellung dauert bis zu 15 Minuten. Sarah: „Wir bekommen rund 20 Tickets pro Woche, weil Buchungsbestätigungen zu spät ankommen."
Erwogene Optionen
Option Vorteile Bedenken Eingebracht von A. Batch jede Minute ausführen Kleine Änderung Läufe überschneiden sich, sobald das Volumen wächst Jonas B. Zustellung über eine Queue (Amazon SQS) und Worker Zustellung innerhalb einer Minute; Fehler werden einzeln wiederholt Mehr zu überwachen Lena C. Externen Benachrichtigungsdienst nutzen Fast kein Code Personenbezogene Daten gehen an einen Anbieter, daher Sicherheitsprüfung nötig Sarah Entscheidung: Option B wird umgesetzt.
Begründung: Option A überschneidet sich beim erwarteten Volumen des nächsten Jahres (Jonas: „Im Januar dauert ein einzelner Lauf schon über eine Minute."). Die Sicherheitsprüfung bei Option C dauert etwa zwei Monate und verfehlt damit die Lösung für dieses Jahr (Sarah: „Allein für die Prüfung sollten wir zwei Monate einplanen.").
Folgeaufgaben: Worker bauen (Jonas, 18.11.) / Queue und Alarme für fehlgeschlagene Nachrichten einrichten (Tobias, 20.11.) / Abschaltung des Batch-Jobs planen (Lena, Dezember)
Offene Fragen: Ob Benachrichtigungen nach Typ priorisiert werden (Entscheidung im nächsten Sync)
Soll ich die Seite mit diesem Inhalt anlegen?
Antworten Sie mit OK, erscheint unter „Architekturentscheidungen (ADR)" eine neue Seite. Bitten Sie den Agenten, oben auf der Seite das Quell-Meeting und das Datum anzugeben, dann kann jeder die Entscheidung bis zum Transkript zurückverfolgen.

Weil die Gründe für die Absage jeder Option auf der Seite stehen, ist die Antwort auf die nächste Frage „Wäre ein externer Anbieter nicht einfacher?" schon da: der Zeitplan der Sicherheitsprüfung.
Anwendung 2: Entscheidungen ohne ADR einmal pro Woche aufspüren
Architekturrelevante Entscheidungen fallen auch in regelmäßigen Syncs, nicht nur in Design-Reviews. Lassen Sie den Agenten einmal pro Woche die Meetings der Woche lesen und mit Ihrer ADR-Liste vergleichen.
Lies alle SuperIntern-Meetings im Projekt „Entwicklung" aus dieser Woche (02.11. bis 06.11.)
und vergleiche sie mit den Unterseiten von „Architekturentscheidungen (ADR)" in Confluence.
- Entscheidungen aus einem Meeting, zu denen es keinen ADR gibt
- Entscheidungen, die einen bestehenden ADR ändern oder ersetzen
Als Tabelle: Entscheidung / Meeting / verwandter ADR / Vorschlag / Zitat.
Lege nur für die Zeilen, die ich freigebe, ADR-Entwürfe an und aktualisiere die bestehenden Seiten.
Der Agent stellt die Entscheidungen jedes Meetings der ADR-Liste gegenüber:
Ich habe diese Woche 3 Entscheidungen gefunden, die ADRs betreffen:
Entscheidung Meeting Verwandter ADR Vorschlag Zitat Admin-APIs einheitlich auf REST API-Sync, 05.11. Keiner ADR-015 anlegen Lena: „Bauen wir jede neue Oberfläche auf REST." Benachrichtigungen bis zu 3-mal wiederholen, die Wartezeit jeweils verdoppeln Dev-Sync, 06.11. ADR-014 Unter „Entscheidung" ergänzen Jonas: „Nach 3 Fehlversuchen landet die Nachricht in der Dead-Letter-Queue." Logs auf stdout statt in Dateien Dev-Sync, 06.11. ADR-009 ADR-016 anlegen und ADR-009 auf „Ersetzt" setzen Tobias: „Wir laufen jetzt auf Containern, das Logging in Dateien fällt weg." Alle 3 übernehmen?

Nach Ihrer Freigabe werden die Entwürfe für ADR-015 und ADR-016 angelegt und die Wiederholungsregel in ADR-014 ergänzt. Der Status von ADR-009 wechselt auf „Ersetzt", mit einem Link auf ADR-016. Lassen Sie die Verantwortlichen die Entwürfe lesen, bevor Sie sie als final markieren.
Anwendung 3: Verwandte frühere Entscheidungen während des Meetings finden
SuperIntern MCP kann auch das Live-Transkript eines laufenden Meetings lesen. Es holt nur, was seit der letzten Anfrage neu ist, sodass mehrere Abfragen während des Meetings schnell bleiben.
Wenn eine Diskussion auf eine frühere Entscheidung zu stoßen scheint, fragen Sie:
Lies das Live-Transkript des laufenden „Abstimmung Benachrichtigungen"
(nur das Neue seit dem letzten Mal) und suche dann in Confluence unter „Architekturentscheidungen (ADR)"
nach früheren ADRs, die zum aktuellen Thema passen.
Nenne mir jede Entscheidung, die der heutigen Diskussion widerspricht, samt Begründung.
Schreib nichts in Confluence.
Der Agent verbindet das aktuelle Gespräch mit den Suchergebnissen aus Confluence:
Aktuell geht es darum, E-Mail-Benachrichtigungen direkt aus dem Worker zu versenden. Zwei ADRs sind relevant:
- ADR-006 E-Mails nur über den externen Versanddienst (Juni 2025): Um die Reputation der Absenderdomain zu schützen, läuft E-Mail ausschließlich über den Versanddienst. Der heutige Vorschlag widerspricht dieser Entscheidung.
- ADR-014 Benachrichtigungen über eine Queue versenden (04.11.): Der Worker holt Benachrichtigungen aus der Queue, legt aber nicht fest, wie E-Mails versendet werden.
Eine Frage zur Klärung: „Stellen wir ADR-006 infrage, oder soll der Worker stattdessen den Versanddienst aufrufen?"
In dieser Anwendung wird nichts in Confluence geschrieben. Da nur Seiten gesucht und gelesen werden, funktioniert sie auch in ChatGPT.
Tipps für den Alltag
Eine ADR-Vorlage in Confluence pflegen. Gibt es eine Vorlagenseite mit Ihren Abschnitten, liest der Agent sie und entwirft in derselben Struktur. Nennen Sie sie im Prompt, zum Beispiel „Verwende dieselbe Struktur wie die Seite ‚ADR-Vorlage'."
Das Ergebnis am Ende laut aussprechen. „Wir gehen also mit Option B, wegen des Zeitplans der Prüfung" hinterlässt im Transkript eine klare Entscheidung samt Grund. Ein stummes Nicken kann der Agent nicht als Entscheidung erkennen.
Meetings in einem SuperIntern-Projekt bündeln. Legen Sie Entwicklungs-Meetings in ein Projekt, dann können Sie wie in Anwendung 2 nach Zeitraum und Projekt filtern.
Den Plan immer vor dem Schreiben prüfen. Jeder Prompt in diesem Artikel zeigt zuerst einen Entwurf und schreibt erst nach der Freigabe. ADRs werden über Jahre gelesen, lassen Sie also die verantwortliche Person Entscheidung und Begründung prüfen, bevor Sie freigeben.
Berechtigungen wie Ihre eigenen. SuperIntern MCP liest nur Meetings, die Sie sehen dürfen, und in Confluence schreibt der Agent nur in Spaces, die Sie bearbeiten dürfen. In SuperIntern ändert sich nie etwas.
Dienstnamen ins Wörterbuch aufnehmen. Je genauer Dienstnamen und interne Abkürzungen im Transkript stehen, desto präziser wird der ADR. Häufige Begriffe tragen Sie in das benutzerdefinierte Wörterbuch von SuperIntern ein.
Über Confluence hinaus: dasselbe Muster mit anderen Tools
SuperIntern MCP liefert die Meeting-Daten, der Agent entscheidet, ein anderes Tool führt aus. Das Muster bleibt gleich, wenn sich das Ziel ändert.
- Linear: Folgeaufgaben aus einem ADR als Entwicklungsaufgaben anlegen, siehe Linear-Leitfaden
- Claude Code: direkt von der Entscheidung zur Umsetzung, siehe Claude-Code-Leitfaden
- Notion: Meeting-Protokolle in einer Datenbank sammeln, siehe Notion-Leitfaden
- Miro: eine im Meeting erklärte Architektur in ein Diagramm überführen, siehe Miro-Leitfaden
FAQ
Kann ich SuperIntern MCP im Free-Tarif nutzen?
Nein. Persönliche Workspaces benötigen mindestens den Plus-Tarif. Team-Tarife funktionieren direkt. Bei Enterprise muss ein Admin den „MCP-Zugriff" in den Workspace-Einstellungen aktivieren.
Schreibt SuperIntern in Confluence?
Nein. Der Agent legt Seiten über den offiziellen MCP-Server von Atlassian an und aktualisiert sie dort. SuperIntern MCP stellt Meeting-Daten nur lesend bereit.
Funktioniert das auch in ChatGPT?
Teilweise. Unter den Plugins von ChatGPT gibt es die offizielle Atlassian-App „Atlassian Rovo", die wie in Anwendung 3 frühere Seiten suchen und lesen kann. Das Anlegen oder Aktualisieren von Confluence-Seiten bestätigt Atlassians Dokumentation nicht. Für die Anwendungen 1 und 2 müssen Sie den Entwurf des Agenten daher unter Umständen selbst in Confluence einfügen.
Brauche ich ein festes ADR-Format?
Nein. Ohne Vorgabe verwendet der Agent die Abschnitte aus dem Prompt von Anwendung 1. Hat Ihr Team ein Format, nennen Sie im Prompt den Namen der Vorlagenseite.
Kann der Agent auch Jira-Vorgänge anlegen?
Ja. Der offizielle MCP-Server von Atlassian deckt auch Jira ab, sodass Sie über dieselbe Verbindung Folgeaufgaben eines ADRs als Jira-Vorgänge anlegen lassen können. Nennen Sie im Prompt Projekt und Vorgangstyp.
Worin unterscheidet sich das vom Notion-Leitfaden?
Der Notion-Leitfaden behandelt das Sammeln eines Protokolls jedes Meetings in einer Datenbank. Dieser Artikel konzentriert sich auf technische Entscheidungen und hält erwogene Optionen und die Gründe für ihre Ablehnung als ADRs fest.
Nehmen Sie Ihr nächstes Design-Review, und sprechen Sie Entscheidung und Grund laut aus, bevor Sie die Aufzeichnung in SuperIntern beenden. Wenige Minuten nach dem Meeting liegt in Confluence ein ADR-Entwurf bereit, einschließlich der Frage, woran die anderen Optionen gescheitert sind.