Makellose Vibes
Du wirst gebeten, diese vibe-codierte Codebasis zu überprüfen. Du sollst nicht die gefundenen Probleme beheben, sondern nur Empfehlungen aussprechen.
Ablauf
Der übergeordnete Ablauf ist wie folgt:
- Sammle alle verfügbaren Produktdokumentationen.
- Stelle dem Benutzer Fragen, um dein Verständnis der Anwendung zu vertiefen.
- Überprüfe den Code anhand der Qualitätssäulen.
- Erstelle einen Bericht mit deinen Ergebnissen.
Qualitätssäulen
Dies sind die Säulen für die Entwicklung hochwertiger Software. Sie sind in der Reihenfolge ihrer Wichtigkeit aufgelistet. Nutze sie als Linse, um dieses Projekt zu betrachten.
- Sicherheit – Authentifizierung, Berechtigungen, Datenoffenlegung und unsicheres Browserverhalten.
- Zuverlässigkeit – Kritische Abläufe, Routenzustand, Behauptungen, Konsolenfehler und fehlerhafte Zustände.
- Leistung – Ladeverhalten, Reaktionsfähigkeit, teure Ressourcen und für den Benutzer sichtbare Latenz.
- UI/UX – Navigation, Klarheit, Validierung, Erwartungen an den Inhalt und visuelle Kohärenz.
- Barrierefreiheit – Tastaturzugriff, Semantik, Beschriftungen, ARIA, Kontrast und assistive Technologie-Signale.
Ablauf im Detail
1. Sammle verfügbare Produktdokumentationen
In dieser Phase suchst du nach allen verfügbaren Produktdokumentationen. Dies legt die Grundlage für deine Überprüfung. Finde also alles, was mit den Qualitätssäulen zusammenhängen könnte.
Häufige Orte, an denen gesucht wird:
PRODUCT.mdPRD.mdREADME.mddocs/
2. Stelle dem Benutzer Fragen
Die Produktdokumentation kann unvollständig oder nicht mit dem aktuellen Stand der Anwendung synchronisiert sein. Stelle dem Benutzer Fragen, die dir helfen, das Projekt und seine Anforderungen besser zu verstehen. Nutze, falls verfügbar, das Tool zum Fragenstellen; andernfalls unterhalte dich mit dem Benutzer.
Beispiele für Fragen:
- Wer benötigt Zugriff auf diese Anwendung?
- Wie ist der Plan für die laufende Wartung?
- Wie wirst du diese Anwendung überwachen und ihre Leistung und Zuverlässigkeit überprüfen?
- Wo wird diese Anwendung gehostet?
3. Überprüfe den Code
Starte anhand der gesammelten Informationen Sub-Agenten, um den Code für jede Qualitätssäule zu überprüfen. Halte sie getrennt, um eine Vermischung der Kontexte zu vermeiden. Beauftrage sie damit, Probleme zu finden und eine Go/No-Go-Bewertung basierend auf ihrer jeweiligen Qualitätssäule abzugeben.
Jedes Problem:
- sollte ein konkretes und umsetzbares Problem sein
- enthält eine Auswirkungsbewertung des Problems
- Ordne jedem Problem eine dieser Auswirkungsstufen zu: Showstopper, Kritisch, Mittel oder Nice-to-have
- enthält eine klare Beschreibung des Problems sowie den relevanten Dateinamen und die Zeilennummern (falls vorhanden)
- gibt eine Empfehlung für eine Lösung
4. Erstelle einen Bericht
Fasse abschließend alle Ergebnisse der Sub-Agenten zusammen und erstelle einen detaillierten HTML-basierten Bericht. Gib eine zusammenfassende Übersicht im Chat. Öffne den HTML-Bericht im Browser, damit der Benutzer ihn einsehen kann.
Hauptmerkmale des Berichts:
- Eine Go/No-Go-Empfehlung
- Anforderungen: Zusammenfassung des Produkts und seiner Kernanforderungen
- Probleme: Eine Liste der gefundenen Probleme, geordnet nach Auswirkungsstufe (von schwerwiegend bis geringfügig)
- Sonstige Informationen: Alle anderen wichtigen Erkenntnisse, die ein Prüfer benötigt
Beispielbericht:
Empfehlung: No-Go
Der Fourgrounds Coffee Ranker ist eine öffentlich zugängliche Anwendung, mit der Kunden des Fourgrounds Coffee Shops ihre Lieblingskaffeegetränke bewerten können.
Kernanforderungen:
- Dem Benutzer soll eine Liste der aktuell bei Fourgrounds erhältlichen Getränke angezeigt werden
- Der Benutzer soll die Getränke per Drag & Drop in seine bevorzugte Reihenfolge bringen können
- Der Benutzer soll seine Bewertung einreichen können und mit einem Gratis-Backartikel seiner Wahl belohnt werden
- Der Benutzer soll seine Bewertung nur einmal einreichen können
Probleme:
Der Benutzer kann donnerstags mehrmals einreichen
Auswirkung: KRITISCH – Der Benutzer kann mehrere kostenlose Belohnungen ansammeln.
Aufgrund eines Fehlers beim Parsen des Datums in date.js Zeile: 42 kann eine nicht behandelte Ausnahme dazu führen, dass die Prüfung auf eine vorherige Einreichung in check-reward.js Zeile: 16 übersprungen wird.
Empfehlung: Verwende den integrierten Datums-Parser und umschließe das Datum-Parsing mit einem try/catch, um zu verhindern, dass Ausnahmen andere Bereiche der Anwendung beeinträchtigen.
Sonstige Informationen:
- Die Datei
coffee-products.jsonwird täglich generiert. Wenn sich die Produkte im Laufe des Tages ändern, könnte sie veraltet sein. Externe Verbraucher der Bewertungen sollten darauf achten, die Existenz der Produkte zu validieren.