Communitygithub.com

umby-discover

Führt eine chirurgische, hochwirksame Produkt- und Design-Discovery durch, bevor eine Website oder Web-App gebaut oder neugestaltet wird. Beseitigt generischen KI-Müll, indem es fehlende Markenausrichtung, Käuferskepsis, Conversion-Prioritäten, ästhetische Spannungen und echte Beweise in 4-5 präzisen Fragen klärt und dann einen konkreten Design- und Funktionsvertrag abschließt.

Was ist umby-discover?

Umby Discover ist ein KI-Agenten-Skill, der für den Start von Greenfield-Webentwicklungsprojekten konzipiert ist, bei denen die Anforderungen vage sind oder das Risiko von generischen, KI-generierten Ergebnissen („Slop“) hoch ist. Anstatt den Benutzer mit langen Formularen zu belasten oder willkürliche Designentscheidungen zu treffen, analysiert der Skill zuerst das Repository auf existierende Assets und leitet dann eine fokussierte, max. 5-Fragen-Umfrage ein. Der Fragebogen basiert auf fünf Säulen (Job, Ästhetik, Beweise, Umfang, Altlasten) und bietet dem Benutzer konkrete, gegensätzliche Optionen, die eine klare Richtung vorgeben, ohne ihn zu überfordern. Das Ergebnis ist ein präziser „Creative & Functional Contract“ – eine kompakte schriftliche Spezifikation, die Design- und Produktentscheidungen für die nachfolgenden Schritte im Entwicklungs-Workflow (z. B. Architektur und Handwerk) festhält. Der Skill vermeidet offene Fragen und setzt stattdessen auf scharfe Kontraste wie „Präzision Dark Monolith vs. Editorial High-Key Light“. Er ist ideal für Entwickler, die mit Tools wie Claude Code, Cursor oder ähnlichen KI-Assistenten arbeiten und klare, umsetzbare Anforderungen benötigen, um Fehlentscheidungen und unnötige Iterationen zu vermeiden.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Umbylicus/umby-beast-code/tree/HEAD/skills/umby-discover

In Ihrer bevorzugten KI fragen

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

Dokumentation

Umby Discover: Chirurgisches Briefing & Creative Direction

Standing Rules gelten. Bevor du etwas änderst, lies ../umby-beast-code/references/standing-rules.md: Genehmigungsstufen, kein Deployment oder Merge ohne explizites Go, Feature-Branch mit Preview, geschützter Code, jede URL erhalten oder weiterleiten, nur echte Beweise und das Arbeitsprotokoll.

Generische Prompts zwingen Agenten zum Raten, und die Schätzung eines LLM ist der statistische Durchschnitt des Internets. Deine Aufgabe hier ist es, eine spezifische, meinungsstarke, kategorie-führende Produkt- und visuelle Identität festzulegen, bevor eine einzige Zeile Komponentencode geschrieben wird – ohne den Benutzer einer ermüdenden 20-Fragen-Umfrage auszusetzen.


Schritt 1: Beobachtbare Fakten von fehlender Absicht trennen

  1. Überprüfe zuerst die Arbeitsbereichsdateien (package.json, vorhandene CSS-Tokens, Marken-Assets, README.md, vorhandene Routen). Stelle niemals eine Frage, die das Repository bereits beantwortet.
  2. Überprüfe die Anfrage des Benutzers anhand der Fünf Säulen eines Nicht-Schrott-Briefings:
    • Säule 1 – Aufgabe & Hauptaktion: Wer landet hier, welche Skepsis bringt er mit, und was ist die einzige Aktion, die wir von ihm verlangen?
    • Säule 2 – Ästhetischer Archetyp & Spannung: Wo ordnet sich das visuell ein? (Lies references/aesthetic-archetypes.md für die 12 Nicht-KI-Archetypen.)
    • Säule 3 – Beweis & Inhaltsrealität: Haben wir echte Produktdaten, Metriken, Fotografie oder interaktive Live-Mechaniken – oder sollten wir eine ehrliche interaktive Simulation bauen, anstatt mit einem falschen "10.000+ Kunden"-Füller zu arbeiten?
    • Säule 4 – Oberflächenumfang & Stack: Welche Seiten/Flows gehören zu Pass 1, und welche Stack-Beschränkungen gelten (Astro Static Speed vs. Next.js Interactive App vs. Shopify Headless)?
    • Säule 5 – Altlasten (nur bei Updates): Welche URLs, Logos, Markenfarben oder Checkout-/Auth-Verträge sind heilig?

