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
- 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.”
- 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 …”.
- Mensch prüft das Proposal und entscheidet, ob es an den Entwicklungs-Agenten weitergeleitet wird.
- 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
../../business/60-rules-and-calculation/01-rule-engine-intent.md— Prompt-Proposal als allgemeines Pattern../../input/Sitzungsprotokolle/04-24_Business-Case-Essenz.md— Begründung im Kickoff