Document

Wann man es verwendet

Führen Sie /impeccable document aus, sobald Sie genug von einem visuellen System haben, um es zu dokumentieren: Farben, Typografie, mindestens einen Button und eine Karte. Der Befehl scannt Ihre Codebasis, extrahiert die Tokens und Komponentenmuster, die er findet, und schreibt eine DESIGN.md ins Projektverzeichnis, die dem Google Stitch DESIGN.md-Format folgt, sechs Abschnitte in fester Reihenfolge, interoperabel mit jedem anderen DESIGN.md-kompatiblen Tool.

Greifen Sie zu ihm, wenn:

• Sie gerade /impeccable teach ausgeführt haben und PRODUCT.md jetzt existiert. Document ist die passende visuelle Datei dazu.
• Ein Befehl hat Sie darauf hingewiesen. Live, craft und polish lesen alle DESIGN.md. Wenn sie fehlt, schlägt der Skill vor, zuerst document auszuführen.
• Das Design abgedriftet ist von einer älteren DESIGN.md und die Datei das Live-System nicht mehr beschreibt.
• Vor einem großen Redesign, um den aktuellen Zustand als Referenz für die nächste Richtung zu erfassen.

Für Projekte ohne Code (frischer teach-Durchlauf, nichts gebaut), gibt es einen Seed-Modus: /impeccable document --seed stellt fünf kurze strategische Fragen (Farb-Strategie, Typografie-Richtung, Bewegungs-Energie, Referenzen, Anti-Referenzen) und schreibt ein Gerüst. Führen Sie im Scan-Modus erneut aus, sobald Code existiert.

Wie es funktioniert

Der Scan-Durchlauf findet Design-Assets in Prioritätsreihenfolge: CSS Custom Properties, Tailwind-Konfiguration, CSS-in-JS-Themes, Design-Token-Dateien, Komponentenquellcode, das globale Stylesheet und schließlich berechnete Stile aus der Live-Ausgabe, wenn ein Browser verfügbar ist. Es extrahiert automatisch alles, was es kann, und stellt dann eine gruppierte Frage für die Teile, die kreative Eingabe brauchen: den Creative North Star (eine einzelne benannte Metapher für das gesamte System, wie „The Editorial Sanctuary”), beschreibende Farbnamen, die Elevation-Philosophie und den Komponenten-Charakter.

Die Ausgabe ist eine DESIGN.md mit genau sechs Abschnitten: Overview, Colors, Typography, Elevation, Components, Do’s and Don’ts. Header sind zeichen-für-zeichen fixiert, damit die Datei von anderen Tools geparst werden kann. Daneben wird DESIGN.json als maschinenlesbares Sidecar geschrieben. Dieses Sidecar ist es, was das Live-Mode-Design-Panel verwendet, um die tatsächlichen Button-, Input-, Nav- und Karten-Kacheln dieses Projekts anstelle einer generischen Annäherung zu rendern.

Jeder andere Befehl liest DESIGN.md beim Aufruf. Varianten, Polituren, Audits und neue Features erben das visuelle System, ohne dass es ihnen gesagt werden muss.

Ausprobieren

/impeccable document

In einem Projekt mit bereits definierten Tokens dauert dies etwa zwei Minuten: der Scan findet Ihre Palette und Ihren Typografie-Stack, Sie wählen einen North Star aus 2 oder 3 Optionen, bestätigen beschreibende Farbnamen („Deep Muted Teal-Navy”, nicht „blau-800”), und die Datei landet im Projektverzeichnis.

In einem frischen Projekt:

/impeccable document --seed

Fünf Fragen, etwa fünf Minuten. Die Datei ist ein Gerüst, markiert mit einem <!-- SEED -->-Kommentar, damit sie ehrlich darüber ist, was sie ist. Führen Sie ohne das Flag erneut aus, sobald Sie Tokens implementiert haben.

Fallstricke

• Zu früh ausführen. In einem Projekt ohne implementierte Tokens ist der Seed-Modus richtig. Fabrizieren Sie keine vollständige Spec, die der Code nicht untermauern kann. Eine gefälschte DESIGN.md ist schlimmer als keine DESIGN.md.
• DESIGN.md als Dokumentation nur für Menschen behandeln. Sie ist primär für die KI. Jeder andere Befehl liest sie. Die Bestimmtheit des Formats („niemals”, „immer”, benannte Regeln) ist beabsichtigt.
• Einen Layout-/Motion-/Responsive-Abschnitt auf oberster Ebene hinzufügen. Die Spec hat sechs Abschnitte, in fester Reihenfolge, mit festen Namen. Falten Sie Layout- oder Motion-Inhalte in Overview (philosophie-Level-Regeln) oder Components (pro-Komponente-Verhalten).
• Eine bestehende DESIGN.md stillschweigend überschreiben. Document bestätigt immer zuerst. Wenn Sie neu beginnen möchten, benennen Sie die bestehende Datei um oder weisen Sie den Skill explizit an, zu überschreiben.