Zum Inhalt springen

Feedback-System · Prompt-Proposal-Pattern

Status: Entwurf · V1-Komponente, früh zu bauen

Direktes In-App-Feedback ohne den Umweg über E-Mail oder Anruf. Ziel: den Schmerz des Nutzers im Moment des Auftretens abfangen und mit einem menschlichen Validierungsschritt ins Entwicklungsbacklog überführen.

Grundidee

  1. Nutzer äußert sein Anliegen (Text oder Sprache) direkt in der Workbench: „Wäre doch geil, wenn man die Tochter-Karten einfärbbar machen könnte.”
  2. KI strukturiert das Anliegen unter Verwendung der Workbench-Begriffswelt zu einem „Prompt Proposal” — ein qualitativ hochwertiges Ticket im Stil „Als Mandats-Analyst möchte ich …”.
  3. Mensch prüft das Proposal und entscheidet, ob es an den Entwicklungs-Agenten weitergeleitet wird.
  4. Erst nach Freigabe landet das Ticket im echten Backlog (z. B. GitHub Issues / Linear).

UI-Komponente: Feedback-Pille

  • Persistent als kleiner Floating-Button unten-rechts (nicht aufdringlich, ggf. mit Icon-Glyph).
  • Klick öffnet ein Side-Sheet mit:
    • Kategorie-Auswahl (Idee / Bug / UX / Feature / Frage)
    • Textarea oder Sprachaufnahme
    • „Tune with AI”-Button — strukturiert das Eingegebene
    • Vorschau des generierten Tickets
    • Submit / Abort
  • Sheet schließt nach Submit mit Bestätigungs-Toast: „Vorschlag landet zur Prüfung im Review-Inbox.”

Begriffs-Kontext für die KI

Beim Start der App wird ein kompakter Glossar-Snapshot in eine Textdatei geschrieben (oder eine Graphdatenbank befragt). Die KI bekommt diesen Kontext, damit sie korrekte Fachbegriffe nutzt:

  • „Mandat” statt „Vertrag”
  • „Tochter-Card” statt „Box mit Logo”
  • „Annahmen-Slider” statt „dieser Schieber im Wizard”
  • „€/VE/Monat” statt „die Zahl da oben”

Gatekeeper

Der menschliche Prüfschritt ist nicht-verhandelbar. Gründe:

  • Schlechte Ticket-Formulierungen verschwenden Entwickler-Zeit.
  • Anforderungen, die KI generiert, müssen gegen die Workbench-Roadmap geprüft werden.
  • Fachliche Unklarheiten (Mandat vs. Eigenbestand?) müssen ein Mensch klären.

Roles: jeder mit feedback.submit darf einreichen. Nur feedback.review (z. B. Modellierer, Product Owner) darf an Backlog weiterleiten.

Pflicht-Felder im strukturierten Ticket

  • Titel (kurz, im Stil „Als X möchte ich Y, damit Z”)
  • Kategorie
  • Aktueller Screen / Komponente (auto-detected)
  • User-Eingabe (verbatim)
  • Generierte Beschreibung
  • Logs der letzten 30 Sekunden (nur bei Bugs, opt-in)
  • Screenshot (auto, opt-out)

Reifegrad

  • V1: Sheet + Tune-with-AI + manueller Review.
  • V2: Sprachaufnahme statt Textarea.
  • V2+: Auto-Klassifikation der Eingabe (Bug vs. Idee).
  • V3: Direkte Verlinkung auf den auslösenden Klickpfad (Replay-Snippet).

Verwandte Dokumente