Communitygithub.com

wnstnsnqui/skills

Ein intensives Interview, das einen Plan oder ein Design schärft und dabei Dokumente (ADRs und Glossar) erstellt.

Was ist skills?

Dieses Skill führt ein gründliches, wiederholtes Interview durch, um Architektur- oder Designentscheidungen zu schärfen, und erzeugt dabei automatisch zwei zentrale Artefakte: Architectural Decision Records (ADRs) und ein Glossar. Es ist besonders nützlich für Entwicklerteams, die früh im Prozess Klarheit über technische Entwürfe gewinnen und gleichzeitig eine nachvollziehbare Dokumentation aufbauen möchten. Der Skill wird auf den Plattformen Claude Code, Cursor und Codex unterstützt und funktioniert, indem er den Benutzer in einem strukturierten Frage-Ablauf durch das Design führt. Dabei werden die Antworten direkt in standardisierte ADRs und ein Glossar überführt. Der Workflow sieht vor, dass der Skill zweimal mit den Modi „grill-core“ und „domain-map“ aufgerufen wird, wobei jeder Durchlauf einen anderen Aspekt des Designs beleuchtet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wnstnsnqui/skills/tree/HEAD/skills/engineering/ask-to-docs

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht skills?

Ein unerbittliches Interview, um einen Plan oder ein Design zu schärfen, das nebenbei Dokumente (ADRs und Glossar) erstellt.

Verwendung

Rufe das Skill-Tool zweimal auf: für "grill-core" und "domain-map".

grill-core

  • Startet ein intensives Interview zum Kern des Designs.
  • Erzeugt ADRs für die getroffenen Entscheidungen.
  • Dokumentiert das Glossar der verwendeten Begriffe.

domain-map

  • Fokussiert auf die Domänenmodellierung und Zusammenhänge.
  • Ergänzt die ADRs um domänenspezifische Aspekte.
  • Aktualisiert das Glossar.

Hintergrund

Dieses Skill hilft dabei, Designüberlegungen systematisch zu hinterfragen und gleichzeitig wertvolle Dokumentation zu generieren, die für das gesamte Team nachvollziehbar ist.

Das Tool erwartet, dass der Benutzer aktiv an der Befragung teilnimmt und durchdachte Antworten gibt. Die Qualität der resultierenden ADRs und des Glossars hängt direkt von der Tiefe der Diskussion ab.

Verwandte Skills