Was macht do-design?
Pfade sind relativ zum Ordner dieses Skills; P ist das Projektstammverzeichnis. Skripte sind
stdlib Python 3.8+. Führen Sie das Skript aus, bevor Sie über etwas, das es misst, nachdenken,
zitieren Sie seine Ausgabe und leiten Sie nie ab oder schätzen Sie, was es berichtet.
Modell
- Die
DESIGN.mddes Projekts (das Papier) ist bindend und überschreibt diesen Skill. Bei Konflikten gewinnt das Papier; sagen Sie das. - Jede Regel trägt ihren Grund. Eine Regel ohne Grund wird beim ersten Mal gelöscht, wenn sie unbequem ist.
- Beweise vor Standardeinstellungen. Ein dünnes Briefing ("mach es neu" + ein Logo) ist ein Grund zu recherchieren, nicht auf das übliche Aussehen zurückzugreifen oder Tatsachen zu erfinden. Keine Quelle, keine Behauptung: markieren Sie die Lücke oder fragen Sie nach.
- Lade träge. Nur die Dateien, die die Befehlstabelle nennt. Zusätzliche Ebenen "der Vollständigkeit halber" sind ein Methodenfehler.
- Konvention ist der Standard, nicht das Scheitern. Der Modus entscheidet, wie weit abgewichen wird.
Modi: Geben Sie zu Beginn jedes Befehls eine Zeile an
| Modus | Der Besucher ist | Druck |
|---|---|---|
| Überzeugen | Entscheidet und handelt | stark: eine Vorlage ist ein Fehler |
| Bedienen | Erledigt eine Aufgabe | Zurückhaltung: Konvention ist ein Merkmal |
| Lesen | Versteht etwas | Mittel: Lesekomfort gewinnt |
| Erleben | Ist im Werk selbst | stark: das Artefakt führt |
Wählen Sie nach der Oberfläche, nicht nach dem Produkt: Die Landingpage eines Entwicklertools ist Überzeugen, sein Einstellungsbildschirm ist Bedienen.
Befehle: Laden Sie eine Befehlsklasse, plus das, was ihre Zeile nennt
| Befehl | Verwendung wenn | Zusätzlich laden | Risiko |
|---|---|---|---|
do-design-review | "Passt das zum Papier?" Günstigste, am häufigsten ausführen | die DESIGN.md des Projekts | - |
do-audit | "Wie gut ist das?" Bewertung + rangierte Ergebnisse | references/critique-rubric.md, references/slop-catalog.md, Ebenen 00-05, die der Umfang berührt | - |
do-design-new | "Baue X": konventionell, kompetent, auf Papier | layers/00, die 1-3 Ebenen, die die Aufgabe berührt; layers/06, wenn das Briefing dünn oder kundenorientiert ist | niedrig |
do-design-renew | "Mach diesen Look neu": neue Welt, gleiche Produktwahrheit | layers/00, layers/06 | mittel |
do-crazy | "Etwas, das niemand in dieser Branche tun würde" | layers/00, layers/06 | hoch, gewollt |
Ebenen: 00-craft-floor (jeder Modus) · 01-color · 02-typography · 03-space-layout ·
04-motion-states · 05-voice · 06-research. Schreiben eines Papiers: templates/DESIGN.md,
examples/01-two-papers.md, references/interview.md.
Skripte (alle akzeptieren --json)
| Ausführen | Gibt |
|---|---|
scripts/check-design.py --root P | Abweichung vom Token-Block des Papiers. Exit 0 sauber, 1 Abweichung, 2 kein Papier/Token. --init erstellt Token aus dem Code |
scripts/audit.py scan P | Quell-Hinweise (IDs wie im Slop-Katalog), a11y- und Browser-Oberflächenlücken, Wertinventar |
scripts/audit.py copy P | Prosa- und Mikrokopier-Hinweise, Satzrhythmus, nicht gefüllte Lückenmarkierungen |
scripts/audit.py contrast FG BG / --paper P/DESIGN.md | WCAG-Verhältnisse |
scripts/audit.py score H L S C T U D | Gewichtete Bewertung, Band, Arbeitsliste |
scripts/render-audit.py URL-oder-Datei [--shots VERZ] [--inject-css DATEI] | Die gemalte Seite bei 1280/768/390: Überlappung, seitliches Scrollen, Beschneidung, gemalter Kontrast, Berührungsziele, Fokussichtbarkeit. --inject-css misst einen CSS-Fix gegen die bereitgestellte Seite vor dem Bereitstellen. Benötigt Chrome/Chromium |
scripts/research.py suggest|profile|logo|arena | Echte Suchphrasen, Fakten zu Mitbewerberseiten, Logofarben, Referenzkanäle |
bash scripts/install-guardrails.sh P | DESIGN.md aus der Vorlage, den AGENTS.md/CLAUDE.md-Block, den Checker |
Screenshots kosten weit mehr Kontext als Skriptausgaben: machen Sie sie nur für das, was Augen braucht (Hierarchie, Unterscheidung, Komposition), nur Viewport, zuerst 390. Skripte können auch falsch sein: Bevor Sie einen P0 melden, der unglaublich erscheint, bestätigen Sie ihn einmal (ein gezielter Screenshot oder die Geometrie des Elements) und reparieren Sie das Skript, wenn es ein falscher Positiver war.
Gemeinsame Definitionen
Austauschtest. Ersetzen Sie den Produktnamen durch den eines Mitbewerbers. Wenn nichts kaputt geht, sagt die Seite nichts über dieses Produkt aus: nicht gewählt, nicht hässlich. Beheben Sie es im Text, im Visuellen und einem signifikanten Detail, niemals durch Hinzufügen von Dekoration.
Richtung, fünf Zeilen. Geschrieben vor dem Bauen, gezeigt, dann auf ein Ja warten (wenn gesagt wird "mach es einfach", geben Sie die Annahme in einer Zeile an und los):
Produkt: was es tut, für wen, ein einfacher Satz
Charakter: 2-3 konkrete Wörter (niemals sauber, modern, schlank, minimalistisch, hochwertig)
Welt: der Ort oder das Material, zu dem es gehört; setzt neutralen Farbton, Akzent, Bildsprache
Momente: 1-2 Orte, an denen der Bildschirm reichhaltig wird
Signatur: nur ein Detail, das nur dieses Produkt hat, konsequent verwendet
Lückenmarker. [Anzahl benötigt], [Quelle benötigt], [Foto benötigt] wo eine Tatsache oder
Ressource fehlt. audit.py copy listet die noch offenen auf; keine darf ausgeliefert werden.
Bewertung: Jeder bewertende Befehl endet damit
| # | Feld | Frage | W |
|---|---|---|---|
| 1 | Hierarchie | Kann das Wichtigste in 2 Sekunden genannt werden? | 3 |
| 2 | Lesbarkeit | Kontrast, Größe, Maß, echter Text bei jeder Breite | 3 |
| 3 | System | Eine Palette, eine Skala, eine Radiuslogik, eine Bewegungssprache | 2 |
| 4 | Handwerk | Ausrichtung, Abstandsrhythmus, Zustände, Browseroberflächen | 2 |
| 5 | Inhaltswahrheit | Echte Daten, spezifischer Text, keine erfundenen Behauptungen | 3 |
| 6 | Benutzbarkeit | Aufgabe erledigt; Affordanzen offensichtlich; Fehler behebbar | 3 |
| 7 | Unterscheidung | Besteht es den Austauschtest? | 2 |
Bewerten Sie jedes 0-4 (4 = wirklich hervorragend, nicht "in Ordnung") und berechnen Sie mit audit.py score.
Bänder: 85+ Stark, ausliefern und nur P0 beheben · 70-84 Solide, ausliefern nach den genannten P1s ·
50-69 Schwach, einen echten Durchlauf zuerst · <50 Durchgefallen, die Richtung ist falsch: neu bauen (do-design-renew).
Bewerten Sie das Rendering, nicht die Quelle. Ein Feld, das Sie nicht prüfen konnten, ist u: es erzielt 0 und liest
unverified, niemals eine Schätzung. Unterscheidung erhält 4 nur, wenn Sie benennen können, was es zu diesem Produkt macht.
Die drei schlechtesten Felder sind die Arbeitsliste, je eine Aktion.
Schweregrad: P0 blockiert die Auslieferung (kaputt, unlesbar, hartes Verbot), alle melden · P1 beschädigt Vertrauen, Top 5 · P2 Handwerk, Top 5 · P3 Politur, nur auflisten.
Findungsformat: [Pn] Ort - was falsch ist - Behebung; Skript-Ergebnisse behalten ihre ID.
Kein Papier
Sagen Sie "Keine DESIGN.md: die Guardrail hat nichts durchzusetzen." Bieten Sie an, es zu schreiben (Vorlage +
Interview) oder eine Nachrüstung aus dem Code (check-design.py --init + Interview §Nachrüstung): v1.0 ist,
was ausgeliefert wird, alte Werte gehen in legacy: (gezählt, nicht fehlgeschlagen), Lücken in die Delta-Liste des Papiers.
Archive und Demos bleiben von jedem Scan ausgeschlossen über skip: im Token-Block (oder --skip a,b),
nach Ordner oder Datei. Grepen Sie nach Importen, bevor Sie etwas überspringen: Archivordner enthalten oft Live-Teile.
Erfinden Sie nie ein Papier, damit der Checker besteht.
Nicht verhandelbar
- Brechen Sie niemals funktionierenden Code. Props, State, Routing, Handler und a11y überleben; der Text behält seine Bedeutung.
- Das Briefing gewinnt. Eine genannte Marke, Schriftart oder Farbe übertrumpft den Geschmack, selbst auf einer Ablehnungsliste. Schreiben Sie es in das Papier (
allow:im Token-Block schaltet eine Checker-Regel oder Audit-ID absichtlich aus). - Erfinden Sie niemals Tatsachen, Ressourcen oder Quellen. Entfernen Sie eine vage Behauptung; ersetzen Sie sie nie durch eine erfundene Spezifikation. Verwenden Sie einen Lückenmarker.
- Behalten Sie die Stimme des Autors. Entfernen Sie Maschinen-Gewohnheiten, behalten Sie die Eigenheiten der Person.
- Dichte, nicht Präsenz. Handeln Sie bei Clustern (3+ unterschiedliche P0/P1-Hinweise), niemals bei einem Farbverlauf oder einem Gedankenstrich. Ein sauberes Ergebnis ist gültig; erfinden Sie niemals Ergebnisse.
- Beheben, niemals beschuldigen. Sagen Sie nie "das sieht KI-generiert aus"; nennen Sie, was nicht gewählt ist und was stattdessen zu tun ist.
- Nur lesen, wenn nicht anders verlangt für Reviews und Audits.