Schritt 2: Das 4–5 Fragen Aufnahmetor ausführen

Wenn 2 oder mehr der obigen Säulen wirklich fehlen (und der Benutzer keine sofortige autonome Ausführung angefordert hat), halte vor dem Schreiben von UI-Code inne und stelle 3 bis 5 chirurgische Fragen, ausgewählt aus references/question-bank.md.

Regeln für großartige Discovery-Fragen

  • Verwende die Host-Frage-UI, wenn verfügbar: Wenn deine Umgebung ein strukturiertes Multiple-Choice-Fragewerkzeug bereitstellt (z. B. ask_question), verwende es mit 3–4 konkreten, kontrastierenden Optionen pro Frage und setze deine empfohlene Wahl mit dem Präfix (Empfohlen) an den Anfang. Ansonsten präsentiere eine saubere, nummerierte Klartext-Liste.
  • Biete konkrete Kontraste, keine offenen Hausaufgaben: Frage niemals „Welche Farben und Schriftarten magst du?“ Biete stattdessen scharfe Richtungspaare an: z. B. „(Empfohlen) Precision Dark Monolith (Linear / Raycast-Kaliber: obsidian #0b0c0e, knackige Haarlinien-Grenzen, einzelner elektrischer Akzent, interaktive Produktbühne)“ vs. „Editorial High-Key Light (Stripe Press / Mercury-Kaliber: warmer Alabaster #faf9f6, editorial Serif Display + sauberer Grotesk Body, großzügiger Tageslicht-Abstand)“.
  • Maximal 5 Fragen: Eine Runde scharfer Fragen ist belebend; drei Runden Nörgelei fühlen sich kaputt an.

Schritt 3: Den Creative & Functional Contract festlegen

Sobald der Benutzer antwortet (oder sofort mit deinem besten Archetyp-Match, wenn du unter einer expliziten autonomen Genehmigung arbeitest), schreibe den kompakten Design- & Produktvertrag auf (entweder inline in 12–15 Zeilen oder gespeichert in .umby/DESIGN_BRIEF.md bei Multi-Route-Projekten):

  1. Zielgruppe & Skepsis: Ein Satz, der benennt, wer zu Besuch kommt und welchen genauen Zweifel die Seite innerhalb von 5 Sekunden überwinden muss.
  2. Primäre Viewport-Aktion: Genau eine primäre CTA-Verbphrase (z. B. "Interaktive Sandbox starten", "250g Beutel · 24€ hinzufügen").
  3. Gewählter Archetyp & 3 Handwerks-Benchmarks: Benannter Archetyp aus references/aesthetic-archetypes.md + 3 reale Produkte, deren Qualitätsniveau (niemals kopiertes IP/Assets) den Bau verankert.
  4. Schriftarten-Paar & -Skalierung: Display-Familie + Text-Familie + Monospace-Familie, mit expliziten Schriftgewichten und Tracking-Regeln.
  5. OKLCH-Paletten-Anker: Basis-Flächenhelligkeit/Farbton, Primärtinte, Deckkraft der Haarlinie und die einzelne überzeugende Akzentfarbe.
  6. Abschnitts-Rhythmus-Sequenz: Geordnete Liste von 5–8 Seiten-Schwerpunkten, bei denen keine zwei benachbarten Abschnitte dieselbe Rastergeometrie teilen.
  7. Anti-Ziele (Explizite Ausschlüsse): 3 spezifische Klischees, die für dieses Projekt verboten sind (z. B. „Kein Lila-Blau-SaaS-Glow, keine 3-spaltige Lucide-Icon-Feature-Reihe, keine unverifizierten Kundenporträts“).

Übergebe diesen festgelegten Vertrag direkt an ../umby-architect/SKILL.md und ../umby-craft/SKILL.md.

Verwandte Skills