Communitygithub.com

andresnator/agents-orchestrator

Erstelle prägnante Architekturentscheidungsprotokolle (ADRs), die eine Entscheidung, den Kontext, die Optionen und die Konsequenzen dokumentieren.

Was ist agents-orchestrator?

Dieses Skill hilft Entwicklern, strukturierte Architecture Decision Records (ADRs) zu erstellen. Es führt durch einen Interview-Prozess, der sicherstellt, dass alle relevanten Aspekte einer technischen Entscheidung erfasst werden: Titel, Status, Kontext, gewählte Option, Alternativen mit Vor- und Nachteilen sowie Konsequenzen. Das Skill ist für Agenten wie Claude Code, Cursor oder Codex optimiert und bietet eine klare Befragungslogik, die Platzhalter vermeidet und stattdessen bei fehlenden Informationen 'TBD' setzt. Es unterstützt sowohl bereits getroffene Entscheidungen (Status 'Accepted') als auch Vorschläge ('Proposed'). Der generierte ADR wird standardmäßig als Markdown-Codeblock im Chat ausgegeben, kann aber auf expliziten Wunsch auch in einer Datei gespeichert werden. Das Skill stellt sicher, dass keine Alternativen oder Begründungen erfunden werden, sondern diese aktiv beim Benutzer erfragt werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add andresnator/agents-orchestrator

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

ADR-Ersteller

Erstelle prägnante Architecture Decision Records, die eine Entscheidung, den Kontext, der sie erzwungen hat, die in Betracht gezogenen Optionen und die akzeptierten Konsequenzen erklären.

Aktivierungsvertrag

Verwende dieses Skill, wenn der Benutzer nach einem ADR, Architekturentscheidungsprotokoll, technischen Entscheidungsprotokoll oder einer formellen Aufzeichnung fragt, warum eine technische oder architektonische Wahl getroffen wurde.

Standardmäßig in den Interview-Modus wechseln, es sei denn, der Benutzer hat bereits genügend Informationen geliefert, um einen vollständigen ADR zu entwerfen. Stelle Interviewfragen in der Sprache des Benutzers. Die ADR-Erstellsprache ist Englisch, es sei denn, der Benutzer bittet explizit um eine andere Sprache.

Harte Regeln

  • Stelle im Interview-Modus immer nur eine Frage auf einmal.
  • Gib zu Beginn des Interviews einmal an, dass der Benutzer Fragen überspringen oder das Interview jederzeit beenden kann.
  • Halte einen dynamischen Zähler für die geschätzte Anzahl verbleibender Fragen; aktualisiere ihn, wenn Abhängigkeiten auftauchen oder verschwinden.
  • Empfehle kurze Beispielantworten, wenn sie dem Benutzer bei der Antwort helfen.
  • Formatiere Interviewfragen als lesbares Markdown, nicht als Klartext.
  • Hinterfrage vage, widersprüchliche oder begründungslose Antworten konstruktiv, bevor du einen Entwurf erstellst; fahre fort, wenn der Benutzer explizit sagt, dass er trotzdem weitermachen möchte.
  • Erfinde keine Alternativen, Vor- und Nachteile oder Begründungen. Frage nach, wenn Alternativen fehlen.
  • Verwende Accepted, wenn die Entscheidung bereits getroffen wurde; verwende Proposed für Vorschläge, Bewertungen oder unklare Status.
  • Schreibe oder ändere Dateien nur, wenn der Benutzer explizit nach einer Datei/einem Pfad fragt.

Interview-Ablauf

Sammle nur das Nötigste, abhängigkeitsbasiert:

  1. Entscheidungstitel und -status.
  2. Kontext: Problem, Einschränkungen, Zwänge und warum die Entscheidung jetzt wichtig ist.
  3. Gewählte Option oder Vorschlag.
  4. Berücksichtigte Optionen mit Vor- und Nachteilen.
  5. Konsequenzen: Vorteile, Nachteile, Risiken und Kompromisse.
  6. Nachverfolgung nur, wenn es nützliche offene Aktionen oder ungelöste Fragen gibt.

Fragenformat:

### Frage N — [fokussierte Frage]

**Empfohlene Antwort:** [kurzes Beispiel, wenn nützlich]

**Warum dies wichtig ist:** [kurzer Grund]

**Geschätzte verbleibende Fragen:** ~M

Minibeispiel:

### Frage 1 — Ist diese Entscheidung bereits getroffen oder wird sie noch vorgeschlagen?

**Empfohlene Antwort:** „Accepted – wir haben uns bereits für PostgreSQL für Abrechnungsdaten entschieden.“

**Warum dies wichtig ist:** Der Status ändert, ob der ADR eine endgültige Wahl oder einen Vorschlag zur Prüfung dokumentiert.

**Geschätzte verbleibende Fragen:** ~5

Ausgabevertrag

Lies assets/template-markdown.md vor dem Entwurf und fülle diese Struktur aus.

Standardmäßig gib den finalen ADR als genau einen Markdown-Codeblock zurück und erstelle keine Dateien. Wenn der Benutzer explizit eine Datei/einen Pfad angefordert hat, speichere den ADR dort und fasse den gespeicherten Pfad im Chat zusammen.

Hinterlasse im finalen ADR niemals Platzhalteranweisungen. Wenn der Benutzer ein erforderliches Detail absichtlich überspringt, verwende sparsam TBD und nur für dieses übersprungene Detail.

Referenz

  • Vorlage: assets/template-markdown.md

Verwandte Skills