Warum Windsurf ein Designsystem benötigt
Cascade erstellt Features end-to-end, entscheidet aber wie jeder Coding-Agent in jedem Schritt das Styling neu: hier eine leicht andere Akzentfarbe, dort ein neuer Abstand, auf dem nächsten Screen eine andere Schriftart. Ein Designsystem eliminiert dieses Rätselraten: ein Satz semantischer Design-Tokens und eine schriftliche DESIGN.md, der Cascade folgt, sodass die gesamte App wie ein einziges Produkt wirkt und nicht wie das Ergebnis von zehn verschiedenen Prompts.
Windsurf erfordert (vorerst) eine manuelle Installation
Der Befehl identityforge install --client … unterstützt Windsurf noch nicht. Da Windsurf dasselbe Standard-MCP-Format akzeptiert, fügen Sie den Server wie unten gezeigt manuell hinzu. Die CLI- und shadcn-Pfade funktionieren auch ohne MCP.
Das zu installierende Kit
Terrain Vivant
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Space Mono
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Installation (manuelle MCP-Konfiguration)
- 1
Windsurf MCP-Konfiguration öffnen
Öffnen Sie das Einstellungsmenü (da Windsurf zu Cognition gehört, heißt dieses nun Devin Settings), gehen Sie zu Cascade > MCP Servers und wählen Sie die Bearbeitung der Raw-Konfiguration (
~/.codeium/windsurf/mcp_config.json). - 2
Identity Forge Server hinzufügen
Fügen Sie den unten stehenden Eintrag in das
mcpServers-Objekt ein (integrieren Sie ihn neben etwaige bestehende Server).{ "mcpServers": { "identityforge": { "command": "npx", "args": ["-y", "identityforge@latest", "mcp"] } } } - 3
MCP-Server aktualisieren
Aktualisieren Sie im MCP-Panel von Cascade die Liste, damit die Identity Forge Tools geladen werden.
- 4
Cascade zur Gestaltung der App auffordern
Geben Sie Produkt, Zielgruppe und Stimmung an; Cascade nutzt dann
search_themes,get_design_mdundapply_theme.Use Identity Forge to pick a clean, editorial theme for a recipe site, apply it, and follow the DESIGN.md.
Windsurf gehört nun zu Devin
Cognition hat Windsurf übernommen, und die Dokumentation wurde nach docs.devin.ai verschoben, wo dieser MCP-Workflow für den Cascade-Agenten (dort als Legacy-Agent gekennzeichnet) dokumentiert ist. Der Konfigurationspfad und das Format von mcpServers haben sich nicht geändert, sodass das obige Setup weiterhin funktioniert; es ist jedoch zu erwarten, dass sich die Bezeichnungen in der Benutzeroberfläche zunehmend in Richtung Devin-Branding ändern.
Oder MCP komplett überspringen
Da Windsurf Terminal-Befehle ausführen kann, funktionieren die client-agnostischen Pfade ohne Konfigurationsänderung: Cascade (oder Sie) führt einfach einen Befehl aus:
- 1
CLI apply
Schreibt die DESIGN.md und eine Token-Datei in das aktuelle Verzeichnis. Fordern Sie Cascade auf, die DESIGN.md zu lesen und die Tokens zu implementieren.
identityforge apply ambient-sage - 2
shadcn registry
Installiert die CSS-Variablen des Kits direkt für shadcn/ui-Projekte.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Die Cursor-Anleitung beschreibt denselben MCP-Workflow mit einem unterstützten Installationsbefehl, und der Pillar-Guide verlinkt alle Tools. Um den Inhalt zu verstehen, lesen Sie, was eine DESIGN.md ist.
FAQ
Wie gebe ich Windsurf ein Designsystem?
Fügen Sie den Identity Forge MCP-Server zu ~/.codeium/windsurf/mcp_config.json unter Verwendung des Standard-mcpServers-Eintrags hinzu (Befehl npx, Argumente -y identityforge@latest mcp), aktualisieren Sie die MCP-Server von Cascade und fordern Sie Cascade dann auf, ein Kit auszuwählen und anzuwenden. Alternativ können Sie MCP überspringen und identityforge apply <slug> ausführen.
Gibt es einen install --client windsurf Befehl?
Noch nicht. Der Install-Befehl der CLI unterstützt derzeit claude-code, cursor, codex, gemini, vscode, opencode und pi. Da Windsurf dasselbe MCP-Format verwendet, muss die Server-Konfiguration manuell eingefügt werden.
Kann ich das Bearbeiten von Konfigurationsdateien vermeiden?
Ja. Führen Sie identityforge apply <slug> aus, um die DESIGN.md und die Tokens in das aktuelle Verzeichnis zu schreiben, oder npx shadcn add https://identityforge.io/r/<slug>.json für shadcn/ui-Projekte. Beides erfordert keine MCP-Konfiguration.
Quellen
- Cascade MCP - Devin Docs: Die Windsurf-Dokumentation befindet sich nun unter docs.devin.ai; MCP-Server für den Cascade-Agent werden in ~/.codeium/windsurf/mcp_config.json über Devin Settings > Cascade > MCP Servers konfiguriert.
Quellen
- Cascade MCP - Devin Docs: Die Windsurf-Dokumentation befindet sich nun unter docs.devin.ai; MCP-Server für den Cascade-Agent werden in ~/.codeium/windsurf/mcp_config.json über Devin Settings > Cascade > MCP Servers konfiguriert.