/mochi-redesign
Ein geführter Redesign-Workflow. Er wendet kein festes Aussehen an. Er wendet einen festen Prozess an: die Person verstehen, ein Konzept finden, ein kleines Designsystem aufbauen, alles Wichtige auf dem ersten Bildschirm als Karten darstellen, Details in reichhaltige Popups und eigene Seiten auslagern, ehrliche Texte schreiben und jede Änderung auf echten Bildschirmgrößen prüfen, bevor sie gezeigt wird.
Der Workflow wurde aus einem echten Portfolio destilliert, das von einer schlichten einspaltigen Vorlage über viele Feedback-Runden des Besitzers zu einer Bento-ähnlichen Seite wurde. Die Lehren aus diesen Runden (was funktioniert hat, was abgelehnt wurde, was kaputt ging) sind unten und in references/ codiert.
Das Ergebnis darf niemals so aussehen wie die Seite, von der dieses Skill abstammt. Gleiche Disziplin, andere Identität: neues Konzept, neue Schriften, neue Farben, neues charakteristisches Detail. Wenn Sie sich dabei erwischen, zu einem Ringelblumen-Pinselstrich, einem Maskottchen oder einem Bento-Raster zu greifen, nur „weil das Skill das so macht“, halten Sie an und gehen Sie zurück zu Phase 1.
So führen Sie es aus
Argumente sind optionaler Freitext, z. B. /mochi-redesign client/ oder /mochi-redesign nur die Startseite, den Blog unverändert lassen.
Arbeiten Sie die Phasen in der angegebenen Reihenfolge durch. Jede Phase endet mit einem Tor: Zeigen Sie dem Besitzer das Ergebnis (Screenshots, keine Beschreibungen) und warten Sie auf seine Reaktion, bevor Sie fortfahren. Redesigns scheitern, wenn mehrere ungeprüfte Entscheidungen aufeinander türmen.
| Phase | Zuerst lesen | Tor |
|---|---|---|
| 0. Aufnahme und Audit | references/01-intake-audit.md | Besitzer bestätigt Ziele, Zielgruppe, Umfang, was unverändert bleiben muss |
| 1. Konzept und System | references/02-concept-system.md | Besitzer wählt eine Richtung aus; Tokens werden notiert |
| 2. Wahrheit im Inhalt | references/03-content.md | Besitzer stimmt Behauptungen zu (keine Übertreibungen) |
| 3. Erster Bildschirm | references/04-layout.md | Passt auf einen Laptop-Bildschirm bei jeder Zielgröße |
| 4. Detailebene | references/05-interaction.md | Popups scrollen innen, blockieren die Seite, kein Layout-Shift |
| 5. Sekundärseiten | references/06-content-pages.md | Listen- und Leseseiten passen zum System |
| 6. Medien (optional) | references/07-media.md | Echte Walkthroughs, komprimiert, spielen nur im Viewport ab |
| 7. Polieren und QA | references/08-qa.md | Clip-Check bestanden, beide Themes, mobil, Lint, Build |
| 8. Übergabe | references/09-feedback-and-handoff.md | Sauberer Diff, Design-Dokument aktualisiert, Besitzer entscheidet über Commit |
references/10-anti-patterns.md ist die Liste der Fehler, die beim ersten Mal gemacht wurden. Lesen Sie sie einmal vor Phase 1 und noch einmal vor Phase 7.
Nicht verhandelbare Regeln
- Hinsehen, bevor Sie ändern. Lesen Sie den vorhandenen Code, führen Sie die Seite aus, machen Sie Screenshots in den Zielgrößen. Niemals nur vom Code aus redesignen.
- Eine Identität pro Seite. Das Konzept kommt vom Subjekt (was die Person oder das Produkt tatsächlich ist), nicht von einem Trend oder vom Ursprung dieses Skills.
- Alles Wichtige auf dem ersten Bildschirm. Besucher sollten sehen, wer, was und Belege (beste Arbeiten) ohne zu scrollen. Details sind einen Klick entfernt, nicht fünf Bildschirme weiter unten.
- Ehrliche Texte. Keine Behauptung, hinter der der Besitzer nicht in einem Vorstellungsgespräch stehen kann. Bevorzugen Sie „geübt“, „habe getan“, „wo es passt“ statt „jede/r/s“, „immer“, „alle“. Zeigen Sie Belege (Zahlen, veröffentlichte Dinge) statt Adjektive.
- Auf Größen prüfen, nicht im Kopf. Jede visuelle Änderung wird vom Clip-Check (
scripts/clip-check.mjs) und mindestens einem Screenshot begleitet. Melden Sie niemals „erledigt“ für eine Änderung, die Sie nicht angesehen haben. - Kleine, umkehrbare Schritte. Ändern Sie eine Sache, zeigen Sie sie, hören Sie zu. Lehnt der Besitzer etwas zweimal ab, hören Sie auf zu raten: bieten Sie 2–3 konkrete Optionen mit Vorschauen an und lassen Sie ihn wählen. Bittet er um Rückgängigmachung, stellen Sie exakt die vorherige Version wieder her, keinen „ungefähr passenden“ Neubau.
- Zerstören Sie nicht, was live ist. Behalten Sie alte Routen bei, berühren Sie keine irrelevanten Seiten, formatieren Sie keine Dateien neu, die Sie nicht ändern mussten (Formatierungsrauschen versteckt den echten Diff), committen oder pushen Sie nicht ungefragt.
- Barrierefreiheits-Minimum. Per Tastatur erreichbar, sichtbarer Fokus, echte Buttons und Links,
prefers-reduced-motionrespektiert, Kontrast in beiden Themes geprüft, nichts Wichtiges wird nur durch Hover vermittelt.
Wie „fertig“ aussieht
- Ein erster Bildschirm, der auf einen Laptop (1280×720 bis 1920×1080) passt, mit keinem abgeschnittenen Inhalt, keinem horizontalen Scrollen und einem klaren Blickfang.
- Ein kleines, schriftliches Designsystem (Tokens, Typographie, Radien, Bewegungsregeln), das jede neue Komponente verwendet.
- Karten, die reichhaltige Details öffnen (Dialoge oder Seiten) statt langem Scrollen.
- Texte, die der Besitzer Zeile für Zeile abgesegnet hat.
- Sekundärseiten (Listen, Leseseiten, Fallstudien), die sich wie die gleiche Seite anfühlen.
- Ein Design-Dokument im Repository (
DESIGN.mdoder ähnlich), das das System und die Entscheidungen beschreibt, damit die nächste Person (oder der nächste Agent) die Konsistenz bewahrt.
Dateien in diesem Skill
SKILL.md diese Datei: Workflow, Tore, Regeln
references/01-intake-audit.md Fragen, die zu stellen sind; wie man die aktuelle Seite auditet
references/02-concept-system.md Ein Konzept finden; Tokens, Typographie, charakteristisches Detail
references/03-content.md Wahrheitsgetreue, scanbare, hervorgehobene Texte schreiben
references/04-layout.md Bento-Layout für den ersten Bildschirm und Kartenrezepte
references/05-interaction.md Dialoge, Hover, Bewegung, kleine Freuden
references/06-content-pages.md Blog-/Listen-/Leserseiten, die die Leute weiterlesen lassen
references/07-media.md Walkthroughs und Trailer von echter Arbeit aufnehmen
references/08-qa.md Viewport-Matrix, Clip-Check, Themes, Barrierefreiheit
references/09-feedback-and-handoff.md Mit dem Besitzer iterieren; sauber abschließen
references/10-anti-patterns.md Was beim ersten Mal schiefging, und die Lösung
scripts/clip-check.mjs CDP-Skript: abgeschnittene Karten, Überlauf, Falzanpassung
scripts/shots.mjs CDP-Skript: Screenshots pro Viewport und Theme
templates/ Framework-unabhängige Snippets (React + Tailwind)